register-task-with-maintenance-windows オプションについて
register-task-with-maintenance-window コマンドには、必要に応じてタスクを設定するためのいくつかのオプションがあります。それらは、必須のオプション、任意のオプション、1 つのメンテナンスウィンドウタスクタイプにのみ適用されるオプションです。
このトピックでは、このチュートリアルのセクションでサンプルを使用するのに役立つ、これらのオプションのいくつかについて情報を提供します。すべてのコマンドオプションについては、AWS CLI コマンドリファレンスの「register-task-with-maintenance-window」を参照してください。
--task-arn
オプションについて
--task-arn
オプションでは、タスクが実行するリソースを指定するために使用します。以下の表に示しているように、指定する値は登録するタスクのタイプによって異なります。
メンテナンスウィンドウタスクの TaskArn 形式 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
メンテナンスウィンドウタスクのタイプ | TaskArn 値 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
-または-
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
-または-
重要Maintenance Windows の IAM ポリシーでは、Lambda 関数名 (またはエイリアス) の前にプレフィックス |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
重要メンテナンスウィンドウの IAM ポリシーでは、Step Functions ステートマシン名の前に |
--service-role-arn
オプションについて
メンテナンスウィンドウタスクを実行するときに AWS Systems Manager が引き受けるロール。
詳細については、「Maintenance Windows を設定する」を参照してください。
--task-invocation-parameters
オプションについて
--task-invocation-parameters
オプションを使用して、4 つのタスクタイプのそれぞれに固有のパラメータを指定します。以下の表では、4 つのタスクタイプそれぞれでサポートされているパラメータを示しています。
注記
--task-invocation-parameters
コンテンツでの {{TARGET_ID}} などの疑似パラメータの使用については、「メンテナンスウィンドウのタスクを登録する際の疑似パラメータの使用」を参照してください。
メンテナンスウィンドウタスク用のタスク呼び出しパラメータのオプション
メンテナンスウィンドウタスクのタイプ | 使用できるパラメータ | 例 |
---|---|---|
RUN_COMMAND |
コメント DocumentHash DocumentHashType NotificationConfig OutputS3BucketName OutPutS3KeyPrefix パラメータ ServiceRoleArn TimeoutSeconds |
|
AUTOMATION |
DocumentVersion パラメータ |
|
LAMBDA |
ClientContext Payload Qualifier |
|
STEP_FUNCTIONS |
Input 名前 |
|