기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

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

 **설명** 

`AWS-QuarantineEC2Instance` 실행서를 사용하면, 인바운드 또는 아웃바운드 트래픽을 허용하지 않는 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스에 보안 그룹을 할당할 수 있습니다.

**중요**  
이 실행서를 실행하기 전에 RDP 설정에 대한 변경 내용을 신중히 검토해야 합니다.

[이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-QuarantineEC2Instance)

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (선택 사항) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다. 역할을 지정하지 않은 경우, Systems Manager Automation에서는 이 실행서를 시작하는 사용자의 권한을 사용합니다.
+ InstanceId

  유형: 문자열

  설명: (필수) RDP 설정을 관리할 관리형 인스턴스의 ID입니다.
+ IsolationSecurityGroup

  유형: 문자열

  설명: (필수) 인바운드 또는 아웃바운드 트래픽을 방지하기 위해 인스턴스에 할당하려는 보안 그룹의 이름입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+ `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`