この操作では、1つ以上のインスタンスのメンテナンスプロパティを変更できます。
説明
この操作は、インスタンスのメンテナンスポリシーを変更するために使用されます。 メンテナンスポリシーは、次のメンテナンスプロパティで構成されます。
- メンテナンスウィンドウ: メンテナンスに指定した期間。
- メンテナンスアクション: インスタンスのシャットダウンに応じて指定するポリシー。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
操作 | String | 必須 | ModifyInstanceMaintenanceAttributes |
実行する操作です。 値をModifyInstanceMaintenanceAttributesに設定します。 |
RegionId | String | 必須 | cn-hangzhou |
インスタンスのリージョンID。 DescribeRegions を呼び出すと、最新のリージョンリストを照会できます。 |
<td class="en-UStry align-left colsep-1 rowsep-1"> InstanceId.N </td> | RepeatList | 任意 | i-bp67acfmxazb4ph **** |
インスタンスNのID。N: 1 ~ 100の有効値。 |
MaintenanceWindow.N.StartTime | String | 任意 | 02:00:00 |
メンテナンスウィンドウの開始時間N. 時間はちょうど0分と0秒の時間でなければなりません。 MaintenanceWindow.N.StartTimeパラメーターとMaintenanceWindow.N.EndTimeパラメーターを同時に指定する必要があります。
MaintenanceWindow.N.Endtimeの値は、MaintenanceWindow.N.StartTimeの値より1 ~ 23時間後でなければなりません。
時刻を |
MaintenanceWindow.N.EndTime | String | 任意 | 18:00:00 |
メンテナンスウィンドウの終了時間N. 時間はちょうど0分と0秒の時間でなければなりません。 MaintenanceWindow.N.StartTimeパラメーターとMaintenanceWindow.N.EndTimeパラメーターを同時に指定する必要があります。
MaintenanceWindow.N.Endtimeの値は、MaintenanceWindow.N.StartTimeの値より1 ~ 23時間後でなければなりません。
時刻を |
ActionOnMaintenance | String | 任意 | 自動回復 |
メンテナンスアクション。 設定可能な値は以下のとおりです。
|
NotifyOnMaintenance | Boolean | 任意 | false |
インスタンスのシャットダウン前にイベント通知を送信するかどうかを指定します。 設定可能な値は以下のとおりです。
規定値: false |
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
リクエストの ID です。 |
例
リクエストの例
https://ecs.aliyuncs.com? アクション=ModifyInstanceMaintenanceAttributes
&InstanceId.1=i-bp67acfmxazb4ph ****
&ActionOnMaintenance=AutoRecover
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<ModifyInstanceMaintenanceAttributesResponse>
<RequestId>E69FF3CC-94DD-42EF-8836-F33C45EDF9945ED</RequestId>
<ModifyInstanceMaintenanceAttributesResponse>
JSON
形式
{
"RequestId": "E69FF3CC-94DD-42EF-8836-F33C45EDF9945ED"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
404 | InvalidInstanceId.NotFound | %s | 指定されたインスタンスが存在しない場合に返されるエラーメッセージ。 |
403 | InvalidParameter | %s | 指定されたパラメーターが無効な場合に返されるエラーメッセージ。 |
403 | OperationDenied.NotInWhiteList | %s | 該当の操作を実行する権限がない場合に返されるエラーメッセージです。 許可されたらもう一度お試しください。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。