为主密钥、凭据或证书绑定标签。
接口说明
-
RAM 用户或 RAM 角色调用该 OpenAPI 需要被授予的权限策略详情，请参见访问控制。
-
您最多可以为主密钥、凭据或证书分别绑定 10 个标签。
本文将提供一个示例，为 ID 为key-hzz630494463ejqjx**** 的密钥绑定标签[{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}]。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| KeyId | string | 否 | 密钥的 ID，也可以指定为密钥别名或密钥资源名称（ARN）。关于别名的详细介绍，请参见管理密钥别名。 说明
acs:kms:${region}:${account}:key/${keyid}。 | key-hzz630494463ejqjx**** |
| Tags | string | 是 | 一个或多个标签。格式为 Tag 对象数组。
| [{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}] |
| SecretName | string | 否 | 凭据名称。 说明
KeyId、SecretName 和 CertificateId 必须且只能指定其中一个参数。
| MyDbC**** |
| CertificateId | string | 否 | 证书 ID。 说明
KeyId、SecretName 和 CertificateId 必须且只能指定其中一个参数。
| 770dbe42-e146-43d1-a55a-1355db86**** |
关于公共请求参数的详情，请参见公共参数。
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "4162a6af-bc99-40b3-a552-89dcc8aaf7c8"
}错误码
| HTTP status code | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is not valid. | 参数非法。 |
| 404 | InvalidAccessKeyId.NotFound | The Access Key ID provided does not exist in our records. | - |
访问错误中心查看更多错误码。