개요
인스턴스 태그 조회
설명
인스턴스 태그를 조회합니다.
요청 파라미터
| 파라미터 명 |
필수 여부 |
타입 |
제약사항 |
설명 |
| instanceNoList |
No |
List<String> |
중복불가 |
인스턴스 태그를 조회할 인스턴스 번호 리스트(서버 한정) |
| tagKeyList |
No |
List<String> |
중복불가 |
태그 키 리스트 |
| tagValueList |
No |
List<String> |
중복불가 |
태그 값 리스트 |
| pageNo |
No |
Integer |
|
건수가 많을 경우 페이지 사이즈에 해당하는 페이지 번호 |
| pageSize |
No |
Integer |
|
한 페이지에서 조회할 페이지 사이즈 |
응답 데이터 타입
| InstanceTagList extends CommonResponse |
| private Integer totalRows; |
| private List instanceTagList = new ArrayList(); |
| InstanceTag |
| private String instanceNo; |
| private CommonCode instanceType; |
| private String tagKey; |
| private String tagValue; |
예시
호출
ncloud server getInstanceTagList --instanceNoList 713768 --tagKeyList penguin
응답
{
"getInstanceTagListResponse": {
"requestId": "6c852800-4d84-4616-bf8e-2ccdf5cd81c9",
"returnCode": "0",
"returnMessage": "success",
"totalRows": 1,
"instanceTagList": [
{
"instanceNo": "713768",
"instanceType": {
"code": "SVR",
"codeName": "Server"
},
"tagKey": "penguin",
"tagValue": "999999"
}
]
}
}
<?xml version="1.0" encoding="UTF-8" ?>
<getInstanceTagListResponse>
<requestId>6c852800-4d84-4616-bf8e-2ccdf5cd81c9</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<instanceTagList>
<instanceNo>713768</instanceNo>
<instanceType>
<code>SVR</code>
<codeName>Server</codeName>
</instanceType>
<tagKey>penguin</tagKey>
<tagValue>999999</tagValue>
</instanceTagList>
</getInstanceTagListResponse>