View a markdown version of this page

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

EC2 Instance Connect 엔드포인트 수정

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

시작하려면 먼저 필요한 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여야 합니다.

Console
EC2 Instance Connect 엔드포인트 수정

  1. https://console.aws.amazon.com/vpc/에서 Amazon VPC 콘솔을 엽니다.

  2. 왼쪽 탐색 창에서 엔드포인트를 선택합니다.

  3. 엔드포인트를 선택합니다.

  4. 작업(Actions), 엔드포인트 설정 수정(Modify endpoint settings)을 차례로 선택합니다.

  5. 엔드포인트 설정을 변경합니다.

  6. 변경 사항 저장을 선택합니다.

    엔드포인트가 보류 중 상태가 됩니다. 수정이 완료되면 엔드포인트는 사용 가능 상태로 돌아갑니다.

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