Stage 생성하기
API를 배포하기 위해서는 먼저 Stage를 생성해야 합니다.
① My Products > APIs > Stage 메뉴로 이동하여 Stage 탭을 선택합니다.
② Stage 생성을 클릭합니다.
③ Stage 생성에 필요한 값을 입력합니다.
- Stage 이름: Stage의 이름을 입력합니다. Stage의 이름은 API Gateway의 호출 URL의 경로에 포함됩니다.
- Endpoint 도메인: 백엔드 서버의 도메인을 입력합니다. API의 Resource Path와 결합하여 백엔드 서버로 호출할 API 경로가 됩니다.
- API 캐시: Cache를 설정합니다.
- TTL: Cache를 유지할 초(sec)를 설정합니다.
- Throttling: 등록한 Method별로 초당 요청 수를 제한하여 백엔드 서버를 보호합니다.
- IP ACL: IP를 통해 API 요청을 제어합니다.
- 유지보수: 모든 API가 정의된 상태코드와 응답을 리턴하도록 설정합니다.
④ 생성을 클릭합니다.
- Stage가 생성될 때 정의되어 있는 API가 새로운 Stage에 배포됩니다.
① API 배포를 클릭합니다.
- API는 하나의 Stage에는 여러번 배포할 수 있으며 배포 이력을 통해 관리됩니다.
① API 배포에 필요한 값을 입력합니다.
- 배포할 Stage: 배포할 Stage를 선택합니다.
- 설명: 배포 설명을 입력합니다.
② 추가를 클릭합니다.
① Stages 탭을 선택합니다.
② 배포한 API를 호출할 수 있는 URL입니다.
이 URL은 다음과 같이 구성됩니다.
https://{product-id}.apigw.ntruss.com/{api-name}/{stage-name}
③ 추가한 Resource가 Stage로 배포됩니다.
API 호출하기
API 배포까지 진행하였다면 API를 호출할 수 있습니다.
API 호출하기를 참고하세요.
내보내기
Stage에 배포된 API는 Swagger Json으로 다운로드할 수 있습니다.
① Export 탭을 선택합니다.
② 다운로드할 형식을 선택합니다.
③ 내보내기를 클릭하면 선택한 플랫폼에 맞는 SDK를 다운로드할 수 있습니다.
배포 이력
Stage에는 API를 여러 번 배포할 수 있습니다. 그리고 이전에 배포했던 설정으로 되돌릴 수 있습니다.
① Deployment History 탭을 선택합니다.
② Stage에 배포된 Deployment에 표시됩니다.
③ 기존에 배포되어 있던 다른 Deployment를 선택하여 배포할 수 있습니다.
