# EC2 Instance Connect 엔드포인트 수정
<a name="modify-ec2-instance-connect-endpoint"></a>

AWS CLI 또는 SDK를 사용하여 기존 EC2 Instance Connect 엔드포인트를 수정할 수 있습니다. Amazon EC2 콘솔은 엔드포인트 수정을 지원하지 않습니다.

시작하려면 먼저 필요한 IAM 권한이 있어야 합니다. 자세한 내용은 [EC2 Instance Connect 엔드포인트 생성, 설명, 수정, 삭제할 수 있는 권한](permissions-for-ec2-instance-connect-endpoint.md#iam-CreateInstanceConnectEndpoint) 섹션을 참조하세요.

## 수정할 수 있는 파라미터
<a name="eice-modify-parameters"></a>

다음 EC2 Instance Connect 엔드포인트 파라미터를 수정할 수 있습니다.

**보안 그룹**  
EC2 Instance Connect 엔드포인트에 대한 새 보안 그룹을 지정할 수 있습니다. 새 보안 그룹은 현재 보안 그룹을 대체합니다.  
보안 그룹을 수정할 때 다음을 지정해야 합니다.  
+ VPC의 기본 보안 그룹일지라도 하나 이상의 보안 그룹입니다.
+ 이름이 아닌 보안 그룹의 ID입니다.

**IP 주소 유형**  
EC2 Instance Connect 엔드포인트에 새 IP 주소 유형을 지정할 수 있습니다.  
유효한 값: `ipv4` \$1 `dualstack` \$1 `ipv6`

**클라이언트 IP 설정 보존**  
클라이언트 IP 주소를 소스로 보존할지 여부를 지정할 수 있습니다.  
클라이언트 IP 보존은 IPv4 EC2 Instance Connect 엔드포인트에서만 지원됩니다. `PreserveClientIp`를 활성화하는 경우 엔드포인트의 기존 IP 주소 유형은 `ipv4`여아 하고, 동일한 요청에서 IP 주소 유형을 수정하는 경우 새 값은 `ipv4`여야 합니다.

------
#### [ AWS CLI ]

**EC2 Instance Connect 엔드포인트 수정**  
[https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-connect-endpoint.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-connect-endpoint.html) 명령을 사용하고 수정할 EC2 Instance Connect 엔드포인트 및 파라미터를 지정합니다. 다음 예제에서는 단일 요청으로 전체 파라미터를 수정합니다.

```
aws ec2 modify-instance-connect-endpoint \
    --instance-connect-endpoint-id eice-0123456789example \
    --security-group-ids sg-0123456789example \
    --ip-address-type dualstack \
    --no-preserve-client-ip
```

다음은 예제 출력입니다.

```
{
    "Return": true
}
```

**업데이트 상태 모니터링**  
수정하는 동안 EC2 Instance Connect 엔드포인트 상태가 `update-in-progress`로 변경됩니다. 업데이트 프로세스는 비동기적으로 실행되며 `update-complete` 또는 `update-failed` 상태와 함께 완료됩니다. 엔드포인트는 상태가 `update-complete`로 변경될 때까지 이전 구성을 사용합니다.

업데이트 상태를 모니터링하려면 [https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-connect-endpoints.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-connect-endpoints.html) 명령을 사용합니다. `--query` 파라미터는 결과를 `State` 필드로 필터링합니다.

```
aws ec2 describe-instance-connect-endpoints \
    --instance-connect-endpoint-ids eice-0123456789example \
    --query InstanceConnectEndpoints[*].State --output text
```

다음은 예제 출력입니다.

```
update-complete
```

------
#### [ PowerShell ]

**EC2 Instance Connect 엔드포인트 수정**  
[https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceConnectEndpoint.html](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceConnectEndpoint.html) cmdlet을 사용하고 수정할 EC2 Instance Connect 엔드포인트 및 파라미터를 지정합니다. 다음 예제에서는 단일 요청으로 전체 파라미터를 수정합니다.

```
Edit-EC2InstanceConnectEndpoint `
    -InstanceConnectEndpointId eice-0123456789example `
    -SecurityGroupIds sg-0123456789example `
    -IpAddressType dualstack `
    -PreserveClientIp $false
```

다음은 예제 출력입니다.

```
True
```

**업데이트 상태 모니터링**  
수정하는 동안 EC2 Instance Connect 엔드포인트 상태가 `update-in-progress`로 변경됩니다. 업데이트 프로세스는 비동기적으로 실행되며 `update-complete` 또는 `update-failed` 상태와 함께 완료됩니다. 엔드포인트는 상태가 `update-complete`로 변경될 때까지 이전 구성을 사용합니다.

[https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceConnectEndpoint.html](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceConnectEndpoint.html) 명령을 사용하여 업데이트 상태를 모니터링합니다. `.State.Value`는 결과를 `State` 필드로 필터링합니다.

```
(Get-EC2InstanceConnectEndpoint -InstanceConnectEndpointId "eice-0123456789example").State.Value
```

다음은 예제 출력입니다.

```
update-complete
```

------