调用ListTagResources查询实例已经绑定的标签列表。
- 请求中至少指定参数ResourceId.N或Tag.N(Tag.N.Key与Tag.N.Value),以确定检索对象。
- Tag.N是资源的标签,由一个键值对组成。仅指定Tag.N.Key时,则返回该标签键关联的所有标签值。仅指定Tag.N.Value会报错。
- 如果您同时指定Tag.N和ResourceId.N筛选标签,则ResourceId.N必须满足所有输入的标签键值对。
- 如果您同时指定多个标签键值对,返回结果为同时包含被指定的多个键值对的资源。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListTagResources |
系统规定参数。取值:ListTagResources。 |
RegionId | String | 是 | cn-hangzhou |
负载均衡实例所在的地域ID。 您可以通过调用DescribeRegions接口查询地域ID。 |
ResourceType | String | 是 | instance |
资源类型定义,取值:
|
NextToken | String | 否 | caeba0bbb2be03f84eb48b699f0a**** |
是否拥有下一次查询的令牌(Token)。取值:
|
Tag.N.Key | String | 否 | FinanceDept |
资源的标签键。N的取值范围:1~20。 一旦传入该值,则不允许为空字符串。最多支持64个字符,不能以 |
Tag.N.Value | String | 否 | FinanceJoshua |
资源的标签值。N的取值范围:1~20。一旦传入该值,不可以为空字符串。 最多支持128个字符,不能以 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | caeba0bbb2be03f84eb48b699f0a**** |
是否拥有下一次查询的令牌(Token)。取值:
|
RequestId | String | DE65F6B7-7566-4802-9007-96F2494AC512 |
请求ID。 |
TagResources | Array of TagResource |
绑定标签的资源信息。 |
|
TagResource | |||
TagValue | String | FinanceJoshua |
标签值。 |
ResourceType | String | instance |
资源类型。 |
ResourceId | String | lb-bp16qjewdsunr4****** |
资源ID。 |
TagKey | String | FinanceDept |
标签键。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ListTagResources
&ResourceOwnerId=111
&RegionId=cn-hangzhou
&ResourceType=instance
&NextToken=caeba0bbb2be03f84eb48b699f0a****
&ResourceId=["lb-bp1qnnvj18yy6h******"]
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ListTagResourcesResponse>
<NextToken>caeba0bbb2be03f84eb48b699f0a****</NextToken>
<RequestId>DE65F6B7-7566-4802-9007-96F2494AC512</RequestId>
<TagResources>
<TagValue>FinanceJoshua</TagValue>
<ResourceType>instance</ResourceType>
<ResourceId>lb-bp16qjewdsunr4******</ResourceId>
<TagKey>FinanceDept</TagKey>
</TagResources>
</ListTagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "caeba0bbb2be03f84eb48b699f0a****",
"RequestId" : "DE65F6B7-7566-4802-9007-96F2494AC512",
"TagResources" : [ {
"TagValue" : "FinanceJoshua",
"ResourceType" : "instance",
"ResourceId" : "lb-bp16qjewdsunr4******",
"TagKey" : "FinanceDept"
} ]
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | TagTypeNotSame | The category of tags in the same request must be the same. | 同一请求中的标签类别必须相同。 |
400 | ResourceNotExist | %s. | 指定的资源不存在。 |
400 | QueryTokenNotExist | The specified NextToken does not exist. | 指定的NextToken 不存在。 |
400 | InvalidParam.NextToken | The specified NextToken is invalid. | 指定的NextToken无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.Scope | The specified Scope is invalid. | 指定的Scope无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.ResourceType | The specified ResourceType is invalid. | 指定的ResourceType无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.TagKey | The specified TagKey is invalid. | 指定的TagKey无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.TagValue | The specified TagValue is invalid. | 指定的TagValue无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.TagKeyOrValue | The specified TagKey or TagValue is invalid. | 指定的TagKey Or Value无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.TagOwnerUid | The specified TagOwnerUid is invalid. | 指定的TagOwnerUid无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParam.TagOwnerBid | The specified TagOwnerBid is invalid. | 指定的TagOwnerBid无效。请检查参数约束,并在修改后重试。 |
400 | MissingParam.Scope | The parameter Scope is required. | 参数Scope缺失。 |
400 | MissingParam.TagOwnerUid | The parameter TagOwnerUid is required. | 参数TagOwnerUid缺失。 |
400 | MissingParam.TagOwnerBid | The parameter TagOwnerBid is required. | 参数TagOwnerBid缺失。 |
400 | InvalidParameter.RegionId | The specified RegionId does not exist. | 指定的RegionId不存在。 |
400 | MissingParam.TagOrResourceId | The parameter Tag or ResourceId is required at least one. | 参数TagOrResourceId缺失。 |
400 | SizeLimitExceeded.ResourceId | The maximum size of ResourceId is exceeded. | 指定的ResourceId长度无效。请检查参数约束,并在修改后重试。 |
400 | SizeLimitExceeded.Tag | The maximum size of Tag is exceeded. | 指定的Tag长度无效。请检查参数约束,并在修改后重试。 |
访问错误中心查看更多错误码。