本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# `AWS-QuarantineEC2Instance`
<a name="aws-quarantineec2instance"></a>

 **Description** 

使用 `AWS-QuarantineEC2Instance` Runbook，您可以將安全群組指派給不允許任何傳入或傳出流量的 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體。

**重要**  
執行此 Runbook 之前，應仔細檢閱 RDP 設定的變更。

[執行此自動化 （主控台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-QuarantineEC2Instance)

**文件類型**

 自動化

**擁有者**

Amazon

**平台**

Linux、macOS、 Windows

**參數**
+ AutomationAssumeRole

  類型：字串

  描述：（選用） 允許 Systems Manager Automation 代表您執行動作的 (IAM) 角色的 AWS Identity and Access Management Amazon Resource Name (ARN)。如果未指定角色，Systems Manager Automation 會使用啟動此 Runbook 的使用者許可。
+ InstanceId

  類型：字串

  描述：(必要) 管理 RDP 設定的受管執行個體之 ID。
+ IsolationSecurityGroup

  類型：字串

  描述：（必要） 您要指派給執行個體的安全群組名稱，以防止傳入或傳出流量。

**必要的 IAM 許可**

`AutomationAssumeRole` 參數需要下列動作才能成功使用 Runbook。
+ `autoscaling:DescribeAutoScalingInstances`
+ `autoscaling:DetachInstances`
+ `ec2:CreateSecurityGroup`
+ `ec2:CreateSnapshot`
+ `ec2:DescribeInstances`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSnapshots`
+ `ec2:ModifyInstanceAttribute`
+ `ec2:RevokeSecurityGroupEgress`
+ `ec2:RevokeSecurityGroupIngress`

 **文件步驟** 
+ `aws:executeAwsApi` - 收集執行個體的詳細資訊。
+ `aws:executeScript` - 驗證執行個體不是 Auto Scaling 群組的一部分。
+ `aws:executeAwsApi` - 建立連接到執行個體之根磁碟區的快照。
+ `aws:waitForAwsResourceProperty` - 等待快照狀態為 `completed`。
+ `aws:executeAwsApi` - 將 `IsolationSecurityGroup` 參數中指定的安全群組指派給您的執行個體。

 **輸出** 

`GetEC2InstanceResources.RevokedSecurityGroupsIds`

`GetEC2InstanceResources.RevokedSecurityGroupsNames`

`createSnapshot.SnapId`