説明
タグの情報を照会します。
注意:
インスタンス ID、タグキー、タグ値でタグを照会することができます。
指定された条件は”and”リレーションであり、指定された条件をすべて満たすタグセットのみが返されます。
タグキーを指定するがタグ値は指定しない場合、タグキーに関連付けられたすべてのタグが照会されます。
タグ値だけを指定することはできますが、タグキーは指定できません。
タグキー/タグ値のペアを指定すると、対応するタグは完全に一致します。
リクエストパラメータ
リクエストパラメータ | データ型 | 必須 | 説明 |
---|---|---|---|
Action | String | Yes | システムに必要なパラメータ。 有効な値: |
RegionId | String | Yes | Server Load Balancer インスタンスのリージョン ID。 |
LoadBalancerID | String | No | Server Load Balancer インスタンスの ID。 |
Tags | String | No | 照会するタグ。 |
PageSize | Integer | No | デフォルト値は 50、最大値は 100 です。 |
PageNumber | Integer | No | インスタンスリストのページ番号。開始値は 1 で、デフォルト値は 1 です。 |
Tags objects | |||
TagKey | String | Yes | タグのキー。 これは 64 文字までで、 |
TagValue | String | No | タグの値。 これは 128 文字までで、 |
レスポンスパラメータ
レスポンスパラメータ | データ型 | 説明 |
---|---|---|
RequestId | String | リクエストの ID。 |
TagSets | List | タグのリスト。 |
PageSize | Integer | デフォルト値は 50、最大値は 100 です。 |
PageNumber | Integer | インスタンスリストのページ番号。開始値は 1 で、デフォルト値は 1 です。 |
TotalCount | Integer | 濾過条件によって得られたインスタンスの総数。 |
TagSet objects | ||
TagKey | String | タグのキー。 |
TagValue | String | タグの値。 |
InstanceCount | Integer | タグにバインドされたインスタンスの総数。 |
例
リクエストの例
https://slb.aliyuncs.com/
&Action=DescribeTags
&RegionId=cn-east-hangzhou-01
&LoadBalancerID=139a00604ad-cn-east-hangzhou-01
&<Common parameters>
レスポンスの例
XML 形式
<?xml version="1.0" encoding="UTF-8"?>
<DescribeTagsResponse>
<RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
<TagSets>
<TagSet>
<TagKey>test</TagKey>
<TagValue>api</TagValue>
</TagSet>
</TagSets>
<PageSize>50</PageSize>
<PageNumber>1</PageNumber>
<TotalCount>1</TotalCount>
</DescribeTagsResponse>
JSON 形式
{
"RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
"TagSets": {
"TagSet": [
{
"TagKey": "test",
"TagValue": "api"
}
"PageNumber": 1,
"PageSize": 50,
"TotalCount": 1
}