調用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****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。