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

Cria e vincula tags a recursos ECS especificados em uma única operação.

Descrição da operação

Antes de anexar tags, o Alibaba Cloud verifica o número de tags existentes nos recursos. Se o número exceder o limite, uma mensagem de erro será retornada. Para obter mais informações, consulte Limites.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:TagResources

create

Host dedicado.

acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

Disco.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

Interface de rede.

acs:ecs:{#regionId}:{#accountId}:eni/{#eniId}

Imagem.

acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

Instância.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

Par de chaves.

acs:ecs:{#regionId}:{#accountId}:keypair/{#keypairId}

Modelo de execução.

acs:ecs:{#regionId}:{#accountId}:launchtemplate/{#launchtemplateId}

ReservedInstance.

acs:ecs:{#regionId}:{#accountId}:reservedinstance/{#reservedinstanceId}

Grupo de segurança.

acs:ecs:{#regionId}:{#accountId}:securitygroup/{#securitygroupId}

Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId}

AutoSnapshotPolicy.

acs:ecs:{#regionId}:{#accountId}:snapshotpolicy/{#SnapshotPolicyId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região dos recursos. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ResourceType	string	Sim	O tipo do recurso. Valores válidos: instance: instância ECS. disk: disco em nuvem. snapshot: snapshot. image: imagem. securitygroup: grupo de segurança. volume: volume de armazenamento. eni: Elastic Network Interface (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 de snapshot automático. elasticityassurance: garantia de elasticidade. capacityreservation: reserva de capacidade. command: comando do Cloud Assistant. invocation: execução de comando do Cloud Assistant ou resultado de envio de arquivo. activation: código de ativação de instância gerenciada do Cloud Assistant. managedinstance: instância gerenciada do Cloud Assistant.	instance
ResourceId	array	Sim	A lista de IDs de recursos. Comprimento do array: 1 a 50.	i-bp67acfmxazb4ph****
	string	Não	O ID do recurso.	r-XXX
Tag	array<object>	Sim	As tags. Comprimento do array: 1 a 20. Se o array contiver vários objetos de tag, a chave da tag deve ser única.
	object	Não	O objeto de tag.
Key	string	Sim	A chave da tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. A chave da tag não pode conter http:// ou https://.	TestKey
Value	string	Sim	O valor da tag. O valor da tag não pode ser nulo, mas pode ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://.	TestValue

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	NumberExceed.ResourceIds	The ResourceIds parameter's number is exceed , Valid : 50.	O parâmetro ResourceIds não pode conter mais de 50 valores de ResourceId.
400	NumberExceed.Tags	The Tags parameter's number is exceed , Valid : 20.	O número de tags excede o limite máximo. Você pode especificar até 20 tags para esta operação.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Existem chaves duplicadas nas tags. Certifique-se de que todas as chaves sejam únicas.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	O parâmetro de chave de tag especificado é inválido.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	O parâmetro de valor de tag especificado é inválido.
400	OperationDenied.QuotaExceed	The quota of tags on resource is beyond permitted range.
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	O Tag.N.Key e o Tag.N.Value especificados não correspondem.
400	InvalidTagCount	The specified tags are beyond the permitted range.	A tag especificada está fora do intervalo válido.
400	Invalid.Scope	The specified scope is invalid.
500	ServiceUnavailable	The service is unavailable, please try again later.	A solicitação de backend expirou. Tente novamente mais tarde.
403	PermissionDenied.TagOwnerBid	The specified operator not have permission to set TagOwnerBid value.
403	PermissionDenied.TagOwnerUid	The specified operator not have permission to set TagOwnerUid value.	Você não tem permissão para definir o proprietário da tag.
403	PermissionDenied.Scope	The specified operator not have permission to set Scope value.	O operador especificado não tem permissão para definir o valor do escopo.
403	InvalidResourceId.NotSupported	The specified ResourceId does not support tagging.
403	NoPermissionKey.Scope	%s
403	NoPermission.Tag	The operator is not permission for the tag.	Você não tem permissão para gerenciar tags neste recurso.
403	QuotaExceed.Tags	%s	O número de tags excede o número máximo que pode ser configurado. %s é uma variável. A mensagem de erro real é retornada dinamicamente com base na chamada de API.
403	TagKey.Duplication	The TagKey has duplication with others, case-insensitive.	O parâmetro Tag.N.Key contém valores duplicados. Este parâmetro não diferencia maiúsculas de minúsculas. Verifique se valores duplicados foram especificados.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	O RegionId especificado não existe. Verifique se o produto está disponível nesta região.
404	MissingParameter.ResourceIds	The parameter - ResourceIds.N should not be null.
404	MissingParameter.TagOwnerUid	The parameter - TagOwnerUid should not be null.
404	MissingParameter.TagOwnerBid	The parameter - TagOwnerBid should not be null.
404	MissingParameter.ResourceType	The parameter - ResourceType should not be null.	O parâmetro ResourceType não pode estar vazio.
404	MissingParameter.Tags	The parameter - Tags should not be null.
404	MissingParameter.RegionId	The parameter - RegionId should not be null.	O parâmetro RegionId não pode estar vazio.
404	InvalidResourceId.NotFound	The specified ResourceIds are not found in our records.	O recurso especificado não existe. Verifique se o recurso está correto.
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	O tipo de recurso especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.