TagResources_标签_API参考_云企业网

API描述

请求中至少指定参数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代码示例。

请求参数


名称	类型	是否必选	示例值	描述
ResourceId.N	RepeatList	是	cen-7qthudw0ll6jmc****	资源ID，N的取值范围为1~50。
ResourceType	String	是	cen	资源类型，取值：cen。
Tag.N.Key	String	是	FinanceDept	资源的标签键。N的取值范围：1~20。一旦传入该值，则不允许为空字符串。最多支持64个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。
Tag.N.Value	String	是	FinanceJoshua	资源的标签值。N的取值范围：1~20。一旦传入该值，可以为空字符串。最多支持128个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。
Action	String	否	TagResources	要执行的操作，取值：TagResources。

返回数据


名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。

示例

请求示例


http(s)://[Endpoint]/?Action=TagResources
&ResourceId.1=cen-7qthudw0ll6jmc****
&ResourceType=cen
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&<公共请求参数>

正常返回示例

XML 格式

<TagResourcesResponse>
      <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</TagResourcesResponse>

JSON 格式

{
	"RequestId":"C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

错误码

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