すべてのプロダクト
Search
ドキュメントセンター

Modify a scheduled task

最終更新日: Mar 18, 2020

説明

スケジュール済みタスクの属性を変更します。

リクエストパラメーター

名前 必須かどうか 説明
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

リクエストの例

  1. http://ess.aliyuncs.com/?Action=ModifyScheduledTask
  2. &ScheduledTaskId=edRtShc57WGXdt8TlPbrjsnV
  3. &LaunchTime=2014-08-18T10:52Z
  4. &RecurrenceEndTime=2014-08-20T16:55Z
  5. &<Public Request Parameters>

戻り値の例

XML の例

  1. <ModifyScheduledTaskResponse>
  2. <RequestId>F9372E8D-C163-471F-BEB4-3A02B3CE176E</RequestId>
  3. </ModifyScheduledTaskResponse>

JSON 形式

  1. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"