スケジュール済みタスクの変更
説明
スケジュール済みタスクの属性を変更します。
リクエストパラメーター
| 名前 | 型 | 必須かどうか | 説明 |
|---|---|---|---|
| Action | String | はい | 操作インターフェイス名、必須パラメーター。 値: ModifyScheduledTask。 |
| ScheduledTaskId | String | はい | スケジュール済みタスクの ID。 |
| ScheduledTaskName | String | いいえ | スケジュール済みタスクの表示名。2 ～ 40 文字で指定する必要があります (英語または中国語)。この名前は、数字、大文字/小文字の英字、または漢字で始まる必要があり、”_”、”-“、”.” を使用できます。 アカウント名は、同じリージョン内で一意です。このパラメーターを指定しない場合は、デフォルト値の ScheduledScalingTaskId が使用されます。 |
| Description | String | いいえ | スケジュール済みタスクの説明。2 ～ 200 文字で指定する必要があります。 |
| ScheduledAction | String | いいえ | スケジュール済みタスクがトリガーされたときに実行される操作。スケーリングルールの一意の ID を入力します。 |
| LaunchTime | String | いいえ | スケジュール済みタスクをトリガーする日時。 日付形式は ISO8601 標準、UTC 時刻を使用。YYYY-MM-DDThh:mmZ の形式。 RecurrenceType を指定した場合、この属性で指定した日時が、サイクルが実行されるデフォルトの日時になります。 RecurrenceType を指定しなかった場合、タスクは指定された日時に一度だけ実行されます。 作成または変更から 90 日以降の日時を入力することはできません。 |
| LaunchExpirationTime | Integer | いいえ | スケジュール済みタスクが失敗した場合のリトライ期間。 デフォルト値は 600 秒です。 値範囲: [0, 21600] |
| RecurrenceType | String | いいえ | タスクのスケジュールタイプ。 オプション値: Daily: スケジュール済みタスクを日単位で実行。 Weekly: スケジュール済みタスクを週単位で実行。 Monthly: スケジュール済みタスクを月単位で実行。 変更後、RecurrenceType、RecurrenceValue、および RecurrenceEndTime を同時に設定する必要があります。 |
| RecurrenceValue | String | いいえ | タスクのスケジュールタイプの値。 Daily: [1,31] の範囲で 1 つの値のみを入力できます。 Weekly: 複数の値を入力できます。日曜日～土曜日の値は、順番に 0 ～ 6 です。複数の値を指定するときは、カンマ “,” で区切る必要があります。 Monthly: A-B の形式で指定します。A と B の値の範囲は 1 ～ 31 で、B の値は A の値より大きくする必要があります。 変更後、RecurrenceType、RecurrenceValue、および RecurrenceEndTime を同時に設定する必要があります。 |
| RecurrenceEndTime | String | いいえ | スケジュール済みタスクの終了日時。日付形式は ISO8601 標準、UTC 時刻を使用。YYYY-MM-DDThh:mmZ の形式。 作成または変更から 90 日以降の日時を入力することはできません。 変更後、RecurrenceType、RecurrenceValue、および RecurrenceEndTime を同時に設定する必要があります。 |
| TaskEnabled | Bool | いいえ | スケジュール済みタスクを有効にするかどうかを指定します。 true に設定すると、タスクが有効になります。 false に設定すると、タスクが無効になります。 デフォルト値は true です。 |
リターンパラメーター
パブリックパラメーター。
エラーコード
すべてのインターフェイスに共通のエラーについては、「エラーコード表」の クライアントエラー または サーバエラーを参照してください。
| エラー | エラーコード | 説明 | HTTP ステータスコード |
|---|---|---|---|
| 指定したスケジュール済みタスクがアカウントに存在しません。 | InvalidScheduledTaskId.NotFound | 指定したスケジュール済みタスクが存在しません。 | 404 |
| このスケジュール済みタスク名は既に存在します。 | InvalidScheduledTaskName.Duplicate | 指定したパラメーター <parameter name> の値が重複しています。 |
400 |
| 指定したスケジュール済みアクションと指定したスケジュール済みタスクが同じリージョンにありません。 | ScheduledAction.RegionMismatch | 指定したスケジュール済みタスクと指定したスケジュール済みアクションが同じリージョンにありません。 | 400 |
例
リクエストの例
http://ess.aliyuncs.com/?Action=ModifyScheduledTask&ScheduledTaskId=edRtShc57WGXdt8TlPbrjsnV&LaunchTime=2014-08-18T10:52Z&RecurrenceEndTime=2014-08-20T16:55Z&<Public Request Parameters>
戻り値の例
XML の例
<ModifyScheduledTaskResponse><RequestId>F9372E8D-C163-471F-BEB4-3A02B3CE176E</RequestId></ModifyScheduledTaskResponse>
JSON 形式
"RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"