O&M ウィンドウを照会します。
操作説明
設定済みのメンテナンスポリシーを照会します。各ポリシーには 2 つのメンテナンスプロパティが含まれます:
メンテナンスタイムウィンドウ: O&M オペレーションが実行される期間として指定する時間帯。
メンテナンス操作: 指定するインスタンス停止処理ポリシー。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ecs:DescribePlanMaintenanceWindows |
list |
*All Resource
|
なし | なし |
リクエスト構文
GET HTTP/1.1リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Enable |
boolean |
任意 |
ウィンドウが有効か無効かを指定します。 |
true |
| RegionId |
string |
必須 |
インスタンスのリージョン ID。DescribeRegions を呼び出して最新のリージョンリストをクエリできます。 |
cn-hangzhou |
| PlanWindowId |
string |
任意 |
O&M ウィンドウの ID。 |
pw-bp1jarob1aup7yvlrdt6 |
| PlanWindowName |
string |
任意 |
O&M ウィンドウの名前。 |
WIndowName |
| TargetResourceGroupId |
string |
任意 |
O&M ウィンドウが適用されるリソースグループの ID。 |
rg-d85g5yocioezmdrll |
| TargetResourceTags |
object |
任意 |
O&M ウィンドウが適用されるタグ。 |
|
| Value |
string |
任意 |
ウィンドウが適用されるタグのタグ値。 |
tagValue |
| Key |
string |
任意 |
ウィンドウが適用されるタグのタグキー。 |
tagKey |
| NextToken |
string |
任意 |
ページネーショントークン。このパラメーターには、前回の API 呼び出しで返された NextToken の値を設定します。 |
AAAAAdDWBF2 |
| MaxResults |
integer |
任意 |
ページングクエリの 1 ページあたりのエントリ数。最大値: 100。デフォルト値: 値が指定されていないか 10 未満の場合、デフォルト値は 10 です。値が 100 を超える場合、デフォルト値は 100 です。 |
10 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスのスキーマ。 |
||
| TotalCount |
integer |
クエリ条件に一致するエントリの総数。このパラメーターはオプションであり、デフォルトでは返されない場合があります。 |
1 |
| RequestId |
string |
リクエスト ID |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
| PlanMaintenanceWindowList |
array<object> |
作成時間。 |
|
|
array<object> |
ターゲットタイプ。有効な値:
|
||
| PlanWindowId |
string |
O&M ウィンドウの ID。 |
pw-bp1bqkbjb7h4j8zqzwvp |
| PlanWindowName |
string |
O&M ウィンドウの名前。 |
WindowName |
| Enable |
boolean |
O&M ウィンドウが有効かどうかを示します。 |
true |
| SupportMaintenanceAction |
string |
サポートされるメンテナンス操作。 |
Reboot |
| CreateTime |
string |
O&M ウィンドウが作成された時間。 時間は協定世界時 (UTC) の ISO 8601 標準に従います。形式: yyyy-MM-ddTHH:mm:ssZ。 |
2025-04-11T02:20:41Z |
| ModifiedTime |
string |
O&M ウィンドウが最後に変更済みとなった時間。 時間は協定世界時 (UTC) の ISO 8601 標準に従います。形式: yyyy-MM-ddTHH:mm:ssZ。 |
2025-02-22 10:14:28 +0800 |
| TimePeriod |
object |
ウィンドウの繰り返し頻度サイクル。 |
|
| PeriodUnit |
string |
繰り返し頻度。有効値：Daily および Weekly。 |
Year |
| RangeList |
array<object> |
メンテナンスウィンドウの繰り返される協定世界時 (UTC) の時間範囲。 |
|
|
object |
|||
| StartTime |
string |
時間範囲の開始時刻。 |
Monday,22:00 |
| EndTime |
string |
時間範囲の終了時刻。 |
Monday,22:00 |
| TargetResource |
object |
O&M ウィンドウが適用されるリソース。 |
|
| Scope |
string |
ターゲットリソースの範囲。有効値：Tag、ResourceGroup、Instance、および AliUid。 |
Tag |
| ResourceGroupId |
string |
ターゲットリソースグループの ID。 |
rg-aek2qxeteo7fr6y |
| Tags |
array<object> |
ターゲットタグ。 |
|
|
object |
|||
| Key |
string |
タグキー。 |
tagKey |
| Value |
string |
タグ値。 |
tagValue |
| MinMaintenanceInterval |
integer |
||
| NextToken |
string |
この呼び出しによって返されたクエリトークン |
AAAAAdDWBF2 |
| MaxResults |
integer |
ページングクエリの 1 ページあたりのエントリ数。最大値: 100。デフォルト値: 値が指定されていないか 10 未満の場合、デフォルト値は 10 です。値が 100 を超える場合、デフォルト値は 100 です。 |
10 |
例
成功レスポンス
JSONJSON
{
"TotalCount": 1,
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"PlanMaintenanceWindowList": [
{
"PlanWindowId": "pw-bp1bqkbjb7h4j8zqzwvp",
"PlanWindowName": "WindowName",
"Enable": true,
"SupportMaintenanceAction": "Reboot",
"CreateTime": "2025-04-11T02:20:41Z",
"ModifiedTime": "2025-02-22 10:14:28 +0800",
"TimePeriod": {
"PeriodUnit": "Year",
"RangeList": [
{
"StartTime": "Monday,22:00",
"EndTime": "Monday,22:00"
}
]
},
"TargetResource": {
"Scope": "Tag",
"ResourceGroupId": "rg-aek2qxeteo7fr6y",
"Tags": [
{
"Key": "tagKey",
"Value": "tagValue"
}
]
}
}
],
"NextToken": "AAAAAdDWBF2",
"MaxResults": 10
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 500 | InternalError | Internal error. | |
| 403 | AccessForbidden | User not authorized to operate on the specified resource. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。