全部產品
Search
文件中心

Elasticsearch:ModifyInstanceMaintainTime

更新時間:Jan 16, 2025

調用ModifyInstanceMaintainTime,更改並開啟執行個體的可維護時間。

調用此介面前,請注意:

  • 在進行正式維護前,阿里雲會給您阿里雲帳號中設定的連絡人傳送簡訊和郵件,請注意查收。
  • 執行個體維護當天,為保障整個維護過程的穩定性,執行個體會在可維護時間段之前進入生效中的狀態。當執行個體處於該狀態時,對叢集的訪問以及查詢類操作(如效能監控)不會受到影響,但相關叢集變更操作(如叢集升配、重啟等)均暫時無法使用。
  • 在可維護時間段內,執行個體串連可能發生閃斷,請確保應用程式具有重連機制。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

要求標頭

該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。

請求文法

POST /openapi/instances/{InstanceId}/actions/modify-maintaintime HTTP/1.1

請求參數

名稱 類型 位置 是否必選 樣本值 描述
InstanceId String Path es-cn-n6w1o1x0w001c****

執行個體ID。

ClientToken String Query 5A2CFF0E-5718-45B5-9D4D-70B3FF****

用於保證請求的等冪性。由用戶端產生該參數值,要保證在不同請求間唯一,最大不超過64個ASCII字元。

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

請求體參數,詳情請參見下文的RequestBody章節。

RequestBody

RequestBody中還需填入以下參數,用來指定可維護時間段資訊。

名稱

類型

是否必選

樣本值

描述

maintainStartTime

String

02:00Z

可維護時間段的開始時間,格式:HH:mmZ(UTC時間)。

maintainEndTime

String

06:00Z

可維護時間段的結束時間,格式:HH:mmZ(UTC時間)。

openMaintainTime

boolean

true

是否開啟可維護時間段功能。僅支援true,表示開啟。

樣本如下。


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

返回資料

名稱 類型 樣本值 描述
Result Boolean true

返回結果。

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

請求ID。

樣本

請求樣本

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"
}

正常返回樣本

JSON格式

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

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。