Elastic Compute Service:ModifyInvocationAttribute

リージョン ID。

リージョン ID。

コマンドの実行 ID。

変更後のコマンドの内容。コマンドの内容は、プレーンテキストまたは Base64 エンコード形式にすることができます。次の点にご注意ください：

• コマンド作成時に、コマンド実行後にコマンドを保持するかどうかを指定できます。コマンドを保持するように指定した場合、Base64 エンコードされたコマンドの内容は 18 KB を超えることはできません。コマンドを保持しないように指定した場合、Base64 エンコードされたコマンドの内容は 24 KB を超えることはできません。

• コマンドの内容が Base64 エンコードされている場合は、ContentEncoding を Base64 に設定します。

• EnableParameter を true に設定すると、カスタムパラメーター機能が有効になり、次のルールに基づいてカスタムパラメーターを設定できます：

  • カスタムパラメーターは {{}} 形式で定義できます。{{}} 内では、パラメーター名の前後のスペースと改行は無視されます。

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

  • カスタムパラメーター名には、文字、数字、アンダースコア (_)、ハイフン (-) を使用できます。名前は大文字と小文字を区別しません。ACS:: プレフィックスを使用して、組み込みでない環境パラメーターを指定することはできません。

  • 各カスタムパラメーター名の長さは 64 バイトを超えることはできません。

