Todos os produtos
Search
Central de documentação

:TagResource

Última atualização: Jul 08, 2026

Adiciona tags a uma chave, um segredo ou um certificado.

Você pode adicionar até 10 tags a uma chave, um segredo ou um certificado.

No exemplo a seguir, usa-se uma chave com o ID key-hzz630494463ejqjx****. As tags [{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}] são adicionadas à chave.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action String Sim TagResource

A operação a ser executada. Defina o valor como TagResource.

KeyId String Não key-hzz630494463ejqjx****

O ID, o alias ou o Alibaba Cloud Resource Name (ARN) da chave. Para mais informações, consulte Gerenciar um alias de chave.

Nota
  • Ao acessar uma chave em outra conta Alibaba Cloud, insira o ARN da chave. O ARN da chave segue o formato acs:kms:${region}:${account}:key/${keyid}.
  • Configure apenas um dos seguintes parâmetros: KeyId, SecretName ou CertificateId.
Tags String Sim [{"TagKey":"S1key1","TagValue":"S1val1"},{"TagKey":"S1key2","TagValue":"S2val2"}]

Uma ou mais tags a adicionar. O valor deve estar no formato de array.

Atributos da tag:

  • TagKey: a chave da tag.
  • TagValue: o valor da tag.
SecretName String Não MyDbC****

O nome do segredo.

Nota Configure apenas um dos seguintes parâmetros: KeyId, SecretName ou CertificateId.
CertificateId String Não 770dbe42-e146-43d1-a55a-1355db86****

O ID do certificado.

Nota Configure apenas um dos seguintes parâmetros: KeyId, SecretName ou CertificateId.

Para obter mais informações sobre os parâmetros de solicitação comuns, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

4162a6af-bc99-40b3-a552-89dcc8aaf7c8

O ID da solicitação.

Exemplos

Exemplos de solicitações

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****
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

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

Formato JSON

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

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

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidParameter

The specified parameter is not valid.

O parâmetro especificado é inválido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.