ModifyScheduledTask - Auto Scaling - Alibaba Cloud ドキュメントセンター

スケジュールされたタスクを変更します。既存のスケジュールされたタスクがビジネス要件を満たさない場合、ModifyScheduledTask API を呼び出して、実行するスケーリングルールやスケーリンググループの境界値などのパラメーター設定を調整できます。新しいスケジュールされたタスクを作成する必要はありません。この操作により、スケジュールされたタスクを柔軟に最適化できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ess:ModifyScheduledTask

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ScheduledTaskId	string	必須	スケジュールされたタスクの ID です。	edRtShc57WGXdt8TlPbr****
ScheduledTaskName	string	任意	スケジュールされたタスクの名前です。名前は 2～64 文字で、英字、数字、アンダースコア (_)、ハイフン (-)、ピリオド (.) を使用できます。英字または数字で始まる必要があります。スケジュールされたタスクの名前は、リージョンおよび Alibaba Cloud アカウント内で一意である必要があります。	scheduled****
Description	string	任意	スケジュールされたタスクの説明です。説明は 2～200 文字である必要があります。	Test scheduled task.
ScheduledAction	string	任意	スケジュールされたタスクがトリガーされたときに実行されるスケーリングルールです。スケーリングルールの ID を入力します。スケーリングルールの ID は、スケーリングルールの詳細ページで確認できます。`ScheduledAction` を指定する場合は、スケジュールされたタスクに既存のスケーリングルールを選択する必要があります。説明 `ScheduledAction` と `ScalingGroupId` の両方を同時に指定することはできません。	ari:acs:ess:cn-hangzhou:14069264**:scalingrule/asr-bp12tcnol686y1ik**
RecurrenceEndTime	string	任意	スケジュールされたタスクの終了時刻です。時刻は ISO 8601 形式 (YYYY-MM-DDThh:mmZ) で指定します。時刻は UTC で指定する必要があります。変更時点から 365 日後より先の日時は入力できません。	2014-08-20T16:55Z
LaunchTime	string	任意	スケジュールされたタスクがトリガーされる起動時刻です。時刻は ISO 8601 形式 (YYYY-MM-DDThh:mmZ) で指定します。時刻は UTC で指定する必要があります。変更時点から 90 日後より先の日時は入力できません。 `RecurrenceType` を指定した場合、タスクは `LaunchTime` で指定された時刻に繰り返し実行されます。 `RecurrenceType` を指定しない場合、タスクは `LaunchTime` で指定された時刻に 1 回だけ実行されます。	2014-08-18T10:52Z
RecurrenceType	string	任意	スケジュールされたタスクを繰り返す周期です。有効な値： `Daily`：スケジュールされたタスクは、指定された日数ごとに 1 回実行されます。 `Weekly`：スケジュールされたタスクは、指定された曜日ごとに実行されます。 `Monthly`：スケジュールされたタスクは、指定された日付ごとに実行されます。 `Cron`：スケジュールされたタスクは、指定された cron 式に基づいて実行されます。 `RecurrenceType` と `RecurrenceValue` に指定する値は、有効な組み合わせである必要があります。	Daily
RecurrenceValue	string	任意	スケジュールされたタスクの繰り返しパターンを定義する値です。 `RecurrenceType` を `Daily` に設定した場合、このパラメーターには 1 つの値のみを指定できます。有効な値：1～31。 `RecurrenceType` を `Weekly` に設定した場合、このパラメーターには複数の値を指定できます。値はコンマ (,) で区切ります。日曜日、月曜日、火曜日、水曜日、木曜日、金曜日、土曜日に対応する値は、それぞれ `0`、`1`、`2`、`3`、`4`、`5`、`6` です。 `RecurrenceType` を `Monthly` に設定した場合、このパラメーターには `A-B` 形式で 2 つの値を指定できます。A と B の有効な値は 1～31 です。B は A 以上である必要があります。 `RecurrenceType` を `Cron` に設定した場合、cron 式を指定できます。cron 式は UTC 時刻で記述され、分、時、日、月、週のフィールドで構成されます。式には、`L` と `W` の文字のほか、コンマ (`,`)、疑問符 (`?`)、ハイフン (`-`)、アスタリスク (`*`)、番号記号 (`#`)、スラッシュ (`/`) といったワイルドカード文字が使用できます。 `RecurrenceType` と `RecurrenceValue` に指定する値は、有効な組み合わせである必要があります。	2
TaskEnabled	boolean	任意	スケジュールされたタスクを有効にするかどうかを指定します。有効な値： `true` `false` デフォルト値：`true`。	true
LaunchExpirationTime	integer	任意	失敗したスケジュールされたタスクの再試行期間です。単位：秒。有効な値：0～1800。デフォルト値：600。	600
MinValue	integer	任意	`ScalingGroupId` パラメーターを指定する場合の、スケーリンググループ内のインスタンスの最小数です。	0
MaxValue	integer	任意	`ScalingGroupId` パラメーターを指定する場合の、スケーリンググループ内のインスタンスの最大数です。	10
DesiredCapacity	integer	任意	`ScalingGroupId` パラメーターを指定する場合の、スケーリンググループ内の希望する容量です。説明スケーリンググループを作成するときは、`DesiredCapacity` パラメーターを指定する必要があります。	10
ScalingGroupId	string	任意	スケジュールされたタスクがトリガーされたときにインスタンス数を変更する対象のスケーリンググループの ID です。スケジュールされたタスクに `ScalingGroupId` パラメーターを指定する場合は、スケジュールされたタスクでスケーリンググループの最小、最大、または希望するインスタンス数を指定する必要があります。つまり、`MinValue`、`MaxValue`、`DesiredCapacity` パラメーターのうち少なくとも 1 つを指定する必要があります。説明 `ScheduledAction` と `ScalingGroupId` パラメーターを同時に指定することはできません。	asg-bp18p2yfxow2dloq****
RegionId	string	任意	リージョン ID です。	cn-hangzhou

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエストの ID です。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	Throttling	Request was denied due to request throttling.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。