调用UntagResource接口为主密钥、凭据或证书解绑标签_密钥管理服务(KMS)-阿里云帮助中心

本文将提供一个示例，为ID为08c33a6f-4e0a-4a1b-a3fa-7ddf****的密钥解绑标签键为tagkey1、tagkey2的标签。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	UntagResource	要执行的操作。取值：UntagResource。
KeyId	String	否	08c33a6f-4e0a-4a1b-a3fa-7ddf****	密钥ID。主密钥（CMK）的全局唯一标识符。说明 KeyId、SecretName和CertificateId必须且只能指定其中一个参数。
TagKeys	String	是	["tagkey1","tagkey2"]	一个或多个标签键，多个标签键用半角逗号（,）间隔。您只需指定标签键，不需要指定标签值。长度为1~128个字节。
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=UntagResource
&KeyId=08c33a6f-4e0a-4a1b-a3fa-7ddf****
&TagKeys=["tagkey1","tagkey2"]
&SecretName=MyDbC****
&CertificateId=770dbe42-e146-43d1-a55a-1355db86****
&公共请求参数

正常返回示例

XML格式

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

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

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.	参数非法。
404	InvalidAccessKeyId.NotFound	The Access Key ID provided does not exist in our records.	提供的 Access Key ID不存在

访问错误中心查看更多错误码。