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

Este tópico apresenta um exemplo de criação de tag e sua adição a um recurso em uma stack. Neste exemplo, o ID do recurso é 7fee80e1-8c48-4c2f-8300-0f6dc40b****, a chave da tag é FinanceDept e o valor da tag é FinanceJoshua.

Depuração

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

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	TagResources	A operação a ser executada. Defina o valor como TagResources.
RegionId	String	Sim	cn-hangzhou	O ID da região da tag. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
ResourceType	String	Sim	stack	O tipo de recurso ao qual adicionar a tag. Valores válidos: stack: stack stackgroup: grupo de stacks template: modelo templatescratch: cenário
ResourceId.N	String	Sim	7fee80e1-8c48-4c2f-8300-0f6dc40b****	O ID do recurso N. Especifique até 50 IDs de recursos. Nota Se definir o parâmetro ResourceType como stackgroup, use o nome do grupo de stacks como ID do recurso.
Tag.N.Key	String	Sim	FinanceDept	A chave da tag N a ser adicionada ao recurso. Especifique até 20 chaves de tag. A chave da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. Além disso, não pode começar com `aliyun` ou `acs:`.
Tag.N.Value	String	Sim	FinanceJoshua	O valor da tag N a ser adicionado ao recurso. Especifique até 20 valores de tag. O valor da tag pode ter até 128 caracteres e não pode conter `http://` ou `https://`. Além disso, não pode começar com `aliyun` ou `acs:`.

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

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

http(s)://ros.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=7fee80e1-8c48-4c2f-8300-0f6dc40b****
&ResourceType=stack
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&<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

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

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The specified parameter ResourceType is invalid, {reason}.	Mensagem de erro retornada quando o parâmetro ResourceType especificado é inválido. reason indica a causa do erro.
400	InvalidParameter	The specified parameter ResourceIds is invalid, {reason}.	Mensagem de erro retornada quando os IDs de recursos especificados não existem ou falham na validação. reason indica a causa do erro.
400	InvalidParameter	The specified parameter Tags is invalid, {reason}.	Mensagem de erro retornada quando o parâmetro Tag.N especificado é inválido. reason indica a causa do erro.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Mensagem de erro retornada quando a chave de tag especificada já existe. Especifique uma chave de tag exclusiva.