為密鑰或憑據綁定標簽。

支持一次為多個密鑰或者多個憑據綁定多個標簽。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

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

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

資源所屬的地域ID。

說明 您可以調用DescribeRegions查看當前阿里云賬號的可用地域列表。
ResourceType String 是 key

要綁定標簽的資源類型。取值：

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

要綁定標簽的資源ID列表，最多可以輸入50個資源ID。

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

標簽鍵。每個標簽由一個鍵值對（Key:Value）組成，包含標簽鍵（Key）、標簽值（Value）。

最多可以輸入20個標簽。輸入多個標簽時，格式為[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]。

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

說明 標簽鍵不能以aliyun或acs:開頭。
Tag.N.Value String 否 true

標簽值。每個標簽由一個鍵值對（Key:Value）組成，包含標簽鍵（Key）、標簽值（Value）。

最多可以輸入20個標簽。輸入多個標簽時，格式為[{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},...]。

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

返回數據

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

本次調用請求的ID，是由阿里云為該請求生成的唯一標識符，可用于排查和定位問題。

示例

請求示例

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

正常返回示例

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"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.TagValue The specified parameter is not valid. 您指定的標簽值非法。
400 InvalidParameter.TagKey The specified parameter is not valid. 指定的標簽鍵非法。
400 Duplicate.TagKey The specified tagKey is duplicate. 指定的標簽值是重復的。
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. 沒有找到指定的資源Id。

訪問錯誤中心查看更多錯誤碼。