為密鑰或憑據(jù)綁定標(biāo)簽。

支持一次為多個(gè)密鑰或者多個(gè)憑據(jù)綁定多個(gè)標(biāo)簽。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計(jì)算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 TagResources

要執(zhí)行的操作。取值：TagResources。
RegionId String 是 cn-hangzhou

資源所屬的地域ID。

說(shuō)明 您可以調(diào)用DescribeRegions查看當(dāng)前阿里云賬號(hào)的可用地域列表。
ResourceType String 是 key

要綁定標(biāo)簽的資源類型。取值：

  • key：密鑰
  • secret：憑據(jù)
ResourceId.N String 否 key-hzz62f1cb66fa42qo****

要綁定標(biāo)簽的資源ID列表，最多可以輸入50個(gè)資源ID。

輸入多個(gè)資源ID時(shí)，格式為["ResourceId.1","ResourceId.2",...]。
Tag.N.Key String 否 disk-encryption

標(biāo)簽鍵。每個(gè)標(biāo)簽由一個(gè)鍵值對(duì)（Key:Value）組成，包含標(biāo)簽鍵（Key）、標(biāo)簽值（Value）。

最多可以輸入20個(gè)標(biāo)簽。輸入多個(gè)標(biāo)簽時(shí)，格式為[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]。

每個(gè)標(biāo)簽鍵最多支持128個(gè)字符，可以包含英文大小寫字母、數(shù)字、正斜線（/）、反斜線（\）、下劃線（_）、短劃線（-）、半角句號(hào)（.）、加號(hào)（+）、等于號(hào)（=）、半角冒號(hào)（:）、字符at（@）。

說(shuō)明 標(biāo)簽鍵不能以aliyun或acs:開(kāi)頭。
Tag.N.Value String 否 true

標(biāo)簽值。每個(gè)標(biāo)簽由一個(gè)鍵值對(duì)（Key:Value）組成，包含標(biāo)簽鍵（Key）、標(biāo)簽值（Value）。

最多可以輸入20個(gè)標(biāo)簽。輸入多個(gè)標(biāo)簽時(shí)，格式為[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]。

每個(gè)標(biāo)簽值最多支持128個(gè)字符，可以包含英文大小寫字母、數(shù)字、正斜線（/）、反斜線（\）、下劃線（_）、短劃線（-）、半角句號(hào)（.）、加號(hào)（+）、等于號(hào)（=）、半角冒號(hào)（:）、字符at（@）。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
RequestId String 598d0219-45cd-4477-84ad-85a52d9debcf

本次調(diào)用請(qǐng)求的ID，是由阿里云為該請(qǐng)求生成的唯一標(biāo)識(shí)符，可用于排查和定位問(wèn)題。

示例

請(qǐng)求示例

http(s)://[Endpoint]/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=key
&ResourceId=["key-hzz62f1cb66fa42qo****"]
&Tag=[{"Key":"disk-encryption","Value":"true"}]
&公共請(qǐng)求參數(shù)

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<TagResourcesResponse>
    <RequestId>598d0219-45cd-4477-84ad-85a52d9debcf</RequestId>
</TagResourcesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "598d0219-45cd-4477-84ad-85a52d9debcf"
}

錯(cuò)誤碼

HttpCode 錯(cuò)誤碼 錯(cuò)誤信息 描述
400 InvalidParameter.TagValue The specified parameter is not valid. 您指定的標(biāo)簽值非法。
400 InvalidParameter.TagKey The specified parameter is not valid. 指定的標(biāo)簽鍵非法。
400 Duplicate.TagKey The specified tagKey is duplicate. 指定的標(biāo)簽值是重復(fù)的。
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records. 提供的 Access Key ID不存在
404 InvalidResourceId.NotFound The specified ResourceId is not found. 沒(méi)有找到指定的資源Id。

訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。