OpenAPI 2.0 기능 제한사항

다음 섹션에서는 API Gateway의 OpenAPI 2.0 기능 제한사항을 설명합니다.

API Gateway는 보안 스키마 객체에 정의된 범위가 있는 OpenAPI 문서를 허용하지만 이러한 범위는 확인되거나 적용되지 않습니다.

API 키 요구사항: 스키마 중 하나가 API 키인 경우 API Gateway는 대체 (논리합) 보안 요구사항을 지원하지 않습니다. 하지만 결합 (논리곱)이 지원되므로 API 키와 OAuth2 토큰을 모두 요구할 수 있습니다.
OAuth2 요구사항: 다양한 OAuth2 보안 스키마에 대체 (논리합) 보안 요구사항이 지원됩니다.
다양한 OAuth2 보안 스키마의 접속사 (논리곱) 보안 요구사항은 지원되지 않습니다.
선택적 보안: 빈 보안 요구사항 (- {})을 사용하여 API 키의 보안을 선택사항으로 만들 수 있지만 OAuth에는 지원되지 않습니다.

API 게이트웨이는 securityDefinitions 섹션에 해당 정의가 없는 보안 요구사항을 사용하는 OpenAPI 3.x 사양을 거부합니다.

API Gateway는 전체 경로 세그먼트를 나타내는 URL 경로 템플릿 매개변수만 지원합니다 (예: /items/{itemId})는 지원되지 않으며 거부됩니다./items/prefix_{id}_suffix

API 게이트웨이는 다양한 매개변수 및 유형 정의 (예: required 매개변수, 배열 형식)을 지원하지만 이를 강제하지는 않습니다. 수신 요청은 이러한 정의와 관계없이 API로 전달됩니다.

API Gateway는 제공된 OpenAPI 문서 외부의 유형에 대한 참조를 지원하지 않습니다. 예를 들어 외부 URL을 가리키는 $ref는 허용되지 않으며 거부됩니다.

API 게이트웨이는 OpenAPI 문서의 host 필드에 커스텀 포트를 허용하지 않습니다.

API 게이트웨이에 제출된 OpenAPI 문서에는 YAML 별칭 노드가 최대 200개까지 있을 수 있습니다.