最近更新时间:2021-03-05 11:52:29
描述当前region下指定资源类型的标签分类的功能。
描述标签分类时,需要指定资源类型,描述成功返回匹配资源类型的描述结果及总数,否则返回空。
返回API概览
名称 | 类型 | 必须 | 长度限制(字符) | 参数格式 | 描述 |
---|---|---|---|---|---|
Action | String | 是 | 确定值 | [a-zA-Z]+ |
操作接口名,系统规定参数,取值:DescribeTagKeys |
ResourceType | String | 是 | 最短是1,最长64 | [a-zA-Z]+ |
资源类型,目前支持kec-image、kec-instance、rds-instance、security-group、vpc、subnet、eip、slb、bucket、kcs-instance、volume、nat、tunnel、bws、peering ,其中kec-image、volume、tunnel暂未对外开放 |
MaxResults | Integer | 否 | 最小值5,最大值1000,默认100 | 用于限制本次查询结果返回的结果数量,如果仍有额外结果未显示,同时返回下次查询的起始点NextToken值 | |
NextToken | String | 否 | [a-zA-Z]+ |
当返回结果被截断时,使用NextToken值用于标示下次调用查询用户操作的起始点 |
名称 | 类型 | 描述 |
---|---|---|
NextToken | String | 当返回结果被截断时,使用NextToken值用于标示下次调用查询用户操作的起始点,可以缺省 |
TagKeySum | Integer | 本次查询返回的标签分类总数(与是否分页无关) |
TagKeySet | String 列表 | “标签分类”列表 |
错误代码(Code) | 错误消息(Message) | HTTP 状态码 | 中文描述(语义) |
---|---|---|---|
MissingParameter | A required parameter for the specified action is not supplied. | 400 | 忘记必选参数%s,具体参数名在%s说明 |
InvalidParameterValue | An invalid or out-of-range value %s for parameter MaxResults was supplied. | 400 | 参数MaxResults的输入值%s无效、不合法或者超出范围,具体输入值在%s说明 |
InvalidParameterValue | Unable to parse pagination token for parameter NextToken. | 400 | 无法解析参数NextToken的输入值%s,具体输入值在%s说明 |
InvalidParameterValue | The ResourceType value %s is invalid. | 400 | ResourceType参数输入值%s无效,具体输入值在%s说明 |
描述资源类型为kec-instance的标签分类全部结果
https://tag.api.ksyun.com/?Action=DescribeTagKeys
&ResourceType=kec-instance
&公共请求参数
<DescribeTagKeysResponse xmlns="https://tag.ksyun.com/doc/2016-03-04/">
<RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
<TagKeySum>3</TagKeySum>
<TagKeySet>
<member>
<Key>Department<Key>
</member>
<member>
<Key>Usage<Key>
</member>
<member>
<Key>User<Key>
</member>
</TagKeySet>
</DescribeTagKeysResponse>
{
"RequestId":"7a62c49f-347e-4fc4-9331-6e8eEXAMPLE",
"TagValueSum":2,
"TagSet":[
{
"Key": "Department"
},
{
"Key": "Usage"
},
{
"Key": "User"
}
]
}
纯净模式