Elastic Compute Service:ModifyInvocationAttribute

リージョン ID。

変更対象のタスクのコマンド実行 ID。

変更済みのコマンド内容。コマンド内容はプレーンテキストまたは Base64 エンコーディングが可能です。以下の点にご注意ください。

• Base64 エンコーディング後のコマンド内容のサイズは 24 KB 以下である必要があります。

• コマンド内容が Base64 エンコーディングされている場合は、ContentEncoding=Base64 を設定する必要があります。

• EnableParameter=true を指定することで、コマンド内容でカスタムパラメーター特徴を有効にできます。

  • カスタムパラメーターは {{}} で囲んで定義します。{{}} 内のパラメーター名の前後にあるスペースや改行は無視されます。

  • カスタムパラメーターの数は 20 個を超えることはできません。

  • カスタムパラメーター名には a-zA-Z0-9-_ の文字を使用できます。組み込み以外の環境パラメーターを指定するための acs:: プレフィックスはサポートされていません。その他の文字も使用できません。パラメーター名は大文字と小文字が区別されません。

  • 1 つのカスタムパラメーター名は 64 バイト以下である必要があります。

• 組み込み環境パラメーターをカスタムパラメーターとして指定できます。コマンド実行時に手動で値を割り当てる必要はありません。クラウドアシスタントが自動的に環境内の対応する値に置き換えます。以下の組み込み環境パラメーターがサポートされています。

  • {{ACS::RegionId}}: リージョン ID。

  • {{ACS::AccountId}}: Alibaba Cloud アカウント ID。

  • {{ACS::InstanceId}}: インスタンス ID。コマンドが複数のインスタンスに送信される場合、{{ACS::InstanceId}} を組み込み環境パラメーターとして指定するには、クラウドアシスタントエージェントのバージョンが以下のバージョン以降であることを確認してください。

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

  • {{ACS::InstanceName}}: インスタンス名。コマンドが複数のインスタンスに送信される場合、{{ACS::InstanceName}} を組み込み環境パラメーターとして指定するには、クラウドアシスタントエージェントのバージョンが以下のバージョン以降であることを確認してください。

    • Linux: 2.2.3.344

    • Windows: 2.1.3.344

  • {{ACS::InvokeId}}: コマンド実行 ID。{{ACS::InvokeId}} を組み込み環境パラメーターとして指定するには、クラウドアシスタントエージェントのバージョンが以下のバージョン以降であることを確認してください。

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

  • {{ACS::CommandId}}: コマンド ID。この操作を呼び出してコマンドを実行する場合、{{ACS::CommandId}} を組み込み環境パラメーターとして指定するには、クラウドアシスタントエージェントのバージョンが以下のバージョン以降であることを確認してください。

    • Linux: 2.2.3.309

    • Windows: 2.1.3.309

変更済みのコマンドにカスタムパラメーターが含まれるかどうかを指定します。

• カスタムパラメーターを有効にする、またはカスタムパラメーター Parameters を変更する場合は、このパラメーターを true にセットします。

• カスタムパラメーター Parameters を変更しない場合は、このパラメーターを設定しないか、false にセットします。

コマンドにカスタムパラメーターが含まれる場合に変更済みにするカスタムパラメーターのキーと値のペア。

カスタムパラメーターの数は 0 ～ 10 です。以下の点にご注意ください。

• キーは空文字列にできず、最大 64 文字まで使用できます。

• 値は空文字列でも構いません。

• カスタムパラメーターと元のコマンド内容を Base64 エンコーディングした後、コマンド内容の合計サイズは 24 KB 以下である必要があります。

• カスタムパラメーター名のセットは、コマンド作成時に定義されたパラメーターセットのサブセットである必要があります。渡されないパラメーターについては、空文字列を代用として使用できます。

デフォルト値: 空。カスタムパラメーターのキーと値のペアが変更済みでないことを示します。

変更済みのスケジュール実行周波数。このパラメーターは RepeatMode が Period に設定されている場合にのみ効果があります。固定間隔実行（レート式に基づく）、指定時刻での 1 回限りの実行、時計ベースのスケジュール実行（Cron 式に基づく）の 3 種類のスケジュール実行がサポートされています。

