Obtém o tempo estimado necessário para reiniciar um cluster Elasticsearch.
Depuração
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. |
-
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.