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

Observações de uso

Tags classificam instâncias. Cada tag consiste em um par chave-valor. Antes de usar tags, observe os seguintes limites:

Cada chave de tag adicionada a uma instância deve ser única.
Não é possível criar tags sem associá-las a instâncias. Todas as tags devem ser adicionadas a instâncias.
As informações de tags não são compartilhadas entre regiões.

Por exemplo, tags criadas na região China (Hangzhou) não ficam visíveis na região China (Xangai).
Virtual private clouds (VPCs), tabelas de rotas, vSwitches e endereços IP elásticos (EIPs) pertencentes à mesma conta Alibaba Cloud e implantados na mesma região compartilham informações de tags.

Por exemplo, ao adicionar uma tag a uma VPC, essa tag fica disponível para vSwitches, tabelas de rotas e EIPs da mesma conta implantados na mesma região da VPC. Selecione essa tag diretamente na página de edição, sem precisar inseri-la novamente. Modifique a chave e o valor de uma tag ou remova-a de uma instância. A exclusão de uma instância remove também todas as tags associadas a ela.
Cada instância aceita até 20 tags. O sistema verifica automaticamente a quantidade de tags existentes antes de adicionar uma nova. Uma mensagem de erro será retornada se o limite máximo for atingido.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
ResourceType	String	Sim	VPC	Tipo de recurso. Valores válidos: VPC: virtual private cloud (VPC) VSWITCH: vSwitch ROUTETABLE: tabela de rotas EIP: endereço IP elástico (EIP) VPNGATEWAY: gateway VPN NATGATEWAY: gateway NAT COMMONBANDWIDTHPACKAGE: plano de largura de banda de EIP PREFIXLIST: lista de prefixos PUBLICIPADDRESSPOOL: pool de endereços IP IPV4GATEWAY: gateway IPv4 IPV6GATEWAY: gateway IPv6 NETWORKACL: ACL de rede TRAFFICMIRRORFILTER: filtro de espelhamento de tráfego TRAFFICMIRRORSESSION: sessão de espelhamento de tráfego FLOWLOG: log de fluxo HAVIP: endereço IP virtual de alta disponibilidade (HAVIP) DHCPOPTIONSSET: conjunto de opções DHCP GATEWAYENDPOINT: endpoint de gateway Nota Os valores não diferenciam maiúsculas de minúsculas.
ResourceId.N	String	Não	vpc-bp16qjewdsunr41m1****	ID do recurso. Insira até 50 IDs. Nota Ao chamar esta operação, especifique ResourceId.N.
RegionId	String	Sim	cn-hangzhou	ID da região do recurso. Chame a operação DescribeRegions para consultar a lista mais recente de regiões.
Tag.N.Key	String	Não	FinanceDept	Chave da tag N a ser adicionada ao recurso. Insira pelo menos uma chave de tag e no máximo 20 chaves. A chave da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:`, nem conter `http://` ou `https://`. Nota Ao chamar esta operação, especifique Tag.N.Key e não use uma string vazia.
Tag.N.Value	String	Não	FinanceJoshua	Valor da tag N a ser adicionado ao recurso. Insira pelo menos um valor de tag e no máximo 20 valores. O valor da tag pode ter até 128 caracteres. Não pode começar com `aliyun` ou `acs:`, nem conter os caracteres `http://` ou `https://`. Nota Ao chamar esta operação, especifique Tag.N.Value. É permitido usar uma string vazia.
Action	String	Sim	TagResources	Operação a ser executada. Defina o valor como TagResources.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	C46FF5A8-C5F0-4024-8262-B16B639225A0	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?ResourceType=VPC
&ResourceId=["vpc-bp16qjewdsunr41m1****"]
&RegionId=cn-hangzhou
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Action=TagResources
&Common request parameters

Exemplos de respostas de sucesso

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

HttpCode	Código de erro	Mensagem de erro	Descrição
400	InvalidTagKey	The tag keys are not valid.	O índice da tag é inválido.
400	InvalidTagValue	The tag values are not valid.	O valor da tag é inválido.
400	InvalidInstanceType.NotFound	The instance type is not found	O tipo de instância não foi encontrado.
400	InvalidInstanceIds.NotFound	The instanceIds are not found	O ID da instância não foi encontrado.
400	Forbidden.TagKeys	The request do not allow to operate the tag keys	Você não tem permissão para especificar TagKeys.
400	QuotaExceeded.TagNum	Custom Tags quota exceeded	O limite máximo foi atingido.
400	InvalidTagScope.NotFound	The tag scope is not found	O escopo do recurso é inválido.
400	Forbidden.NotAllowedCategary	The System tag is not valid	A tag de sistema é inválida.
400	Forbidden.TagKeys	The request does not allow operate this tagkeys	Não é possível gerenciar a chave de tag chamando esta operação.
400	Forbidden.TagKey.Duplicated	The specified tag key already exists.	Os recursos de tag estão duplicados.
400	SizeLimitExceeded.TagNum	The maximum number of tags is exceeded.	A quantidade de tags atingiu o limite máximo.
400	SizeLimitExceeded.ResourceId	The maximum number of resource IDs is exceeded.	A quantidade de IDs de grupo de recursos atingiu o limite máximo.
400	MissingParameter.TagValue	The input parameter TagValue that is mandatory for processing this request is not supplied.	TagValue não foi especificado.
400	MissingParameter.TagKey	The input parameter TagKey that is mandatory for processing this request is not supplied.	TagKey não foi especificado.
400	MissingParam.Tags	You must specify the Tags parameter.	É obrigatório especificar Tags.
403	Forbidden	User not authorized to operate on the specified resource.	Você não tem autorização para executar esta operação no recurso especificado. Obtenha as permissões necessárias e tente novamente.

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