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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte Cabeçalhos de requisição comuns.

Sintaxe da requisição

POST /openapi/tags HTTP/1.1

Parâmetros da requisição

Parâmetro	Tipo	Posição	Obrigatório	Exemplo	Descrição
	Object	Body	Não		Informações sobre os clusters e as tags.
ResourceIds	Array of String	Body	Sim	["es-cn-aaa","es-cn-bbb"]	IDs dos recursos. Especifique os IDs em um array JSON. Limite: 20 IDs.
Tags	Array	Body	Sim		Tags da instância. Limite: 20 tags.
key	String	Body	Sim	env	Chave da tag.
value	String	Body	Sim	IT	Valor da tag.
ResourceType	String	Body	Sim	INSTANCE	Tipo de recurso. Defina como INSTANCE.

Nota

Ao configurar o parâmetro key, configure também o parâmetro value. Caso contrário, o sistema retorna o erro InvalidParameter.TagKey. O parâmetro value aceita uma string vazia.
A especificação de pares chave-valor duplicados resulta no erro Duplicate.TagKey.
Se a chave da tag já existir, o novo valor substituirá o valor atual.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Result

Boolean

true

Indica se as tags foram adicionadas aos clusters. Valores válidos:

true
false

RequestId

String

3D8795D9-8FF5-46B2-86E6-E3B407*******

ID da requisição.

Exemplos

Exemplos de requisições

POST /openapi/tags HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json

{
    "ResourceIds":["es-cn-oew1q8bev0002****","es-cn-09k1ptccp0009****"],
    "Tags": [
        {
            "key": "env",
            "value": "IT"
        }
    ],
    "ResourceType": "INSTANCE"
}

Exemplos de respostas de sucesso

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Result" : true,
  "RequestId" : "27627E6B-E26A-406F-B6E1-0247882C****"
}

Código de status HTTP

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