5.8. OpenAPI 정의에서 3scale 백엔드 가져오기
toolbox import 명령을 사용하여 OpenAPI 정의를 가져오고 3scale 백엔드 API를 생성할 수 있습니다. 명령행 옵션 --backend 는 이 기능을 활성화합니다. 3scale은 OpenAPI 정의를 사용하여 백엔드 및 개인 기본 URL과 매핑 규칙 및 방법을 생성하고 저장합니다.
사전 요구 사항
- 3scale 2.14 On-Premises 인스턴스에 대한 관리자 권한이 있는 사용자 계정.
- API를 정의하는 OAS 문서입니다.
절차
다음 형식을 사용하여
가져오기명령을 실행하여 백엔드를 생성합니다.3scale import openapi -d <remote> --backend <OAS>
$ 3scale import openapi -d <remote> --backend <OAS>Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
&
lt;remote>를 백엔드를 생성할 3scale 인스턴스의 URL로 바꿉니다. 이 형식 사용:http[s]://<authentication>@3scale_domain &
lt;OAS>를/path/to/your/oasdoc.yaml로 바꿉니다.Expand 표 5.1. 추가 OpenAPI 정의 옵션 옵션 설명 -o --output=<value>출력 형식입니다. JSON 또는 YAML일 수 있습니다.
--override-private-base-url=<value>3scale은 OpenAPI 정의의
servers[0].url필드에서 백엔드의 개인 끝점을 읽습니다. 해당 필드의 설정을 재정의하려면 이 옵션을 지정하고 <value>를 선택한 개인 기본 URL로 바꿉니다. OpenAPI 정의에서servers[0].url필드에 값을 지정하지 않고가져오기명령에 이 옵션을 지정하지 않으면 실행이 실패합니다.--prefix-matchingOpenAPI 작업에서 파생된 매핑 규칙에 대해 엄격한 일치 대신 접두사 일치를 사용합니다.
--skip-openapi-validationOpenAPI 스키마 검증을 건너뜁니다.
-t --target_system_name=<value>대상 시스템 이름은 테넌트의 고유한 키입니다. 시스템 이름은 OpenAPI 정의에서 유추할 수 있지만 이 매개변수를 사용하여 자체 이름으로 재정의할 수 있습니다.