Overview
Get an instance tag.
Request
Request parameters
| Parameter name | Required | Type | Restrictions | Description |
|---|---|---|---|---|
| instanceNoList.N | No | List<String> | It can't be duplicated. | - List of server instance numbers to query instance tags [servers only] e.g., instanceNoList.1=1088217 |
| tagKeyList.N | No | List<String> | It can't be duplicated. | - Tag key of the instance to query TagKey of the instance can be obtained through the getInstanceTagList action. e.g., tagKeyList.1=tag1 |
| tagValueList.N | No | List<String> | It can't be duplicated. | - Tag value of the instance to query TagValue of the instance can be obtained through the getInstanceTagList action. tagValueList.1=dolphins |
| pageNo | No | Integer | - Page number of the paged results The results can be paged using pageNo. |
|
| pageSize | No | Integer | - Size of each page to be displayed when paging The results can be paged using pageSize. |
|
| responseFormatType | No | String | - Format type of the response result Options: xml | json Default: xml |
Response
Response body
Examples
Request example
GET {SERVER_API_URL}/getInstanceTagList
?tagKeyList.1=tag1
Response example
<getInstanceTagListResponse>
<requestId>8b3584cc-d7c6-44fb-9976-3b8a11180bf7</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<instanceTagList>
<instanceTag>
<instanceNo>1088217</instanceNo>
<instanceType>
<code>SVR</code>
<codeName>Server</codeName>
</instanceType>
<tagKey>tag1</tagKey>
<tagValue>dolphins</tagValue>
</instanceTag>
</instanceTagList>
</getInstanceTagListResponse>