查询标签
描述
容许根据资源类型、资源 ID、Tag-Key、Tag-Value 等条件查询所有符合条件的 Tags。
指定的条件为 and 关系，只有指定的所有条件都满足的TagSetItem才会被返回。
如果指定了 Tag-Key 但没有指定 Tag-Value，就查询所有该 Tag-Key 关联的 Tag。
如果指定了 Tag-Key/Tag-Value 对，就查询精确匹配该 Tag-Key/Tag-Value 对的 Tag。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 操作接口名，DescribeTags |
| RegionId | String | 是 | 所属区域 |
| ResourceId | String | 否 | ResourceId |
| ResourceType | String | 否 | 资源类型：
所有值均为小写。 |
| Tag.n.Key | String | 否 | 标签 key，n 从 1 开始，最大为 5 |
| Tag.n.Value | String | 否 | 标签 value，n 从 1 开始，最大为 5 |
| PageSize | Integer | 否 | 默认 50，最大 100 |
| PageNumber | Integer | 否 | 实例状态列表的页码，起始值为 1，默认值为 1 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| RequestId | String | 请求ID |
| TagSet | TagSetItem | 实际返回内容的结构体列表 |
| PageSize | Integer | 默认 50，最大 100 |
| PageNumber | Integer | 实例状态列表的页码，起始值为 1，默认值为 1 |
| TotalCount | Integer | 实例总个数 |
错误类型
| 错误代码 | 描述 | Http状态码 | 语义 |
|---|---|---|---|
| MissingParameter | The input parameter "RegionId" that is mandatory for processing this request is not supplied. | 400 | RegionId 参数未指定 |
| InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 404 | 指定的 RegionId 不存在 |
| InvalidResourceType.NotFound | The ResourceType provided does not exist in our records. | 404 | 指定的 ResourceType 不存在 |
| InvalidTagCount | The specified tags are beyond the permitted range | 400 | 指定的 Tag 数超过了 5 个 |
示例
请求示例
https://ecs.aliyuncs.com/?Action=AddTags
&ResourceId=s-946ntx4wr
&ResourceType=snapshot
&RegionId=cn-shenzhen
&Tag.1.Key=test
&Tag.1.Value=api
&<公共请求参数>
返回示例
时间： 2024-11-05 06:04:02