• 固定間隔実行: レート式に基づき、指定された時間間隔でコマンドが実行されます。時間間隔は秒 (s)、分 (m)、時 (h)、日 (d) で指定できます。これは、タスクを固定間隔で実行するシナリオに適用されます。形式: rate(<間隔値><間隔単位>)。たとえば、5 分ごとに実行する場合は rate(5m) を使用します。固定間隔実行には以下の制限があります。

  • 時間間隔は 7 日を超えることはできず、60 秒未満にすることはできません。また、定期タスク作成時に指定されたタイムアウト期間より長くする必要があります。

  • 実行間隔は固定周波数のみに基づいており、タスク実行に必要な実際の時間とは関係ありません。たとえば、コマンドが 5 分ごとに実行されるように設定されており、タスクの完了に 2 分かかる場合、次の四捨五入の実行はタスク完了の 3 分後に開始されます。

  • 次の実行時間は、タスクの作成時間（DescribeInvocations が返す CreationTime を参照。変更時間ではないことに注意してください）と変更済みの実行間隔に基づいて計算されます。

• 指定時刻での 1 回限りの実行: 指定されたタイムゾーンおよび時刻ポイントにコマンドが 1 回実行されます。形式: at(yyyy-MM-dd HH:mm:ss <タイムゾーン>)、つまり at(年-月-日 時:分:秒 <タイムゾーン>) です。タイムゾーンが指定されていない場合、デフォルトは協定世界時 (UTC) です。タイムゾーンは以下の 3 つの形式をサポートしています。

  • フルタイムゾーン名: Asia/Shanghai（中国/上海時間）や America/Los_Angeles（米国/ロサンゼルス時間）など。

  • グリニッジ標準時からのタイムゾーンオフセット: GMT+8:00（東 8 番タイムゾーン）や GMT-7:00（西 7 番タイムゾーン）など。GMT 形式を使用する場合、時間の値に先行ゼロはサポートされていません。

  • タイムゾーン略語: UTC（協定世界時 (UTC)）のみがサポートされています。

  たとえば、2022 年 6 月 6 日の 13:15:30 に中国/上海時間で 1 回実行するには、at(2022-06-06 13:15:30 Asia/Shanghai) を使用します。2022 年 6 月 6 日の 13:15:30 に西 7 番タイムゾーンで 1 回実行するには、at(2022-06-06 13:15:30 GMT-7:00) を使用します。

• 時計ベースのスケジュール実行（Cron 式に基づく）: Cron 式に基づき、定期タスクの設定に従ってコマンドが実行されます。形式: <秒> <分> <時> <日> <月> <曜日> <年（オプション）> <タイムゾーン>、つまり <Cron 式> <タイムゾーン> です。定期タスクの実行時間は、指定されたタイムゾーンの Cron 式に基づいて計算されます。タイムゾーンが指定されていない場合、デフォルトは定期タスクを実行するインスタンスの内部システムタイムゾーンです。Cron 式の詳細については、「Cron 式」をご参照ください。タイムゾーンは以下の 3 つの形式をサポートしています。

  • フルタイムゾーン名: Asia/Shanghai（中国/上海時間）や America/Los_Angeles（米国/ロサンゼルス時間）など。

  • グリニッジ標準時からのタイムゾーンオフセット: GMT+8:00（東 8 番タイムゾーン）や GMT-7:00（西 7 番タイムゾーン）など。GMT 形式を使用する場合、時間の値に先行ゼロはサポートされていません。

  • タイムゾーン略語: UTC（協定世界時 (UTC)）のみがサポートされています。 たとえば、2022 年の毎日午前 10:15 に中国/上海時間で実行するには、0 15 10 ? * * 2022 Asia/Shanghai を使用します。2022 年の毎日午前 10:00 から午前 11:30 まで 30 分ごとに東 8 番タイムゾーンで実行するには、0 0/30 10-11 * * ? 2022 GMT+8:00 を使用します。2022 年から 2 年ごとの 10 月の毎日午後 2:00 から午後 2:55 まで 5 分ごとに協定世界時 (UTC) で実行するには、0 0/5 14 * 10 ? 2022/2 UTC を使用します。

  説明

  最小値の時間間隔は、定期タスク作成時に指定されたタイムアウト期間以上である必要があり、10 秒未満にすることはできません。

コマンド内容 (CommandContent) のエンコーディング方式。有効な値（大文字と小文字は区別されません）:

• PlainText: エンコーディングなし。内容はプレーンテキストで送信されます。

• Base64: Base64 エンコーディング。

デフォルト値: PlainText。無効な値が指定された場合、PlainText として扱われます。

リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken の値には ASCII 文字のみを使用でき、長さは 64 文字以下である必要があります。詳細については、「冪等性の確保方法」をご参照ください。