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

Adiciona tags aos recursos de vários serviços da Alibaba Cloud.

Descrição da operação

As tags são usadas para identificar recursos. As tags permitem categorizar, pesquisar e agregar recursos que possuem as mesmas características a partir de diferentes dimensões. Isso facilita o gerenciamento de recursos. Para obter mais informações, consulte Visão geral das tags.

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

update

*All Resource

*

Nenhuma

*:TagResources
vod:TagVodResources
dcdn:TagDcdnResources
ecs:AddTags
rds:AddTagsToResource
slb:AddTags
oss:PutBucketTagging
live:TagLiveResources

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 de forma centralizada, defina o valor como `cn-hangzhou` ou como o ID da região dos recursos consultando Regiões suportadas por operações relacionadas a tags em recursos de serviços da Alibaba Cloud implantados de forma centralizada. Se os recursos pertencerem a um serviço que não é implantado de forma centralizada, 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 de forma centralizada, defina o valor como `cn-hangzhou` ou como o ID da região dos recursos consultando Regiões suportadas por operações relacionadas a tags em recursos de serviços da Alibaba Cloud implantados de forma centralizada. Se os recursos pertencerem a um serviço que não é implantado de forma centralizada, defina o valor como o ID da região dos recursos.	cn-hangzhou
Tags	string	Sim	Os pares chave-valor das tags. Você pode especificar de 1 a 10 pares chave-valor. Se você especificar várias tags, o sistema adicionará todas as tags aos recursos especificados. Limites: Uma chave de tag deve ter de 1 a 128 caracteres de comprimento. Um valor de tag deve ter de 1 a 128 caracteres de comprimento. As chaves e os valores das tags diferenciam maiúsculas de minúsculas. Cada chave de tag em um recurso pode ter apenas um valor de tag. Se você criar uma tag que tenha a mesma chave de uma tag existente, o valor da tag existente será substituído.	{"k1":"v1","k2":"v2"}
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 atual da Alibaba Cloud. `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**

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.	72086426-9F8C-4A60-852B-864048FD1199
FailedResources	object
FailedResource	array<object>	As informações sobre os recursos aos quais as tags não puderam ser adicionadas. Nota Se as tags forem adicionadas a todos os recursos, o valor de `FailedResources` estará vazio. Se as tags não puderem ser adicionadas a alguns ou a todos os recursos, o valor de `FailedResources` conterá as informações detalhadas sobre os recursos.
	array<object>	As informações dos recursos aos quais as tags não puderam ser adicionadas.
ResourceARN	string	The ARN of the resource.	arn:acs:vpc:cn-hangzhou:123456789**:vpc/vpc-bp19dd90tkt6tz7wu**
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": "72086426-9F8C-4A60-852B-864048FD1199",
  "FailedResources": {
    "FailedResource": [
      {
        "ResourceARN": "arn:acs:vpc:cn-hangzhou:123456789****:vpc/vpc-bp19dd90tkt6tz7wu****",
        "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.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	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	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
400	InvalidParameter.Tags	The Tags parameter cannot be empty, and JSON parsing should adhere to the format of a Map.
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	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.
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.