Todos os produtos
Search
Central de documentação

:Vincular tags

Última atualização: Jun 26, 2026

Use a operação AddTagsToResource para vincular tags novas ou existentes a uma instância do ApsaraDB RDS.

Esta operação tem as seguintes limitações:

  • Cada tag consiste em uma TagKey e uma TagValue. A TagKey é obrigatória; a TagValue, opcional.

  • Os valores de TagKey e TagValue não podem começar com aliyun.

  • Os valores de TagKey e TagValue não diferenciam maiúsculas de minúsculas.

  • A TagKey admite no máximo 64 caracteres; a TagValue, até 128 caracteres.

  • Cada instância aceita no máximo 10 tags. As tags vinculadas à mesma instância devem ter TagKeys exclusivas. Se você vincular uma nova tag com uma TagKey já existente, a nova tag substituirá a anterior.

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 da solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimAddTagsToResource

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

RegionIdStringSimcn-hagnzhou

O ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

DBInstanceIdStringSimrm-uf6wjk5xxxxxxx

O ID da instância.

Nota Insira até 30 IDs de instância em uma única solicitação. Se inserir mais de um ID, separe-os por vírgulas (,).
AccessKeyIdStringNãoLTAIfCxxxxxxx

O AccessKey ID fornecido pela Alibaba Cloud.

TagsStringNão{"key1":"value1","key2":""}

As tags a serem vinculadas. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. Formato: {"key1":"value1","key2":"value2"...}.

Nota A TagKey é obrigatória; a TagValue, opcional.
Tag.1.keyStringNãokey1

A TagKey da primeira tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.2.keyStringNãokey2

A TagKey da segunda tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.3.keyStringNãokey3

A TagKey da terceira tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.4.keyStringNãokey4

A TagKey da quarta tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.5.keyStringNãokey5

A TagKey da quinta tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.1.valueStringNãovalue1

A TagValue da primeira tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.2.valueStringNãovalue2

A TagValue da segunda tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.3.valueStringNãovalue3

A TagValue da terceira tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.4.valueStringNãovalue4

A TagValue da quarta tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

Tag.5.valueStringNãovalue5

A TagValue da quinta tag a ser vinculada. Cada tag consiste em uma TagKey e uma TagValue. Especifique até cinco tags por solicitação. A TagKey é obrigatória; a TagValue, opcional.

ClientTokenStringNãoETnLKlblzczshOTUbOCzxxxxxxx

Token de cliente usado para garantir a idempotência da solicitação. Gere esse valor no cliente e assegure que seja exclusivo entre solicitações diferentes. O token deve conter apenas caracteres ASCII e não pode exceder 64 caracteres.

proxyIdStringNãoAPI

O ID do padrão de proxy.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

224DB9F7-3100-4899-AB9C-C938BCCB43E7

O ID da solicitação.

Exemplos

Exemplos de solicitações


http(s)://rds.aliyuncs.com/? Action=AddTagsToResource
&RegionId=cn-hagnzhou
&DBInstanceId=rm-uf6wjk5xxxxxxx
&Tags=%7B%22test%22%3A%221%22%7D
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<AddTagsToResourceResponse>
	  <requestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</requestId></AddTagsToResourceResponse>

Formato JSON

{
	"requestId":"224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.