调用TagResources接口为统一创建并指定的实例资源列表绑定标签。
使用说明
在调用本接口时,您必须输入数据库审计的实例的ID、地域ID、资源类型定义的参数。
QPS限制
本接口的单用户QPS限制为10次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | TagResources |
系统规定参数。取值:TagResources。 |
RegionId | String | 是 | cn-hangzhou |
数据库审计实例的地域ID。 您可以通过调用DescribeRegions获取地域ID。 |
ResourceType | String | 是 | INSTANCE |
资源类型定义。 取值:INSTANCE,表示审计实例。 |
ResourceId.N | String | 是 | dbaudit-cn-78v1gc**** |
审计的实例ID。该参数中的N代表多个值的序号,取值范围:1~20。 您可以通过调用DescribeInstances获取实例ID。 |
Tag.N.Key | String | 否 | test |
实例的标签键。该参数中的N代表多个值的序号,取值范围:1~20。 当传入该值时,不允许为空字符串,最多支持128个字符,不能以 |
Tag.N.Value | String | 否 | testapi |
实例的标签值。该参数中的N代表多个值的序号,取值范围:1~20。 当传入该值时,可以为空字符串,最多支持128个字符,不能以 |
调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数。
调用API的请求格式,请参见本文示例中的请求示例。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 23DD5EDB-EAC7-44A5-A68E-798BB085D27F |
本次请求的ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId=["dbaudit-cn-78v1gc****"]
&Tag=[{"Key":"test","Value":"testapi"}]
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<TagResourcesResponse>
<RequestId>23DD5EDB-EAC7-44A5-A68E-798BB085D27F</RequestId>
</TagResourcesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "23DD5EDB-EAC7-44A5-A68E-798BB085D27F"
}
错误码
访问错误中心查看更多错误码。