翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # `AWS-ECSRunTask` **説明** `AWS-ECSRunTask` ランブックは、指定した Amazon Elastic Container Service (Amazon ECS) タスクを実行します。 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ECSRunTask) **ドキュメントタイプ** オートメーション **[所有者]** Amazon **[Platforms]** (プラットフォーム) Linux **パラメータ** + AutomationAssumeRole タイプ: 文字列 説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。 + capacityProviderStrategy タイプ: 文字列 説明: (オプション) タスクに使用するキャパシティープロバイダー戦略。 + クラスター タイプ: 文字列 説明: (オプション) タスクを実行するクラスターの短縮名または ARN。クラスターを指定しない場合、デフォルトのクラスターが使用されます。 + count タイプ: 文字列 説明: (オプション) クラスターに配置する指定されたタスクのインスタンス化の数。リクエストごとに最大 10 個のタスクを指定できます。 + enableECSManagedTags タイプ: ブール値 説明: (オプション) タスクに Amazon ECS マネージドタグを使用するかどうかを指定します。詳細については、「Amazon Elastic Container Service デベロッパーガイド」の「[Amazon ECS リソースにタグを付ける](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)」を参照してください。 + enableExecuteCommand タイプ: ブール値 説明: (オプション) このタスクのコンテナの実行コマンド機能をアクティブ化するかどうかを決定します。true の場合、タスク内のすべてのコンテナでコマンド実行機能が有効になります。 + グループ タイプ: 文字列 説明: (オプション) タスクに関連付けるタスクグループの名前。デフォルト値は、タスク定義のファミリー名です。例えば、`family:my-family-name`。 + launchType タイプ: 文字列 有効な値: EC2 \$1 FARGATE \$1 EXTERNAL 説明: (オプション) スタンドアロンタスクを実行するインフラストラクチャ。 + networkConfiguration タイプ: 文字列 説明: (オプション) タスクのネットワーク設定。このパラメータは、 `awsvpc`ネットワークモードを使用して独自の Elastic Network Interface を受信するタスク定義に必要です。他のネットワークモードではサポートされていません。 + 上書き タイプ: 文字列 説明: (オプション) 指定されたタスク定義でコンテナの名前を指定する JSON 形式のコンテナオーバーライドのリストと、コンテナが受け取るオーバーライド。タスク定義または Docker イメージで指定されたコンテナのデフォルトコマンドをコマンドオーバーライドで上書きできます。タスク定義またはコンテナの Docker イメージで指定された既存の環境変数を上書きすることもできます。さらに、環境オーバーライドを使用して新しい環境変数を追加できます。 + placementConstraints タイプ: 文字列 説明: (オプション) タスクに使用する配置制約オブジェクトの配列。タスク定義の制約と実行時に指定された制約を含め、タスクごとに最大 10 個の制約を指定できます。 + placementStrategy タイプ: 文字列 説明: (オプション) タスクに使用する配置戦略オブジェクト。タスクごとに最大 5 つの戦略ルールを指定できます。 + platformVersion タイプ: 文字列 説明: (オプション) タスクが使用するプラットフォームバージョン。プラットフォームバージョンは、Fargate でホストされているタスクに対してのみ指定されます。プラットフォームバージョンが指定されない場合、`LATEST` プラットフォームバージョンが使用されます。 + propagateTags タイプ: 文字列 説明: (オプション) タグがタスク定義からタスクに伝達されるかどうかを決定します。値を指定しない場合、タグは伝播されません。タグは、タスクの作成時にのみタスクに伝播できます。 + referenceId タイプ: 文字列 説明: (オプション) タスクに使用するリファレンス ID。リファレンス ID の最大長は 1024 文字です。 + startedBy タイプ: 文字列 説明: (オプション) タスクの開始時に指定されたオプションのタグ。これにより、`ListTasks`API オペレーションの結果をフィルタリングして、特定のジョブに属するタスクを特定できます。最大 36 文字 (大文字と小文字）、数字、ハイフン (-)、アンダースコア (\$1) を使用できます。 + タグ タイプ: 文字列 説明: (オプション) タスクの分類と整理に役立つようにタスクに適用するメタデータ。各タグはユーザー定義のキーと値で構成されます。 + taskDefinition タイプ: 文字列 説明: (オプション) 実行するタスク定義の `family`および `revision` (`family`:`revision`) または完全な ARN。リビジョンが指定されていない場合は、最新の`ACTIVE`リビジョンが使用されます。 **必要な IAM アクセス許可** `AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。 + `ecs:RunTask` **ドキュメントステップ** `aws:executeScript` - ランブック入力パラメータに指定した値に基づいて Amazon ECS タスクを実行します。