Todos os produtos
Search
Central de documentação

Elasticsearch:DeactivateZones

Última atualização: Jun 27, 2026

Chame a operação DeactivateZones para desativar parte de uma zona quando houver várias zonas disponíveis. Migre os nós da zona desativada para outras zonas.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalho da requisição

Esta operação usa apenas parâmetros de requisição comuns. Para mais informações, consulte Parâmetros comuns.

Sintaxe da requisição

POST /openapi/instances/[InstanceId]/actions/down-zones HTTPS|HTTP

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

InstanceId

String

Sim

es-cn-n6w1o1x0w001c****

ID da instância.

clientToken

String

Não

5A2CFF0E-5718-45B5-9D4D-70B3FF****

Token exclusivo gerado pelo cliente para garantir a idempotência da requisição. Gere o valor no cliente e assegure que seja único entre diferentes requisições. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.

RequestBody

Especifique também os IDs das zonas no campo RequestBody. Exemplo:

["cn-hangzhou-i","cn-hangzhou-f"]

Parâmetros de resposta

ParâmetroTipoExemploDescrição
RequestIdStringF99407AB-2FA9-489E-A259-40CF6DCC****

ID da requisição.

ResultBooleantrue

Resultados retornados:

  • true: zona desativada com sucesso
  • false: falha ao desativar a zona

Exemplos

Exemplo de requisição

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/down-zones HTTP/1.1
Common request parameters
["cn-hangzhou-i","cn-hangzhou-f"]

Exemplo de resposta de sucesso

Formato JSON

{
    "Result": true,
    "RequestId": "5A5D8E74-565C-43DC-B031-29289FA****"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

InstanceNotFound

The instanceId provided does not exist.

Mensagem de erro retornada porque a instância especificada não foi encontrada. Verifique o status da instância.

Para obter uma lista de códigos de erro, visite a Central de Erros da API.