

# API Gateway의 REST API에 대한 IP 주소 유형
<a name="api-gateway-ip-address-type"></a>

API를 만들 때 API를 간접적으로 호출할 수 있는 IP 주소 유형을 지정합니다. IPv4를 선택하여 IPv4 주소가 API를 간접적으로 호출하도록 확인하거나, 듀얼 스택을 선택하여 IPv4 및 IPv6 주소가 모두 API를 간접적으로 호출하도록 허용할 수 있습니다. IP 공간 소진을 완화하기 위해 또는 보안 태세를 위해 IP 주소 유형을 듀얼 스택으로 설정하는 것이 좋습니다. 듀얼 스택 IP 주소 유형의 이점에 대한 자세한 내용은 [IPv6 on AWS](https://docs.aws.amazon.com/whitepapers/latest/ipv6-on-aws/internet-protocol-version-6.html)를 참조하세요.

API를 IPv6 트래픽으로만 제한하려면 리소스 정책을 만들고 소스 IP 주소를 IPv6 범위로만 제한할 수 있습니다. API의 구성을 업데이트하여 IP 주소 유형을 변경할 수 있습니다. 이 변경 사항은 즉시 적용되며 API를 재배포할 필요가 없습니다. 자세한 내용은 [예제: 소스 IP 주소 또는 범위에 따라 API 트래픽 거부](apigateway-resource-policies-examples.md#apigateway-resource-policies-source-ip-address-example) 섹션을 참조하세요.

## IP 주소 유형에 대한 고려 사항
<a name="api-gateway-ip-address-type-considerations"></a>

다음 고려 사항은 IP 주소 유형 사용에 영향을 미칠 수 있습니다.
+ 모든 리전 및 엣지 최적화 API의 기본 IP 주소 유형은 IPv4입니다.
+ 프라이빗 API는 듀얼 스택 IP 주소 유형만 가질 수 있습니다.
+ 기존 API의 IP 주소 유형을 IPv4에서 듀얼 스택으로 변경하는 경우 API에 대한 액세스를 제어하는 정책이 IPv6 직접 호출을 설명하도록 업데이트되었는지 확인합니다. IP 주소 유형을 변경하면 변경 사항이 즉시 적용됩니다.
+ API의 엔드포인트 유형을 리전 또는 엣지 최적화에서 프라이빗으로 마이그레이션하는 경우 API Gateway는 IP 주소 유형을 듀얼 스택으로 변경합니다. 자세한 내용은 [API Gateway에서 퍼블릭 또는 프라이빗 API 엔드포인트 유형 변경](apigateway-api-migration.md) 섹션을 참조하세요.
+ API의 엔드포인트 유형을 프라이빗에서 리전으로 마이그레이션하는 경우 IP 주소 유형을 듀얼 스택으로 설정해야 합니다. 엔드포인트 마이그레이션이 완료되면 IP 주소 유형을 IPv4로 변경할 수 있습니다. 자세한 내용은 [API Gateway에서 퍼블릭 또는 프라이빗 API 엔드포인트 유형 변경](apigateway-api-migration.md) 섹션을 참조하세요.
+ API는 API와 다른 IP 주소 유형의 사용자 지정 도메인 이름에 매핑할 수 있습니다. 기본 API 엔드포인트를 비활성화하면 직접 호출자가 API를 간접적으로 호출하는 방법에 영향을 미칠 수 있습니다.
+ 외부 정의 파일을 사용하여 API의 IP 주소 유형을 구성할 수 없습니다.