調(diào)用ModifyInstanceMaintainTime，更改并開啟實例的可維護時間。
調(diào)用此接口前，請注意：
- 在進行正式維護前，阿里云會給您阿里云賬號中設(shè)置的聯(lián)系人發(fā)送短信和郵件，請注意查收。
- 實例維護當(dāng)天，為保障整個維護過程的穩(wěn)定性，實例會在可維護時間段之前進入生效中的狀態(tài)。當(dāng)實例處于該狀態(tài)時，對集群的訪問以及查詢類操作（如性能監(jiān)控）不會受到影響，但相關(guān)集群變更操作（如集群升配、重啟等）均暫時無法使用。
- 在可維護時間段內(nèi)，實例連接可能發(fā)生閃斷，請確保應(yīng)用程序具有重連機制。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求頭
該接口使用公共請求頭，無特殊請求頭。請參見公共請求參數(shù)文檔。
請求語法
POST /openapi/instances/{InstanceId}/actions/modify-maintaintime HTTP/1.1請求參數(shù)
| 名稱 | 類型 | 位置 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|---|
| InstanceId | String | Path | 是 | es-cn-n6w1o1x0w001c**** |
實例ID。 |
| ClientToken | String | Query | 否 | 5A2CFF0E-5718-45B5-9D4D-70B3FF**** |
用于保證請求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請求間唯一，最大不超過64個ASCII字符。 |
| String | Body | 否 | { "openMaintainTime": true, "maintainStartTime": "03:00Z", "maintainEndTime": "04:00Z" } |
請求體參數(shù)，詳情請參見下文的RequestBody章節(jié)。 |
RequestBody
RequestBody中還需填入以下參數(shù)，用來指定可維護時間段信息。
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
|---|---|---|---|---|
|
maintainStartTime |
String |
否 |
02:00Z |
可維護時間段的開始時間，格式：HH:mmZ（UTC時間）。 |
|
maintainEndTime |
String |
否 |
06:00Z |
可維護時間段的結(jié)束時間，格式：HH:mmZ（UTC時間）。 |
|
openMaintainTime |
boolean |
是 |
true |
是否開啟可維護時間段功能。僅支持true，表示開啟。 |
示例如下。
{
"openMaintainTime": true,
"maintainStartTime": "03:00Z",
"maintainEndTime": "04:00Z"
}
返回數(shù)據(jù)
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| Result | Boolean | true |
返回結(jié)果。 |
| 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****"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。