여러 버전 작업하기 | Qlik Cloud 도움말
기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기

여러 버전 작업하기

마지막 업데이트: 2026. 10. 20.

API 계약을 통해 동일한 API 계약의 여러 버전을 유지 관리할 수 있으므로, 새 버전에서 변경 사항을 준비하는 동안 게시된 버전을 안정적으로 유지할 수 있습니다.

  • 프로덕션에서 기존 API 버전을 유지하면서 새 버전에 호환성을 깨뜨리는 변경 사항을 도입합니다.
  • 단일 위치에서 게시된 버전을 추적하고 관리하세요.
  • 기존 버전에 영향을 주지 않고 API 변경 작업을 수행합니다.

새 버전을 생성하면 모든 콘텐츠가 새 버전으로 복사됩니다.그런 다음 이전 버전에 영향을 주지 않고 최신 버전을 독립적으로 업데이트할 수 있습니다.

최신 버전만 편집할 수 있으며, 해당 버전에서만 새 버전을 생성할 수 있습니다.이전 버전은 읽기 전용입니다.

API 계약 홈페이지에는 사용자가 소유한 모든 API와 사용자에게 공유된 모든 API 버전이 표시됩니다.
API 계약 홈페이지.

새 API 버전 만들기

기존 API 정의의 새 버전을 생성합니다.

정보 메모

참고:

최신 버전에서만 새 버전을 생성할 수 있습니다.이전 버전은 읽기 전용이며 편집하거나 새 버전을 생성하는 데 사용할 수 없습니다.

귀하는 API의 소유자이거나 API의 하나 이상의 버전에 대한 편집자입니다.
  1. 홈페이지에서 새 버전을 생성하려는 API로 이동합니다.
    필요한 경우 이름 또는 소유자별로 목록을 필터링할 수 있습니다.
  2. 최신 버전을 열어 미리보기를 확인한 다음 새 버전 만들기를 클릭합니다.
    Contacts API 및 새 버전 만들기 버튼 보기.
  3. 새 버전을 입력합니다.
  4. 만들기를 클릭합니다.
최신 버전과 동일한 내용으로 API의 새 버전이 생성됩니다.목과 문서는 기본적으로 비활성화되어 있습니다.

Qlik Catalog에 API 버전 게시

API 계약 버전을 Qlik 공간에 게시하여 협업자가 Qlik Catalog에서 찾을 수 있도록 합니다.

귀하는 API의 소유자이거나 API 버전의 편집자입니다.

버전을 게시하면 API 계약에서 계약 버전은 변경할 수 없으며 읽기 전용이 됩니다.변경하려면 최신 버전에서 새 버전을 생성한 후 새 버전에서 작업을 계속 진행하십시오.

  1. 홈페이지에서 게시하려는 버전을 클릭하여 미리보기를 연 다음, 게시를 클릭합니다.
    Contacts API 및 게시 버튼 보기.
  2. 게시 대화 상자에서 버전을 게시할 Qlik 공간을 선택합니다.
  3. 버전 미리보기를 검토하고 게시 메모를 입력합니다.
  4. 게시를 클릭합니다.

선택한 버전은 선택한 Qlik 스페이스에 게시되며 API 계약에서 읽기 전용이 됩니다.계약을 다시 편집해야 하는 경우 먼저 새 버전을 생성하세요.

API 버전 삭제

귀하는 API의 소유자입니다.
  1. 홈페이지에서 삭제하려는 버전 옆의 메뉴 버튼을 클릭하고 삭제를 클릭합니다.
  2. 확인하려면 삭제를 클릭합니다.
선택한 버전이 삭제되었습니다.전체 API를 삭제하려면 각 버전을 삭제해야 합니다.

버전 콘텐츠 가져오기

기존 계약의 콘텐츠를 API 버전으로 가져와 현재 콘텐츠를 대체하거나 병합합니다.

귀하는 API의 소유자이거나 API 버전의 편집자입니다.

이 기능을 사용하여 새 버전을 생성하지 않고 외부 계약 파일에서 버전을 업데이트하십시오.버전 식별자는 가져오기 과정 전반에 걸쳐 유지됩니다.

이는 다음과 다릅니다정의 가져오기. 이렇게 하면 API 계약에 새 API가 생성됩니다.

  1. 업데이트하려는 버전의 버전 콘텐츠 가져오기를 엽니다.

    읽기 전용 버전에서는 이 작업을 사용할 수 없습니다.

    다음 위치에서 이 작업에 액세스할 수 있습니다:

    • 홈페이지에서 버전 옆의 메뉴을 클릭하고 버전 콘텐츠 가져오기를 클릭합니다.
      메뉴 버튼의 버전 콘텐츠 가져오기 옵션.
    • 버전의 미리보기에서 메뉴 > 버전 콘텐츠 가져오기를 클릭합니다.
      버전 상세 보기
    • 버전 편집기에서 편집 > 버전 콘텐츠 가져오기를 클릭합니다.
      버전 편집기의 버전 콘텐츠 가져오기 옵션.
  2. 가져올 계약의 형식과 소스를 선택하십시오.
    로컬 파일, URL 또는 대화 상자에 직접 붙여넣은 텍스트에서 가져올 수 있습니다.
  3. 동작 아래에서 가져온 콘텐츠를 적용할 방법을 선택합니다.
    • 대체: 가져온 계약으로 현재의 모든 콘텐츠를 덮어씁니다.API 이름, 버전 식별자 및 사양 버전이 유지됩니다.
    • 병합: 가져온 콘텐츠를 기존 버전 콘텐츠와 결합합니다.API 이름 및 버전 식별자가 보존됩니다.가져온 요소의 이름이 기존 요소와 동일한 경우, 가져온 요소는 _merge 접미사가 붙어 이름이 변경됩니다(예: User_merge).중복된 기본 URL 및 미디어 유형은 건너뜁니다.
    버전 콘텐츠 가져오기 대화 상자.
  4. 가져오기를 클릭합니다.

업데이트된 콘텐츠가 적용된 상태로 버전 편집기가 열립니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!