UntagResources - Resource Management: Central de Documentação do Alibaba Cloud

Remove tags dos recursos de vários serviços da Alibaba Cloud.

Descrição da operação

Após remover uma tag, a tag é excluída automaticamente em até 24 horas se não for adicionada a outros recursos.

Para obter informações sobre os serviços da Alibaba Cloud que suportam tags, consulte Serviços compatíveis com Tag.

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

tag:UntagResources

update

*All Resource

*

Nenhuma

*:UntagResources
*:UnTagResources
vod:UnTagVodResources
dcdn:UntagDcdnResources
ecs:RemoveTags
slb:RemoveTags
rds:RemoveTagsFromResource
oss:DeleteBucketTagging
live:UnTagLiveResources

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região. Se os recursos pertencerem a um serviço implantado centralmente, defina o valor como `cn-hangzhou` ou como o ID da região dos recursos consultando Regiões compatíveis com operações relacionadas a tags em recursos de serviços da Alibaba Cloud implantados centralmente. Se os recursos pertencerem a um serviço que não é implantado centralmente, defina o valor como o ID da região dos recursos.	cn-hangzhou
RegionId	string	Sim	O ID da região. Se os recursos pertencerem a um serviço implantado centralmente, defina o valor como `cn-hangzhou` ou como o ID da região dos recursos consultando Regiões compatíveis com operações relacionadas a tags em recursos de serviços da Alibaba Cloud implantados centralmente. Se os recursos pertencerem a um serviço que não é implantado centralmente, defina o valor como o ID da região dos recursos.	cn-hangzhou
ResourceARN	array	Sim	O Alibaba Cloud Resource Name (ARN) de um recurso.	arn:acs:vpc:cn-hangzhou:123456789**:vpc/vpc-bp19dd90tkt6tz7wu**
	string	Não	O ARN de um recurso. Valores válidos de N: 1 a 50. Formato: `arn:acs:${ProductCode}:${Region}:${Account}:${ResourceType}/${ResourceId}`. Campos: `ProductCode`: o código do serviço. Você pode definir este campo com um valor obtido na resposta da operação ListSupportResourceTypes. `Region`: o ID da região do recurso. Você pode definir este campo com um asterisco () para indicar a região atual. `Account`: o ID da conta da Alibaba Cloud à qual o recurso pertence. Você pode definir este campo com um asterisco () para indicar a conta da Alibaba Cloud atual. `ResourceType`: o tipo de recurso. Você pode definir este campo com um valor obtido na resposta da operação ListSupportResourceTypes. `ResourceId`: o ID do recurso. Nota Você pode definir `ProductCode` e `ResourceType` em ResourceARN com valores definidos no Resource Group, ActionTrail ou Resource Center.	arn:acs:vpc:cn-hangzhou:123456789**:vpc/vpc-bp19dd90tkt6tz7wu**
TagKey	array	Sim	A chave da tag N. Valores válidos de N: 1 a 10.	k1
	string	Não	A chave da tag N. Valores válidos de N: 1 a 10.	k1

Para obter mais informações sobre os parâmetros de solicitação comuns, consulte Parâmetros comuns.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O resultado retornado.
RequestId	string	O ID da solicitação.	43D12436-B10F-4469-8136-FD1C5D2B2083
FailedResources	object
FailedResource	array<object>	As informações sobre os recursos dos quais as tags não puderam ser removidas. Nota Se as tags forem removidas de todos os recursos, o valor de FailedResources estará vazio. Se as tags não puderem ser removidas de alguns ou de todos os recursos, o valor de FailedResources conterá as informações detalhadas sobre os recursos.
	array<object>	As informações dos recursos dos quais as tags não puderam ser removidas.
ResourceARN	string	The ARN of the resource.	arn:acs:ecs:cn-hangzhou:123456789****:instance/i-xxxxxxxxxx1
Result	object	The information about the error.
Code	string	The error code.	InvalidResourceId.NotFound
Message	string	The error message.	The specified ResourceIds are not found in our records.

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "43D12436-B10F-4469-8136-FD1C5D2B2083",
  "FailedResources": {
    "FailedResource": [
      {
        "ResourceARN": "arn:acs:ecs:cn-hangzhou:123456789****:instance/i-xxxxxxxxxx1",
        "Result": {
          "Code": "InvalidResourceId.NotFound",
          "Message": "The specified ResourceIds are not found in our records."
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidResourceARN.Account	The Account specified in the ResourceARN parameter does not match the actual account, specifically: %s.	The Account in the ResourceARN do not match the actual user, namely: %s
400	InvalidResourceARN.FormatError	The format of parameter ResourceARN: %s is not valid, for the correct format, you can refer to the Recommend.	The ResourceARN format does not conform to the specification. For the correct format, please refer
400	InvalidResourceARN.Region	The Region specified in the ResourceARN parameter does not match the RegionId parameter, specifically: %s.	The Region in the ResourceARN does not match the parameter RegionId. They are: %s
400	InvalidParameter.ResourceType	The parameter resource type: %s in ResourceARN is not valid or not support.	ResourceType in ResourceARN: %s is Illegal or unsupported.
400	InvalidParameter.ServiceCode	The parameter service code: %s in ResourceARN is not valid or not support.	ServiceCode in ResourceARN: %s is Illegal or unsupported.
400	InvalidParameter.TagKey	The TagKey parameter is invalid. The following TagKeys are invalid: %s.	Illegal tag keys exist in the parameter. Illegal tag keys are as follows: %s
400	InvalidParameter.TagValue	The TagValue parameter is invalid. The following TagValues are invalid: %s.	The parameter contains illegal tag values. Illegal tag values are as follows: %s
403	Duplicate.TagKey	The Tag.N.Key contains duplicate keys.	The Tag.N.Key contains duplicate keys.
403	InvalidParameter.Category	The specified Category is invalid. Valid values are Custom and System.	The specified Category is invalid. Valid values are Custom and System.
403	MissingParameter.Createby	You must specify Createby.	You must specify Createby.
403	MissingParameter.ResourceIds	You must specify ResourceIds.	You must specify ResourceIds.
403	NoPermission.Operator	The user is not authorized to operate on the specified resource.	The user is not authorized to operate on the specified resource.
403	NoPermission.SystemTag	The user does not have permission to operate the system tag.	The user does not have permission to operate the system tag.
403	NoPermissionKey.Category	Some keys cannot be modified because the user does not have permission.	Some keys cannot be modified because the user does not have permission.
403	NoPermissionKey.Operator	You are not authorized to operate the tag key.	You are not authorized to operate the tag key.
403	NumberExceed.ResourceIds	The maximum number of ResourceIds is exceeded.	The maximum number of ResourceIds is exceeded.
403	NumberExceed.Tags	The maximum number of Tags is exceeded.	The maximum number of Tags is exceeded.
403	QuotaExceed.TagsPerResource	The maximum number of tags for each resource is exceeded.	The maximum number of tags for each resource is exceeded.
403	Missing.ServiceCode	You must specify ServiceCode.	You must specify ServiceCode.
404	Missing.TagKey	Tag.N.Value has been specified and you must specify Tag.N.Key.	Tag.N.Value has been specified and you must specify Tag.N.Key.
404	MissingParameter.AliUid	You must specify AliUid.	You must specify AliUid.
404	MissingParameter.Bid	You must specify Bid.	You must specify Bid.
404	MissingParameter.TagKey	You must specify TagKey.	You must specify TagKey.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.