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

Desvincula tags de recursos ECS especificados. Após uma tag ser desvinculada, ela é excluída automaticamente se não estiver vinculada a nenhum outro recurso.

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:UntagResources

delete

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}

ReservedInstance.

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

Grupo de segurança.

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

Snapshot.

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

Modelo de execução.

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

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: resultado da execução do comando do Cloud Assistant.	instance
All	boolean	Não	Especifica se todas as tags devem ser desvinculadas dos recursos. Este parâmetro só entra em vigor quando TagKey.N não é especificado na solicitação. Valores válidos: true false Valor padrão: false.	false
ResourceId	array	Sim	A lista de IDs de recursos. Você pode especificar até 50 IDs de recursos.	i-bp67acfmxazb4ph****
	string	Não	O ID do recurso.	i-bp67acfmxazb4ph****
TagKey	array	Não	A lista de chaves de tag dos recursos. Você pode especificar até 20 chaves de tag.	TestKey
	string	Não	A chave de tag do recurso.	TestKey

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	C46FF5A8-C5F0-4024-8262-B16B639225A0

Exemplos

Resposta de sucesso

JSON formato

{
  "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	NumberExceed.ResourceIds	The ResourceIds parameter's number is exceed , Valid : 50
400	NumberExceed.Tags	The Tags parameter's number is exceed , Valid : 20
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.
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	Param.Conflict	The specified all is true, but the specified TagKey.N is not empty.
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	O parâmetro TagOwnerUid não pode estar vazio.
404	MissingParameter.TagOwnerBid	The parameter - TagOwnerBid should not be null	O parâmetro TagOwnerBid não pode estar vazio.
404	MissingParameter.ResourceType	The parameter - ResourceType should not be null
404	MissingParameter.Tags	The parameter - Tags should not be null	O parâmetro Tags não pode estar vazio.
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.