getInstanceTagList

Prev Next

概要

インスタンスタグ照会

説明

インスタンスタグを照会します。

リクエストパラメータ

パラメータ名 必須 タイプ 制約事項 説明
instanceNoList No List<String> 重複不可 インスタンスタグを照会するインスタンス番号リスト(サーバ限定)
tagKeyList No List<String> 重複不可 タグキーリスト
tagValueList No List<String> 重複不可 タグ値リスト
pageNo No Integer 件数が多い場合、ページサイズに該当するページ番号
pageSize No Integer 一つのページで照会するページサイズ

レスポンスデータタイプ

  • InstanceTagList type
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>