この操作では、1つ以上のインスタンスのメンテナンスプロパティを変更できます。

説明

この操作は、インスタンスのメンテナンスポリシーを変更するために使用されます。 メンテナンスポリシーは、次のメンテナンスプロパティで構成されます。

  • メンテナンスウィンドウ: メンテナンスに指定した期間。
  • メンテナンスアクション: インスタンスのシャットダウンに応じて指定するポリシー。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 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時間後でなければなりません。 時刻をHH:mm:ss形式で指定します。 時刻はUTC + 8でなければなりません。 Nの値を1に設定します。

MaintenanceWindow.N.EndTime String 任意 18:00:00

メンテナンスウィンドウの終了時間N. 時間はちょうど0分と0秒の時間でなければなりません。 MaintenanceWindow.N.StartTimeパラメーターとMaintenanceWindow.N.EndTimeパラメーターを同時に指定する必要があります。 MaintenanceWindow.N.Endtimeの値は、MaintenanceWindow.N.StartTimeの値より1 ~ 23時間後でなければなりません。 時刻をHH:mm:ss形式で指定します。 時刻はUTC + 8でなければなりません。 Nの値を1に設定します。

ActionOnMaintenance String 任意 自動回復

メンテナンスアクション。 設定可能な値は以下のとおりです。

  • Stop: インスタンスを停止します。
  • AutoRecover: インスタンスを自動的に回復します。
  • AutoRedeploy: インスタンスが失敗します。これにより、インスタンスに接続されているデータディスクが破損する可能性があります。
NotifyOnMaintenance Boolean 任意 false

インスタンスのシャットダウン前にイベント通知を送信するかどうかを指定します。 設定可能な値は以下のとおりです。

  • True: イベント通知を送信します。
  • 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 エラーセンター」をご参照ください。