Todos os produtos
Search
Central de documentação

:TagResources

Última atualização: Jul 09, 2026

Adiciona tags a chaves ou segredos.

Você pode adicionar várias tags a múltiplas chaves ou segredos simultaneamente.

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âmetroTipoObrigatórioExemploDescrição
ActionStringSimTagResources

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

RegionIdStringSimcn-hangzhou

O ID da região à qual o recurso pertence.

Nota Chame a operação DescribeRegions para consultar a lista de regiões disponíveis na conta atual do Alibaba Cloud.
ResourceTypeStringSimkey

O tipo de recurso ao qual adicionar tags. Valores válidos:

  • key
  • secret
ResourceId.NStringNãokey-hzz62f1cb66fa42qo****

Os IDs dos recursos aos quais adicionar tags. Limite de 50 IDs de recursos.

Insira vários IDs de recursos no formato ["ResourceId. 1","ResourceId. 2",...].

Tag.N.KeyStringNãodisk-encryption

A chave da tag. Uma tag consiste em um par chave-valor.

Limite de 20 tags. Insira múltiplas tags no formato [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

Cada chave de tag pode ter até 128 caracteres e conter letras, dígitos, barras (/), barras invertidas (\), sublinhados (_), hifens (-), pontos (.), sinais de mais (+), sinais de igual (=), dois-pontos (:) e arrobas (@).

Nota A chave da tag não pode começar com aliyun ou acs:.
Tag.N.ValueStringNãotrue

O valor da tag. Uma tag consiste em um par chave-valor.

Limite de 20 tags. Insira múltiplas tags no formato [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

Cada valor de tag pode ter até 128 caracteres e conter letras, dígitos, barras (/), barras invertidas (\), sublinhados (_), hifens (-), pontos (.), sinais de mais (+), sinais de igual (=), dois-pontos (:) e arrobas (@).

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

598d0219-45cd-4477-84ad-85a52d9debcf

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceType=key
&ResourceId=["key-hzz62f1cb66fa42qo****"]
&Tag=[{"Key":"disk-encryption","Value":"true"}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<TagResourcesResponse>
    <RequestId>598d0219-45cd-4477-84ad-85a52d9debcf</RequestId>
</TagResourcesResponse>

Formato JSON

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

{
  "RequestId" : "598d0219-45cd-4477-84ad-85a52d9debcf"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400

InvalidParameter.TagValue

The specified parameter is not valid.

O valor da tag especificado é inválido.

400

InvalidParameter.TagKey

The specified parameter is not valid.

A chave da tag especificada é inválida.

400

Duplicate.TagKey

The specified tagKey is duplicate.

A chave da tag especificada é duplicada.

404

InvalidAccessKeyId.NotFound

The Access Key ID provided does not exist in our records.

O AccessKey ID especificado não existe.

404

InvalidResourceId.NotFound

The specified ResourceId is not found.

O ID do recurso especificado não foi encontrado.

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