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

Antes de chamar esta operação, observe os seguintes pontos:

O sistema envia mensagens de texto e e-mails aos contatos listados na sua conta Alibaba Cloud antes da manutenção.
No dia da manutenção da instância, ela entra no estado Active antes do início da janela de manutenção para garantir a estabilidade do processo. Nesse estado, você ainda pode acessar o cluster e executar operações de consulta, como monitoramento de desempenho. No entanto, não é possível realizar operações de modificação, como reinicialização e atualizações de configuração.
A conexão com a instância pode ser interrompida durante a janela de manutenção. Certifique-se de que sua aplicação tenha um mecanismo de reconexão.

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}/actions/modify-maintaintime HTTP/1.1

Parâmetros da requisição

Parâmetro	Tipo	Localização	Obrigatório	Exemplo	Descrição
InstanceId	String	Path	Sim	es-cn-n6w1o1x0w001c****	O ID da instância.
ClientToken	String	Query	Não	5A2CFF0E-5718-45B5-9D4D-70B3FF****	Token de cliente usado para garantir a idempotência da requisição. Use o cliente para gerar o valor, mas garanta que ele seja único entre diferentes requisições. O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres.
	String	Body	Não	{ "openMaintainTime": true, "maintainStartTime": "03:00Z", "maintainEndTime": "04:00Z" }	Parâmetros do corpo da requisição. Para mais informações, consulte a seção RequestBody.

RequestBody

Especifique os seguintes parâmetros no RequestBody para configure a janela de manutenção.

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
maintainStartTime	String	Não	02:00Z	Hora de início da janela de manutenção. Especifique a hora no formato HH:mmZ. A hora deve estar em UTC.
maintainEndTime	String	Não	06:00Z	Hora de término da janela de manutenção. Especifique a hora no formato HH:mmZ. A hora deve estar em UTC.
openMaintainTime	boolean	Sim	true	Define se a janela de manutenção deve ser ativada. Apenas true é suportado.

Exemplo:


{
    "openMaintainTime": true,
    "maintainStartTime": "03:00Z",
    "maintainEndTime": "04:00Z"
}

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
Result	Boolean	true	O resultado retornado.
RequestId	String	5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****	O ID da requisição.

Exemplos

Exemplos de requisições

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/modify-maintaintime?ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF**** HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
{
    "openMaintainTime": true,
    "maintainStartTime": "03:00Z",
    "maintainEndTime": "04:00Z"
}

Exemplos de respostas de sucesso

Formato JSON

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

{
  "Result" : true,
  "RequestId" : "8577468C-D13F-4980-BD71-977F9D82****"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.