全部產品
Search
文件中心

:TagResources

更新時間:Jan 23, 2025

為密鑰或憑據綁定標籤。

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

調試

您可以在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。

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