Todos os produtos
Search
Central de documentação

Elasticsearch:EstimatedRestartTime

Última atualização: Jul 02, 2026

Obtém o tempo estimado necessário para reiniciar um cluster Elasticsearch.

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.

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/instances/{InstanceId}/estimated-time/restart-time HTTP/1.1

Parâmetros da requisição

Parâmetro

Tipo

Posição

Obrigatório

Exemplo

Descrição

InstanceId

String

Path

Sim

es-cn-n6w1o1x0w001c****

O ID da instância.

force

Boolean

Query

Não

false

Defina se o cluster deve ser reiniciado forçadamente. Valor padrão: false.

String

Body

Não

{ "restartType":"nodeIp", "nodes": ["172.16.xx.xx"], "blueGreenDep":true }

Especifique as informações dos parâmetros de reinicialização.

RequestBody

Configure os seguintes parâmetros no corpo da requisição para especificar as informações sobre a reinicialização.

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

restartType

String

Não

instance

O tipo de reinicialização. Tipos suportados:

instance: reinicia a instância. Este é o valor padrão.

nodeIp: o nó é reiniciado.

nodes

List<String>

Não

["127.0.0.1"]

Selecione a lista de endereços IP do nó alvo quando o nó for reiniciado.

blueGreenDep

Boolean

Não

false

Defina se uma alteração blue-green deve ser executada durante a reinicialização do nó. Valor padrão: false

batch

double

Não

25.0

A concorrência da reinicialização da instância. O valor padrão deste parâmetro é 1 dividido pelo número total de nós no cluster.

batchUnit

String

Não

percent

A unidade do lote. Valor padrão: percent.

Nota
  • Se você definir o parâmetro restartType como instance, não será necessário configurar o parâmetro blueGreenDep.

    • Caso defina o parâmetro force como true, defina o parâmetro batch com um valor maior que 0 e menor ou igual a 100. Caso contrário, o sistema retornará o erro RestartBatchValueError.

    • Quando o parâmetro force for definido como false, o valor padrão do parâmetro batch será 0. Se você definir o parâmetro batch com um valor diferente de 0, o sistema retornará o erro NormalRestartNotSupportBatch.

  • Ao definir o parâmetro restartType como nodeIp, não é preciso configurar o parâmetro batch.

    • Se o parâmetro nodes não estiver configurado, o sistema retornará um erro de configuração de parâmetro.

    • Definir o parâmetro blueGreenDep como true faz com que o sistema execute uma reinicialização blue-green. Definir o parâmetro blueGreenDep como false resulta em uma reinicialização normal.

Exemplo de instrução:


{
    "restartType":"nodeIp",
    "nodes": ["172.16.xx.xx"],
    "blueGreenDep":true
}

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

O ID da requisição.

Result

Object

O resultado retornado.

unit

String

second

A unidade.

value

Long

50

O tempo estimado de reinicialização.

Exemplos

Exemplos de requisições

POST /openapi/instances/es-cn-n6w1o1x0w001c****/estimated-time/restart-time?force=true HTTP/1.1
Common request header

Exemplos de respostas de sucesso

Formato JSON

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

{
  "Result" : {
    "unit" : "second",
    "value" : 4200
  },
  "RequestId" : "7ACE8751-DD1B-40DB-A253-9080CA58****"
}

Código de status HTTP

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