Todos os produtos
Search
Central de documentação

Key Management Service:TagResources

Última atualização: Jun 28, 2026

Adiciona tags a uma ou mais chaves ou segredos.

Descrição da operação

Você pode adicionar várias tags a várias chaves ou a vários segredos por vez.

Para obter mais informações sobre a política de acesso necessária para que um usuário RAM ou uma função RAM chame esta API, consulte Resource Access Management.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região do recurso.

Nota

Você pode chamar a API DescribeRegions para consultar a lista de regiões mais recente.

cn-hangzhou

ResourceType

string

Sim

O tipo do recurso ao qual você deseja adicionar tags. Valores válidos:

  • key

  • secret

key

ResourceId

array

Sim

Os IDs dos recursos aos quais você deseja adicionar tags. Você pode inserir no máximo 50 IDs de recursos.

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

string

Não

Os IDs dos recursos aos quais você deseja adicionar tags. Você pode inserir no máximo 50 IDs de recursos.

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

key-hzz62f1cb66fa42qo****

Tag

array<object>

Sim

Uma lista de tags. Você pode inserir até 20 tags.

Uma tag consiste em um par chave-valor. Insira várias tags no formato [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

object

Não

Key

string

Não

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

Você pode inserir até 20 tags. Insira várias tags no formato [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

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

Nota

A chave não pode começar com aliyun ou acs:.

disk-encryption

Value

string

Não

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

Você pode inserir até 20 tags. Insira várias tags no formato [{"Key":"key1","Value":"value1"},{"Key":"key2","Value":"value2"},..].

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

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

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

Exemplos

Resposta de sucesso

JSON formato

{
  "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.
400 InvalidParameter.TagKey The specified parameter is not valid.
400 Duplicate.TagKey The specified tagKey is duplicate.
404 InvalidAccessKeyId.NotFound The Access Key ID provided does not exist in our records.
404 InvalidResourceId.NotFound The specified ResourceId is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.