요소를 어셈블리에 추가

온라인에서 편집하기

API Designer에서 어셈블 보기를 사용하여 API 어셈블리를 작성하십시오. API 편집기에서 ‘게이트웨이(Gateway)’ 탭을 클릭하면 ‘어셈블(Assemble)’ 보기로 이동할 수 있습니다.

이 태스크에 대한 정보

참고: 이 태스크는 OpenAPI 2.0 API정의 구성과 관련됩니다. OpenAPI 3.0 API 정의를 구성하는 방법에 대한 세부사항은 OpenAPI 3.0 API 정의 편집을 참조하십시오.

API Designer UI 애플리케이션을 사용하거나 브라우저 기반 API Manager UI를 사용하여 이 태스크를 완료할 수 있습니다.

UI에서 어셈블리 도구를 사용하면 API의 오퍼레이션에 대해 작성된 요청 또는 이러한 오퍼레이션에 의해 작성된 응답을 오퍼레이션하는 데 사용되는 어셈블리를 작성할 수 있습니다.

언제든지 소스 아이콘을 클릭하면 기본 OpenAPI 소스 아이콘 OpenAPI YAML 소스 파일로 바로 전환할 수 있습니다. 양식 화면으로 돌아가려면 양식 아이콘을 클릭하세요 .

소스 보기를 사용하여 API 정의의 소스를 편집하려는 경우 OpenAPI YAML을 구성하는 방법에 대한 자세한 정보는 execute OpenAPI extension 을 참조하십시오.

어셈블리 도구 사용에 대한 자세한 내용은 ‘어셈블리 편집기’를 참조하십시오.

프로시저

어셈블리 도구를 사용하여 요소를 어셈블리에 추가하려면 다음 단계를 완료하십시오.

탐색 창에서 클릭하세요 [개발]을 클릭한 다음 [API] 탭을 선택하세요.
개발 페이지가 열립니다.
작업할 API 정의의 제목을 클릭하십시오.
요소를 추가하려면 정책 보기를 사용하십시오.

주: 정책의 버전을 지정해야 합니다. API와 게이트웨이 간의 정책 버전 불일치로 인한 오류를 방지하기 위해, API의 정책 버전이 게이트웨이에 설정된 버전과 API Connect 정확히 일치하는 경우에만 API를 게이트웨이에 게시합니다.
1. 게이트웨이 탭을 선택한 후 탐색 분할창에서 정책 을 클릭하십시오.
2. 캔버스의 적절한 위치에 있는 더하기 아이콘을 클릭하면 사용 가능한 요소가 나열된 팔레트가 표시됩니다.
3. 팔레트에서 캔버스에 추가할 요소를 클릭하여 선택하세요.
  참고:
  - 요소는 초기 채워지지 않은 원으로부터 마지막 채워진 원까지 순서대로 적용됩니다.
  - 오퍼레이션 전환 요소가 사용되지 않으면, 전체 어셈블리는 API에서 모든 오퍼레이션에 적용됩니다.
4. 요소를 클릭한 다음 속성 시트를 사용하여 요소 속성을 추가하거나 편집할 수 있습니다.
  일부 요소의 경우, 오브젝트 특성을 클릭하고 특성을 드롭 다운 목록에서 선택하여 특성을 추가하고 제거할 수 있습니다. 정책 요소의 속성에 대한 자세한 내용은 API 정책 및 논리 구문을 참조하십시오. 논리 구조의 속성에 대한 자세한 내용은 ‘논리 구조’를 참조하십시오.
5. 정책의 버전을 지정하십시오.
  버전을 추가하려면 소스 아이콘을 클릭한 다음, 정책 YAML의 해당 version 섹션을 작성하십시오. 예를 들어,
```
execute:
  - invoke:
      version: 2.2.0
      title: invoke
...
```
  사용 중인 게이트웨이와 호환 가능한 정책의 버전을 지정해야 합니다. API가 공개될 때 버전이 게이트웨이와 호환되지 않으면 사용 가능한 버전을 지정하는 유효성 검증 오류가 발생합니다. OpenAPI YAML 정책을 구성하는 방법에 대한 자세한 정보는 execute OpenAPI extension을 참조하십시오.
선택 사항: 추가할 요소가 있다면 단계 3.b 부터 3.e 까지의 과정을 반복하십시오.
저장을 클릭하여 변경사항을 저장하십시오.

결과

어셈블리에 하나 이상의 요소를 추가했습니다.