

# x-amazon-apigateway-endpoint-configuration 객체
<a name="api-gateway-swagger-extensions-endpoint-configuration"></a>

API에 대한 엔드포인트 구성의 세부 사항을 지정합니다. 이 확장은 [OpenAPI 작업](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md#operation-object) 객체의 확장된 속성입니다. 이 객체는 Swagger 2.0의 [최상위 공급 업체 확장](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/2.0.md#specification-extensions)에 있어야 합니다. OpenAPI 3.0의 경우 [서버 객체](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.0.md#server-object)의 공급 업체 확장 아래에 있어야 합니다.


| 속성 이름 | 유형 | 설명 | 
| --- | --- | --- | 
| disableExecuteApiEndpoint | 불 |  클라이언트가 기본 `execute-api` 엔드포인트를 사용하여 API를 호출할 수 있는지 여부를 지정합니다. 기본적으로 클라이언트는 기본 `https://{api_id}.execute-api.{region}.amazonaws.com` 엔드포인트로 API를 호출할 수 있습니다. 클라이언트가 사용자 지정 도메인 이름을 사용하여 API를 호출하도록 요구하려면 `true`를 지정합니다.  | 
| vpcEndpointIds | String의 어레이 |  REST API에 대해 Route 53 별칭 레코드를 생성할 VpcEndpoint 식별자 목록입니다. `PRIVATE` 엔드포인트 유형인 REST API에만 지원됩니다.  | 
| ipAddressType | string |  HTTP API를 간접적으로 호출할 수 있는 IP 주소 유형입니다. `ipv4`를 사용하여 IPv4 주소 유형이 HTTP API를 간접적으로 호출하도록 허용합니다. `dualstack`을 사용하여 IPv4 및 IPv6 주소 유형이 HTTP API를 간접적으로 호출하도록 허용합니다. HTTP API에서만 지원됩니다. | 

## x-amazon-apigateway-endpoint-configuration 예제
<a name="api-gateway-swagger-extensions-endpoint-configuration-example"></a>

다음 예제는 지정된 VPC 종단점을 REST API에 연결합니다.

```
"x-amazon-apigateway-endpoint-configuration": {
    "vpcEndpointIds": ["vpce-0212a4ababd5b8c3e", "vpce-01d622316a7df47f9"]
}
```

다음 예제는 API에 대한 기본 엔드포인트를 비활성화합니다.

```
"x-amazon-apigateway-endpoint-configuration": {
    "disableExecuteApiEndpoint": true
}
```

다음 예제에서는 IP 주소 유형을 HTTP API의 듀얼 스택으로 설정합니다.

```
"x-amazon-apigateway-endpoint-configuration": {
    "ipAddressType": "dualstack"
}
```