TagResources - : Central de Documentação do Alibaba Cloud

Observações de uso

Antes de adicionar tags a um recurso, o Alibaba Cloud verifica a quantidade de tags existentes. Se o limite máximo for atingido, o sistema retornará uma mensagem de erro. Para mais informações, consulte a seção "Limites de tags" em Limites.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos 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	Operação a ser executada. Defina o valor como TagResources.
RegionId	String	Sim	cn-hangzhou	ID da região do recurso. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ResourceType	String	Sim	instance	Tipo do recurso. Valores válidos: instance: instância ECS disk: disco snapshot: snapshot image: imagem securitygroup: grupo de segurança volume: volume de armazenamento eni: interface de rede elástica (ENI) ddh: host dedicado ddhcluster: cluster de hosts dedicados keypair: par de chaves SSH launchtemplate: modelo de inicialização reservedinstance: instância reservada snapshotpolicy: política automática de snapshot elasticityassurance: garantia de elasticidade capacityreservation: reserva de capacidade command: comando do Cloud Assistant invocation: resultado da execução de comando do Cloud Assistant ou entrega de arquivo activation: código de ativação para instância gerenciada pelo Cloud Assistant managedinstance: instância gerenciada pelo Cloud Assistant
ResourceId.N	String	Sim	r-XXX	ID do recurso N. Valores válidos de N: 1 a 50.
Tag.N.Key	String	Sim	TestKey	Chave da tag N a ser adicionada ao recurso. Valores válidos de N: 1 a 20. A chave não pode ser uma string vazia, deve ter até 128 caracteres e não pode conter `http://` ou `https://`. Também não pode começar com `acs:` ou `aliyun`.
Tag.N.Value	String	Sim	TestValue	Valor da tag N a ser adicionado ao recurso. Valores válidos de N: 1 a 20. O valor pode ser uma string vazia, ter até 128 caracteres e não pode conter `http://` ou `https://`. Além disso, não pode começar com `acs:`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.

Exemplos

Solicitações de exemplo

https://ecs.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=i-bp1j6qtvdm8w0z1o0****
&ResourceId.2=i-bp1j6qtvdm8w0z1oP****
&ResourceType=instance
&Tag.1.Key=TestKey
&<Common request parameters>

Respostas de sucesso de exemplo

Formato XML

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

<TagResourcesResponse>
  <RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</TagResourcesResponse>

Formato JSON

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

{
  "RequestId" : "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	A chave da tag já existe. As chaves de tag devem ser únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Valor inválido para Tag.N.Key.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Valor inválido para Tag.N.Value.
400	OperationDenied.QuotaExceed	The quota of tags on resource is beyond permitted range.	O número máximo de tags foi excedido.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Os parâmetros Tag.N.Key e Tag.N.Value especificados não correspondem entre si.
400	InvalidTagCount	The specified tags are beyond the permitted range.	O número máximo de tags foi excedido.
400	Invalid.Scope	The specified scope is invalid.	Valor inválido para Scope.
403	PermissionDenied.TagOwnerUid	The specified operator not have permission to set TagOwnerUid value.	Você não tem autorização para definir o parâmetro TagOwnerUid.
403	PermissionDenied.Scope	The specified operator not have permission to set Scope value.	Você não tem autorização para definir o parâmetro Scope.
403	InvalidResourceId.NotSupported	The specified ResourceId does not support tagging.	O recurso especificado não suporta tags.
403	NoPermission.Tag	The operator is not permission for the tag.	Você não tem autorização para gerenciar a tag.
403	QuotaExceed.Tags	%s	O número máximo de tags foi excedido. %s é uma variável. Uma mensagem de erro é retornada dinamicamente com base nas condições da chamada.
404	InvalidRegionId.NotFound	%s	O ID da região especificado não existe.
404	MissingParameter.ResourceType	The parameter - ResourceType should not be null.	O parâmetro ResourceType é obrigatório.
404	InvalidResourceId.NotFound	The specified ResourceIds are not found in our records.	O recurso especificado não existe. Verifique se o parâmetro ResourceId está correto.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	O tipo de recurso especificado não foi encontrado.
404	InvalidRegionId.NotFound	The specified RegionId does not exist.	O ID da região especificado não existe.
500	ServiceUnavailable	The service is unavailable, please try again later.	O serviço está temporariamente indisponível. Tente novamente mais tarde.

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