云数据库 Redis 查询标签和实例的绑定关系

By | 2021年4月22日

调用ListTagResources查询Redis实例和标签的绑定关系。

该API对应的控制台操作请参见根据标签筛选实例查看实例绑定的标签

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ListTagResources

系统规定参数,取值:ListTagResources

RegionId String cn-hangzhou

实例所属的地域ID。

ResourceType String INSTANCE

资源类型,取值固定为INSTANCE

ResourceId.N RepeatList r-bp1zxszhcgatnx****

实例ID,可以设置多个。

说明

  • N表示传入第几个实例ID。例如:ResourceId.1表示传入第一个实例ID;ResourceId.2表示传入第二个实例ID。
  • 本参数和Tag.N.Key参数两者中必须传入一项。

Tag.N.Key String demokey

标签的键。

说明

  • N表示传入第几个标签的键。例如:Tag.1.Key表示传入第一个标签的键;Tag.2.Key表示传入第二个标签的键。
  • 本参数和ResourceId.N参数两者中必须传入一项。

Tag.N.Value String demovalue

标签的值。

说明
N表示传入第几个标签的值。例如:
Tag.1.Value表示传入第一个标签的值;
Tag.2.Value表示传入第二个标签的值。

NextToken String 212db86sca4384811e0b5e8707ec2****

下一个查询开始Token,用来返回更多结果。

说明 第一次查询不需要提供本参数,如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的
NextToken值以继续查询。

返回数据

名称 类型 示例值 描述
NextToken String 212db86sca4384811e0b5e8707ec2****

如果一次查询没有返回全部结果,则可在后续查询中传入前一次返回的token继续查询。

RequestId String 47A514A1-4B77-4E30-B4C5-2A880650****

请求ID。

TagResources Array of TagResource

实例和标签的信息。

TagResource
ResourceId String r-bp1zxszhcgatnx****

资源ID,即Redis实例的ID。

ResourceType String ALIYUN::KVSTORE::INSTANCE

资源类型。返回值固定为ALIYUN::KVSTORE::INSTANCE,即云数据库Redis实例。

TagKey String demokey

标签的键。

TagValue String demovalue

标签的值。

示例

请求示例

https://r-kvstore.aliyuncs.com/?Action=ListTagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&Tag.1.Key=demokey1
&Tag.1.Value=demovalue1
&Tag.2.Key=demokey2
&Tag.2.Value=demovalue2
&<公共请求参数>

正常返回示例

XML 格式

<ListTagResourcesResponse>
      <TagResources>
            <TagResource>
                  <ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
                  <TagValue>demovalue1</TagValue>
                  <ResourceId>r-bp1zxszhcgatnx****</ResourceId>
                  <TagKey>demokey1</TagKey>
            </TagResource>
            <TagResource>
                  <ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
                  <TagValue>demovalue1</TagValue>
                  <ResourceId>r-bp1zxszhcgatnx****</ResourceId>
                  <TagKey>demokey1</TagKey>
            </TagResource>
            <TagResource>
                  <ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
                  <TagValue>demovalue2</TagValue>
                  <ResourceId>r-bp1zxszhcgatnx****</ResourceId>
                  <TagKey>demokey2</TagKey>
            </TagResource>
            <TagResource>
                  <ResourceType>ALIYUN::KVSTORE::INSTANCE</ResourceType>
                  <TagValue>demovalue2</TagValue>
                  <ResourceId>r-bp1zxszhcgatnx****</ResourceId>
                  <TagKey>demokey2</TagKey>
            </TagResource>
      </TagResources>
      <RequestId>47A514A1-4B77-4E30-B4C5-2A880650****</RequestId>
</ListTagResourcesResponse>

JSON 格式

{
	"TagResources": {
		"TagResource": [
			{
				"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
				"TagValue": "demovalue1",
				"ResourceId": "r-bp1zxszhcgatnx****",
				"TagKey": "demokey1"
			},
			{
				"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
				"TagValue": "demovalue1",
				"ResourceId": "r-bp1zxszhcgatnx****",
				"TagKey": "demokey1"
			},
			{
				"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
				"TagValue": "demovalue2",
				"ResourceId": "r-bp1zxszhcgatnx****",
				"TagKey": "demokey2"
			},
			{
				"ResourceType": "ALIYUN::KVSTORE::INSTANCE",
				"TagValue": "demovalue2",
				"ResourceId": "r-bp1zxszhcgatnx****",
				"TagKey": "demokey2"
			}
		]
	},
	"RequestId": "47A514A1-4B77-4E30-B4C5-2A880650****"
}

错误码

访问错误中心查看更多错误码。

请关注公众号获取更多资料

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

Iconic One Theme | Powered by Wordpress