# Amazon ECS 듀얼 스택 엔드포인트 사용
Amazon ECS 듀얼 스택 엔드포인트는 인터넷 프로토콜 버전 4(IPv4) 및 인터넷 프로토콜 버전 6(IPv6)을 통해 Amazon ECS에 대한 요청을 지원합니다. 모든 Amazon ECS 엔드포인트 목록은 AWS 일반 참조의 [Amazon ECS 엔드포인트 및 할당량](https://docs.aws.amazon.com/general/latest/gr/ecs-service.html)을 참조하세요.
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의 듀얼 스택 엔드포인트를 사용하는 방법을 설명합니다.
**Topics**
+ [AWS CLI의 듀얼 스택 엔드포인트 사용](#dual-stack-endpoints-cli)
+ [AWS SDK의 듀얼 스택 엔드포인트 사용](#dual-stack-endpoints-sdks)
+ [REST API의 듀얼 스택 엔드포인트 사용](#dual-stack-endpoints-examples-rest-api)
## AWS CLI의 듀얼 스택 엔드포인트 사용
이 섹션에서는 듀얼 스택 엔드포인트에 요청하는 데 사용되는 AWS CLI 명령의 예를 보여 줍니다. AWS CLI 설치 또는 최신 버전으로의 업그레이드 방법에 대한 자세한 내용은 *AWS Command Line Interface 버전 2 사용 설명서*의 [AWS CLI 최신 버전 설치 또는 업데이트](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 참조하세요.
듀얼 스택 엔드포인트를 사용하려면 AWS CLI의 `config` 파일에서 구성 값 `use_dualstack_endpoint`를 `true`로 설정하여 `ecs` AWS CLI 명령의 모든 Amazon ECS 요청을 지정된 리전의 듀얼 스택 엔드포인트로 보냅니다. `--region` 옵션을 사용하여 `config` 파일 또는 명령에서 리전을 지정할 수 있습니다. AWS CLI의 구성 파일에 대한 자세한 내용은 *AWS Command Line Interface 버전 2 사용 설명서*의 [AWS CLI의 구성 및 자격 증명 파일 설정](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)을 참조하세요.
특정 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 엔드포인트](https://docs.aws.amazon.com/sdkref/latest/guide/feature-endpoints.html)를 참조하세요.
## 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
{}
```