TagResource - - 阿里雲

使用限制：您最多可以為主要金鑰、憑據或認證分別綁定10個標籤。

本文將提供一個樣本，為ID為key-hzz630494463ejqjx****的密鑰綁定標籤[{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}]。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱	類型	是否必選	樣本值	描述
Action	String	是	TagResource	要執行的操作。取值：TagResource。
KeyId	String	否	key-hzz630494463ejqjx****	密鑰的ID，也可以指定為密鑰別名或密鑰資源名稱（ARN）。關於別名的詳細介紹，請參見管理密鑰別名。說明訪問其他阿里雲帳號下的密鑰時，必須輸入密鑰ARN。密鑰ARN的格式為`acs:kms:${region}:${account}:key/${keyid}`。 KeyId、SecretName和CertificateId必須且只能指定其中一個參數。
Tags	String	是	[{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}]	一個或多個標籤。格式為Tag對象數組。 Tag對象屬性如下： TagKey：標籤鍵。 TagValue：標籤值。
SecretName	String	否	MyDbC****	憑據名稱。說明 KeyId、SecretName和CertificateId必須且只能指定其中一個參數。
CertificateId	String	否	770dbe42-e146-43d1-a55a-1355db86****	認證ID。說明 KeyId、SecretName和CertificateId必須且只能指定其中一個參數。

關於公用請求參數的詳情，請參見公用參數。

返回資料

名稱	類型	樣本值	描述
RequestId	String	4162a6af-bc99-40b3-a552-89dcc8aaf7c8	本次調用請求的ID，是由阿里雲為該請求產生的唯一識別碼，可用於排查和定位問題。

樣本

請求樣本

http(s)://[Endpoint]/?Action=TagResource
&KeyId=key-hzz630494463ejqjx****
&Tags=[{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}]
&SecretName=MyDbC****
&CertificateId=770dbe42-e146-43d1-a55a-1355db86****
&公用請求參數

正常返回樣本

XML格式

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

<TagResourceResponse>
    <RequestId>4162a6af-bc99-40b3-a552-89dcc8aaf7c8</RequestId>
</TagResourceResponse>

JSON格式

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

{
  "RequestId" : "4162a6af-bc99-40b3-a552-89dcc8aaf7c8"
}

錯誤碼

HttpCode	錯誤碼	錯誤資訊	描述
400	InvalidParameter	The specified parameter is not valid.	參數非法。

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