この API を呼び出して、指定されたタグにバインドされている ApsaraDB for Redisインスタンスを照会したり、指定されたApsaraDB for Redisインスタンスにバインドされているタグを照会したりできます。
これらのインスタンスまたはタグは、コンソールで照会することもできます。 詳細については、「Filter ApsaraDB for Redis instances by tag」および「View tags bound to ApsaraDB for Redis instances」をご参照ください 。
デバッグ
リクエストパラメーター
パラメーター | タイプ | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
Action | String | 任意 | ListTagResources |
実行する API (ListTagResources) を設定します。 |
RegionId | String | 必須 | cn-hangzhou |
SLB インスタンスが存在するリージョンの ID を設定します。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。 |
ResourceType | String | 必須 | INSTANCE |
指定されたインスタンスのタイプを設定します。 この値は INSTANCE に設定します。 |
ResourceId.N | RepeatList | 任意 | r-hp3xxxxxxxxxxxxx |
指定されたインスタンスの ID を設定します。 複数の条件を指定できます。 注 次の形式で複数のIDを指定できます。
&ResourceId.1=r-hp1xxxxxxxxxxxxx&ResourceId.2=r-hp2xxxxxxxxxxxxx 。
|
Tag.N.Key | String | 任意 | demokey |
タグ N のキーを設定します。 注 タグキーの指定方法の詳細については、リクエストの例をご参照ください。
|
Tag.N.Value | String | 任意 | demovalue |
タグ N の値。 注 タグ値の指定方法の詳細については、リクエストの例をご参照ください。
|
NextToken | String | 任意 | 212db86sca4384811e0b5e8707ec21345 |
より多くの結果を取得するために必要なトークン。 このパラメーターは、初回のクエリでは必要ありません。 1 回のクエリですべての結果が返されない場合、続くクエリに前のクエリで返されたトークンを設定して、さらに結果を取得できます。 |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RequestId | String | 47A514A1-4B77-4E30-B4C5-2A880650B3FD |
リクエストの ID を示します。 |
NextToken | String | 212db86sca4384811e0b5e8707ec21345 |
1 回のクエリですべての結果が返されない場合、続くクエリに前のクエリで返されたトークンを設定して、さらに結果を取得できます。 |
TagResources | Array |
返されたインスタンスとタグの情報を示します。 |
|
TagKey | String | demokey |
タグのキーを示します。 |
TagValue | String | demovalue |
タグの値を示します。 |
ResourceType | String | ALIYUN::KVSTORE::INSTANCE |
リソースのタイプを示します。 値は |
ResourceId | String | r-hp3xxxxxxxxxxxxx |
ApsaraDB for Redis インスタンスの ID を示します。 |
コーディング例
リクエストの例
https://r-kvstore.aliyuncs.com/
? Action=ListTagResources
&RegionId=cn-huhehaote
&ResourceType=INSTANCE
&Tag.1.Key=demokey1
&Tag.1.Value=demovalue1
&Tag.2.Key=demokey2
&Tag.2.Value=demovalue2
&<Common request parameters>
通常のレスポンス例
XML
形式
<ListTagResourcesResponse>
<TagResources>
<TagResource>
<ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
<TagValue>demovalue1</TagValue>
<ResourceId>r-hp3xxxxxxxxxxxxx</ResourceId>
<TagKey>demokey1</TagKey>
</TagResource>
<TagResource>
<ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
<TagValue>demovalue1</TagValue>
<ResourceId>r-hp2xxxxxxxxxxxxx</ResourceId>
<TagKey>demokey1</TagKey>
</TagResource>
<TagResource>
<ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
<TagValue>demovalue2</TagValue>
<ResourceId>r-hp3xxxxxxxxxxxxx</ResourceId>
<TagKey>demokey2</TagKey>
</TagResource>
<TagResource>
<ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
<TagValue>demovalue2</TagValue>
<ResourceId>r-hp2xxxxxxxxxxxxx</ResourceId>
<TagKey>demokey2</TagKey>
</TagResource>
</TagResources>
<RequestId>47A514A1-4B77-4E30-B4C5-2A880650B3FD</RequestId>
</ListTagResourcesResponse>
JSON
形式
{
"TagResources": {
"TagResource": [
{
"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
"TagValue": "demovalue1",
"ResourceId": "r-hp3xxxxxxxxxxxxx",
"TagKey": "demokey1"
},
{
"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
"TagValue": "demovalue1",
"ResourceId": "r-hp2xxxxxxxxxxxxx",
"TagKey": "demokey1"
},
{
"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
"TagValue": "demovalue2",
"ResourceId": "r-hp3xxxxxxxxxxxxx",
"TagKey": "demokey2"
},
{
"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
"TagValue": "demovalue2",
"ResourceId": "r-hp2xxxxxxxxxxxxx",
"TagKey": "demokey2"
}
]
},
"RequestId": "47A514A1-4B77-4E30-B4C5-2A880650B3FD"
}
エラーコード
エラーコードについては、「API エラーセンター」をご参照ください。