Amazon ECS 듀얼 스택 엔드포인트 사용 - Amazon Elastic Container Service
듀얼 스택 엔드포인트 사용(AWS CLI)듀얼 스택 엔드포인트 사용(AWS SDK)REST API의 듀얼 스택 엔드포인트 사용

Amazon ECS 듀얼 스택 엔드포인트 사용

Amazon ECS 듀얼 스택 엔드포인트는 인터넷 프로토콜 버전 4(IPv4) 및 인터넷 프로토콜 버전 6(IPv6)을 통해 Amazon ECS에 대한 요청을 지원합니다. 모든 Amazon ECS 엔드포인트 목록은 AWS 일반 참조의 Amazon ECS 엔드포인트 및 할당량을 참조하세요.

REST API를 사용하는 경우, 엔드포인트 이름(URI)을 사용하여 Amazon ECS 엔드포인트에 직접 액세스합니다. Amazon ECS는 리전 듀얼 스택 엔드포인트 이름만 지원합니다. 이는 이름의 일부로 리전을 지정해야 함을 뜻합니다.

듀얼 스택 엔드포인트 이름에는 다음 명명 규칙 ecs.region.api.aws를 사용합니다.

AWS Command Line Interface(AWS CLI) 및 AWS SDK를 사용하는 경우, 파라미터 또는 플래그를 사용하여 듀얼 스택 엔드포인트를 변경할 수 있습니다. 구성 파일의 Amazon ECS 엔드포인트를 재정의하여 듀얼 스택 엔드포인트를 직접 지정할 수도 있습니다.

다음 섹션에서는 AWS CLI, AWS SDK 및 REST API의 듀얼 스택 엔드포인트를 사용하는 방법을 설명합니다.

AWS CLI의 듀얼 스택 엔드포인트 사용

이 단원에서는 듀얼 스택 엔드포인트에 요청하는 데 사용되는 AWS CLI 명령의 예를 보여 줍니다. AWS CLI 설치 또는 최신 버전으로의 업그레이드 방법에 대한 자세한 내용은 AWS Command Line Interface 버전 2 사용 설명서의 AWS CLI 최신 버전 설치 또는 업데이트를 참조하세요.

듀얼 스택 엔드포인트를 사용하려면 AWS CLI의 config 파일에서 구성 값 use_dualstack_endpoint를 true로 설정하여 ecs AWS CLI 명령의 모든 Amazon ECS 요청을 지정된 리전의 듀얼 스택 엔드포인트로 보냅니다. --region 옵션을 사용하여 config 파일 또는 명령에서 리전을 지정할 수 있습니다. AWS CLI의 구성 파일에 대한 자세한 내용은 AWS Command Line Interface 버전 2 사용 설명서의 AWS CLI의 구성 및 자격 증명 파일 설정을 참조하세요.

명령을 사용하여 구성을 업데이트할 수도 있습니다. 다음 명령은 기본 프로파일에서 use_dualstack_endpoint를 true로 업데이트합니다.

$ aws configure set default.ecs.use_dualstack_endpoint true

특정 AWS CLI 명령에 대해서만 듀얼 스택 엔드포인트를 사용하려는 경우, 다음 방법 중 하나를 사용할 수 있습니다.

  • ecs 명령에 대해 --endpoint-url 파라미터를 https://ecs.aws-region.api.aws 또는 http://ecs.aws-region.api.aws로 설정하여 명령별로 듀얼 스택 엔드포인트를 사용할 수 있습니다.

    다음 예제 명령은 사용 가능한 모든 클러스터를 나열하고 해당 요청에 듀얼 스택 엔드포인트를 사용합니다.

    $ aws ecs list-clusters --endpoint-url https://ecs.aws-region.api.aws

  • AWS Config 파일에 별도의 프로파일을 설정할 수 있습니다. 예를 들어, use_dualstack_endpoint를 true로 설정하는 프로파일을 하나 작성하고, use_dualstack_endpoint를 설정하지 않는 프로파일을 하나 작성합니다. 명령을 실행할 때 듀얼 스택 엔드포인트를 사용할지 여부에 따라 사용할 프로파일을 지정합니다.

AWS SDK의 듀얼 스택 엔드포인트 사용

이 섹션에서는 AWS SDK를 사용하여 듀얼 스택 엔드포인트에 액세스하는 방법의 예제를 보여줍니다.

AWS SDK for Java 2.x

다음 예제는 AWS SDK for Java 2.x를 사용하여 us-east-1 리전의 듀얼 스택 엔드포인트를 지정하는 방법을 보여줍니다.

Region region = Region.US_EAST_1
EcsClient client = EcsClient.builder().region(region).dualstackEnabled(true).build();
AWS SDK for Go

다음 예제는 AWS SDK for Go를 사용하여 us-east-1 리전의 듀얼 스택 엔드포인트를 지정하는 방법을 보여줍니다.

sess := session.Must(session.NewSession())
svc := ecs.New(sess, &aws.Config{
    Region: aws.String(endpoints.UsEast1RegionID),
    Endpoint: aws.String("https://ecs.us-east-1.api.aws")
})

자세한 내용은 AWS SDK 및 도구 참조 가이드의 듀얼 스택 및 FIPS 엔드포인트를 참조하세요.

REST API의 듀얼 스택 엔드포인트 사용

REST API를 사용하는 경우 요청에서 지정하여 듀얼 스택 엔드포인트에 직접 액세스할 수 있습니다. 다음 예제에서는 듀얼 스택 엔드포인트를 사용하여 us-east-1 리전의 모든 Amazon ECS 클러스터를 나열합니다.

POST / HTTP/1.1
Host: ecs.us-east-1.api.aws
Accept-Encoding: identity
Content-Length: 2
X-Amz-Target: AmazonEC2ContainerServiceV20141113.ListClusters
X-Amz-Date: 20150429T170621Z
Content-Type: application/x-amz-json-1.1
Authorization: AUTHPARAMS

{}