• 組み込み環境変数をカスタムパラメーターとして指定できます。その後、コマンドを実行すると、これらのパラメーターはクラウドアシスタントによって自動的に指定されます。次の組み込み環境変数を指定できます：

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

  • {{ACS::AccountId}}：Alibaba Cloud アカウントの UID。

  • {{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 を設定してコマンド内のカスタムパラメーターを変更する場合は、EnableParameter を true に設定します。

• Parameters を設定してコマンド内のカスタムパラメーターを変更しない場合は、EnableParameter を空のままにするか、false に設定します。

コマンドにカスタムパラメーターが含まれている場合に渡される、カスタムパラメーターのキーと値のペア。

0 から 10 個のカスタムパラメーターを指定できます。次の点にご注意ください：

• カスタムパラメーターのキーは最大 64 文字で、空の文字列にすることはできません。

• カスタムパラメーターの値は空の文字列にすることができます。

• コマンドタスクの作成時にコマンドを保持するように指定した場合、Base64 でエンコードされたカスタムパラメーターと元のコマンドコンテンツの合計サイズは 18 KB を超えることはできません。コマンドタスクの作成時にコマンドを保持しないように指定した場合、Base64 でエンコードされたカスタムパラメーターと元のコマンドコンテンツの合計サイズは 24 KB を超えることはできません。

• Parameters で指定されたカスタムパラメーター名は、コマンド作成時に指定したカスタムパラメーター名に含まれている必要があります。渡されないパラメーターを表すために空の文字列を使用できます。

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

コマンドを実行する頻度。このパラメーターは、RepeatMode が Period に設定されている場合にのみ有効です。レート式に基づいて固定間隔でコマンドを実行したり、特定の時点で一度だけ実行したり、cron 式に基づいて指定された時点で実行したりするように設定できます。

• 固定間隔でコマンドを実行するには、レート式を使用して間隔を指定します。間隔は秒、分、時間、または日で指定できます。このオプションは、固定間隔でタスクを実行する必要があるシナリオに適しています。間隔は次の形式で指定します：rate(<実行間隔の値> <実行間隔の単位>)。たとえば、5 分ごとにコマンドを実行するには rate(5m) を指定します。間隔を指定する際は、次の制限に注意してください：

  • 指定する間隔は 60 秒から 7 日の範囲内である必要があり、定期タスク作成時に指定したタイムアウト期間よりも長くする必要があります。

  • 間隔は、2 つの連続した実行の間に経過する時間です。間隔は、コマンドを 1 回実行するのに必要な時間とは無関係です。たとえば、間隔を 5 分に設定し、コマンドの実行に 2 分かかる場合、コマンドの実行が完了するたびに、システムは 5 分ではなく 3 分待ってからコマンドを再度実行します。

  • 次回コマンドが実行される時点は、タスクの作成時刻 (DescribeInvocations 操作によって返される CreationTime の値) と変更された実行間隔に基づいて計算されます。

• 特定の時間に一度だけコマンドを実行するには、時点とタイムゾーンを指定します。時点は at(yyyy-MM-dd HH:mm:ss <タイムゾーン>) 形式で指定します。これは at(年-月-日 時:分:秒 <タイムゾーン>) を意味します。タイムゾーンを指定しない場合、デフォルトで協定世界時 (UTC) タイムゾーンが使用されます。タイムゾーンは次の形式で指定できます：

  • タイムゾーン名。例：Asia/Shanghai および America/Los_Angeles。

  • GMT からの時刻オフセット。例：GMT+8:00 (UTC+8) および GMT-7:00 (UTC-7)。GMT 形式を使用する場合、時間の値に先行ゼロを追加することはできません。

  • タイムゾーンの略語。UTC のみサポートされています。

  たとえば、2022 年 6 月 6 日 13:15:30 (上海時間) に一度だけコマンドを実行するように設定するには、時刻を at(2022-06-06 13:15:30 Asia/Shanghai) に設定します。2022 年 6 月 6 日 13:15:30 (UTC-7) に一度だけコマンドを実行するように設定するには、時刻を at(2022-06-06 13:15:30 GMT-7:00) に設定します。

• 指定された時点でコマンドを実行するには、cron 式を使用してスケジュールを定義します。スケジュールは <Cron 式> <タイムゾーン> 形式で指定します。cron 式は <秒> <分> <時> <日> <月> <曜日> <年 (オプション)> 形式です。システムは、指定された cron 式とタイムゾーンに基づいてコマンドの実行時間を計算し、スケジュールどおりにコマンドを実行します。タイムゾーンを指定しない場合、デフォルトでコマンドを実行するインスタンスのシステムタイムゾーンが使用されます。cron 式の詳細については、「Cron 式」をご参照ください。タイムゾーンは次の形式で指定できます：

  • タイムゾーン名。例：Asia/Shanghai および America/Los_Angeles。

  • GMT からの時刻オフセット。例：GMT+8:00 (UTC+8) および GMT-7:00 (UTC-7)。GMT 形式を使用する場合、時間の値に先行ゼロを追加することはできません。

  • タイムゾーンの略語。UTC のみサポートされています。たとえば、2022 年に毎日 10:15:00 (上海時間) にコマンドを実行するように設定するには、スケジュールを 0 15 10 ? * * 2022 Asia/Shanghai に設定します。2022 年に毎日 10:00:00 から 11:30:00 まで 30 分ごとにコマンドを実行するように設定するには (UTC+8)、スケジュールを 0 0/30 10-11 * * ? 2022 GMT+8:00 に設定します。2022 年から 2 年ごとに 10 月に毎日 14:00:00 から 14:55:00 まで 5 分ごとにコマンドを実行するように設定するには (UTC)、スケジュールを 0 0/5 14 * 10 ? 2022/2 UTC に設定します。

  **

  注 最小間隔は 10 秒以上でなければならず、定期実行のタイムアウト期間より短くすることはできません。

CommandContent で指定されたコマンドコンテンツのエンコーディングモード。有効な値 (大文字と小文字を区別しない)：

• PlainText：コマンドコンテンツはエンコードされません。

• Base64：コマンドコンテンツは Base64 でエンコードされます。

デフォルト値：PlainText。値が無効な場合、PlainText モードが使用されます。

リクエストのべき等性を保証します。クライアントから一意のパラメーター値を生成して、異なるリクエスト間で一意性を保証します。ClientToken は ASCII 文字のみをサポートし、64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。