Criar e adicionar uma tag - : Central de Documentação do Alibaba Cloud

Se você tiver muitas instâncias, crie várias tags e adicione-as a elas. Depois, filtre as instâncias por tag.

Uma tag consiste em uma chave e um valor. Cada chave deve ser exclusiva na região da conta Alibaba Cloud. Chaves diferentes podem ter o mesmo valor.
Se a tag especificada não existir, o sistema a criará automaticamente e a adicionará à instância indicada.
Se a chave da tag especificada for igual à de uma tag existente, a nova tag substituirá a anterior.
Adicione até 20 tags a uma instância.
Adicione tags a até 50 instâncias em cada chamada.

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	TagResources	A operação a ser executada. Defina o valor como TagResources.
RegionId	String	Sim	cn-hangzhou	O ID da região. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ResourceType	String	Sim	INSTANCE	O tipo do recurso. Defina o valor como INSTANCE.
ResourceId.N	String	Sim	rm-uf6wjk5xxxxxxx	Os IDs das instâncias. Adicione tags a N instâncias simultaneamente. Valores válidos de N: 1 a 50.
Tag.N.Key	String	Sim	testkey1	A chave da tag a ser adicionada à instância. Crie N chaves de tag simultaneamente. Valores válidos de N: 1 a 20. Este parâmetro não pode ser uma string vazia.
Tag.N.Value	String	Não	testvalue1	O valor da tag associado à chave especificada. Crie N valores de tag simultaneamente. Valores válidos de N: 1 a 20. Este parâmetro pode ser uma string vazia.

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=TagResources
&RegionId=cn-hangzhou
&ResourceType=INSTANCE
&ResourceId.1=rm-uf6wjk5xxxxxxx
&Tag.1.Key=testkey1
&Tag.1.Value=testvalue1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<TagResourcesResponse>
<RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>

Formato JSON

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

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NumberExceed.Tags	The maximum number of Tags is exceeded. The maximum value is 20.	O número de tags criadas excedeu o limite superior. É permitido criar até 20 tags por instância.
400	MissingParameter	The parameter - Tags should not be null	O parâmetro Tag.N.Key não foi especificado.
400	InvalidTagKey.Malformed	The Tag.N.Key parameter is blank	O valor do parâmetro Tag.N.Key é uma string vazia.
400	InvalidTagValue.Malformed	The Tag.N.Value parameter is blank	O valor do parâmetro Tag.N.Value está vazio.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	O parâmetro Tag.N.Key especifica uma chave duplicada.
400	OperationDenied.QuotaExceed	The maximum number of Tags is exceeded.	A quantidade de tags criadas ultrapassou o limite máximo permitido.
400	NumberExceed.ResourceIds	The maximum number of ResourceIds is exceeded. The maximum value is 50.	O número de IDs de instância excedeu o limite superior. Especifique até 50 IDs de instância.
400	InvalidTagKey.Malformed	The operator is not permission for the system tag	Você não tem autorização para executar operações em tags de sistema.
400	Request.NotFound	The requested resource is not available.	O recurso solicitado está indisponível.
400	InvalidTagValue.Malformed	The Tag.N.Value parameter is invalid.	O valor do parâmetro Tag.N.Value é inválido.

Para obter uma lista de códigos de erro, visite o API Error Center.