EC2 Instance Connect 엔드포인트 수정 - Amazon Elastic Compute Cloud
수정할 수 있는 파라미터

EC2 Instance Connect 엔드포인트 수정

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

시작하려면 먼저 필요한 IAM 권한이 있어야 합니다. 자세한 내용은 EC2 Instance Connect 엔드포인트 생성, 설명, 수정, 삭제할 수 있는 권한 섹션을 참조하세요.

수정할 수 있는 파라미터

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

보안 그룹

EC2 Instance Connect 엔드포인트에 대한 새 보안 그룹을 지정할 수 있습니다. 새 보안 그룹은 현재 보안 그룹을 대체합니다.

보안 그룹을 수정할 때 다음을 지정해야 합니다.

  • VPC의 기본 보안 그룹일지라도 하나 이상의 보안 그룹입니다.

  • 이름이 아닌 보안 그룹의 ID입니다.

IP 주소 유형

EC2 Instance Connect 엔드포인트에 새 IP 주소 유형을 지정할 수 있습니다.

유효한 값: ipv4 | dualstack | ipv6

클라이언트 IP 설정 보존

클라이언트 IP 주소를 소스로 보존할지 여부를 지정할 수 있습니다.

참고

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

AWS CLI
EC2 Instance Connect 엔드포인트 수정

modify-instance-connect-endpoint 명령을 사용하고 수정할 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로 변경될 때까지 이전 구성을 사용합니다.

업데이트 상태를 모니터링하려면 describe-instance-connect-endpoints 명령을 사용합니다. --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 엔드포인트 수정

Edit-EC2InstanceConnectEndpoint 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로 변경될 때까지 이전 구성을 사용합니다.

Get-EC2InstanceConnectEndpoint 명령을 사용하여 업데이트 상태를 모니터링합니다. .State.Value는 결과를 State 필드로 필터링합니다.

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

출력의 예시는 다음과 같습니다.

update-complete