ListTagResources操作を呼び出して、1つ以上のApsaraDB RDSインスタンスにバインドされているタグを照会できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 ListTagResources

実行する操作です。 値をListTagResourcesに設定します。

RegionId String 必須 cn-hangzhou

リージョンの ID DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

ResourceType String 必須 INSTANCE

リソースのタイプを示します。 値をINSTANCEに設定します。

NextToken String 任意 212db86sca4384811e0b5e8707ec21345

より多くの結果を取得するために必要なトークン。 このパラメーターは、初回のクエリでは必要ありません。 クエリがすべての結果を返さない場合は、次のクエリで、前のクエリから返されたトークンを指定して、より多くの結果を取得できます。

ResourceId.N String 任意 rm-uf6wjk5 *******

インスタンスの ID です。 一度にN個のインスタンスのタグを照会できます。 Nの有効値: 1〜50。

説明 ResourceId.Nパラメーターと Tag.N.Keyパラメーターの少なくとも1つを指定する必要があります。
Tag.N.Key String 任意 testkey1

タグのキー。 一度にN個のタグキーを照会できます。 Nの有効値: 1〜20。 このパラメーターの値を空の文字列にすることはできません。

説明 ResourceId.Nパラメーターと Tag.N.Keyパラメーターの少なくとも1つを指定する必要があります。
Tag.N.Value String 任意 testvalue1

指定されたタグキーに関連付けられているタグ値。 一度にN個のタグ値を指定できます。 Nの有効値: 1〜20。 パラメーターを空の文字列にすることができます。

レスポンスパラメーター

項目 データ型 例: 説明　
NextToken String 212db86sca4384811e0b5e8707ec21345

より多くの結果を取得するために必要なトークン。 クエリがすべての結果を返さない場合は、次のクエリで、前のクエリで返されたトークンを指定して、より多くの結果を取得できます。

RequestId String 47A514A1-4B77-4E30-B4C5-2A880650B3FD

リクエストの ID です。

TagResources TagResourceの配列

返されたインスタンスとタグの情報を示します。

TagResource
TagValue String testvalue1

指定されたタグキーに関連付けられているタグ値。

ResourceType String ALIYUN::RDS::INSTANCE

リソースタイプ。 値ALIYUN::RDS::INSTANCEは、ApsaraDB RDSインスタンスを示します。

ResourceId String rm-uf6wjk5xxxxxxx

インスタンスの ID です。

TagKey String testkey1

タグのキー。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTagResourcesResponse>
<TagResources>
    <TagResource>
        <ResourceType>ALIYUN::RDS::INSTANCE</ResourceType>
        <TagValue>testvalue1</TagValue>
        <ResourceId>rm-uf6wjk5xxxxxxx</ResourceId>
        <TagKey>testkey1</TagKey>
    </TagResource>
</TagResources>
<RequestId>47A514A1-4B77-4E30-B4C5-2A880650B3FD</RequestId>
</ListTagResourcesResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TagResources" : {
    "TagResource" : [ {
      "ResourceType" : "ALIYUN::RDS::INSTANCE" 、
      "TagValue" : "testvalue1" 、
      "ResourceId" : "rm-uf6wjk5xxxxxxx" 、
      "TagKey" : "testkey1"
    } ]
  },
  "RequestId" : "47A514A1-4B77-4E30-B4C5-2A880650B3FD"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 BothEmpty.TagsAndResources 指定されたTagとResourcesIdの両方を空にすることはできません。 Tag.N.KeyパラメーターとResourceIdパラメーターの両方を空にできない場合に返されるエラーメッセージ。
400 InvalidParameter.ResourceType パラメーターResourceTypeが無効です。 ResourceTypeパラメーターの値が無効な場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。