Attaches tags to a customer master key (CMK), secret, or certificate.
You can attach up to 10 tags to a CMK, secret, or certificate.
In this example, the tags [{\"TagKey\":\"S1key1\",\"TagValue\":\"S1val1\"},{\"TagKey\":\"S1key2\",\"TagValue\":\"S2val2\"}]
are attached to the CMK whose ID is 08c33a6f-4e0a-4a1b-a3fa-7ddf****
.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | TagResource |
The operation that you want to perform. Set the value to TagResource. |
Tags | String | Yes | [{\"TagKey\":\"S1key1\",\"TagValue\":\"S1val1\"},{\"TagKey\":\"S1key2\",\"TagValue\":\"S2val2\"}] |
One or more tags. Format: tag object array. Tag object attributes:
|
KeyId | String | No | 08c33a6f-4e0a-4a1b-a3fa-7ddf**** |
The ID of the CMK. The ID must be globally unique. Note You can set only one of the KeyId, SecretName, and CertificateId parameters.
|
SecretName | String | No | MyDbC**** |
The name of the secret. Note You can set only one of the KeyId, SecretName, and CertificateId parameters.
|
CertificateId | String | No | 770dbe42-e146-43d1-a55a-1355db86**** |
The ID of the certificate. Note You can set only one of the KeyId, SecretName, and CertificateId parameters.
|
For more information about common request parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 4162a6af-bc99-40b3-a552-89dcc8aaf7c8 |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=TagResource
&KeyId=08c33a6f-4e0a-4a1b-a3fa-7ddf****
&Tags=[{\"TagKey\":\"S1key1\",\"TagValue\":\"S1val1\"},{\"TagKey\":\"S1key2\",\"TagValue\":\"S2val2\"}]
&<Common request parameters>|
Sample success responses
XML
format
<KMS>
<RequestId>4162a6af-bc99-40b3-a552-89dcc8aaf7c8</RequestId>
</KMS>
JSON
format
{
"RequestId":"4162a6af-bc99-40b3-a552-89dcc8aaf7c8"
}
Error codes
For a list of error codes, visit the API Error Center.