翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# `AWS-UpdateAmazonECSAgent`
<a name="automation-aws-update-ecs-agent"></a>

 **説明** 

 `AWS-UpdateAmazonECSAgent` ランブックでは、指定した Amazon Elastic Compute Cloud (Amazon EC2) インスタンス上の Amazon Elastic Container Service (Amazon ECS) エージェントを更新します。このランブックは、Amazon Linux および Amazon Linux 2 インスタンスのみをサポートします。

 [このオートメーションを実行する (コンソール)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-UpdateAmazonECSAgent) 

**ドキュメントタイプ**

オートメーション

**[所有者]**

Amazon

**[Platforms]** (プラットフォーム)

Linux

**パラメータ**
+ AutomationAssumeRole

  タイプ: 文字列

  説明: (オプション) Systems Manager Automation がユーザーに代わってアクションを実行できるようにする AWS Identity and Access Management (IAM) ロールの Amazon リソースネーム (ARN)。ロールを指定しない場合、Systems Manager Automation はこのランブックを開始するユーザーのアクセス許可を使用します。
+ ClusterARN

  タイプ: StringList

  説明: (必須) コンテナインスタンスが登録されている Amazon ECS クラスターの Amazon リソースネーム (ARN)。

**必要な IAM アクセス許可**

`AutomationAssumeRole` パラメータでは、ランブックを正常に使用するために、次のアクションが必要です。
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ssm:GetCommandInvocation` 
+  `ec2:DescribeImages` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeImage` 
+  `ec2:DescribeInstance` 
+  `ec2:DescribeInstanceAttribute` 
+  `ecs:DescribeContainerInstances` 
+  `ecs:DescribeClusters` 
+  `ecs:ListContainerInstances` 
+  `ecs:UpdateContainerAgent` 

 **ドキュメントステップ** 

 `aws:executeScript` - `ClusterARN` パラメータで指定した Amazon ECS クラスターの Amazon ECS エージェントを更新します。

 **[出力] ** 

UpdateAmazonECSAgent.UpdatedContainers - Amazon ECS エージェントの更新が成功したインスタンスの ID。

UpdateAmazonECSAgent.FailedContainers - Amazon ECS エージェントの更新が失敗したインスタンスの ID。

UpdateAmazonECSAgent.InProgressContainers - Amazon ECS エージェントの更新が進行中のインスタンスの ID。