버전 관리

이 페이지는 ApigeeApigee Hybrid에 적용됩니다.

API 허브의 모든 API가 여러 버전을 가질 수 있고 각 버전은 여러 버전을 포함할 수 있는 사양을 포함할 수 있습니다. API 페이지의 기록 탭에는 모든 API 버전 간의 모든 사양 버전이 나열되어 있습니다.

기록 탭, 큰 이미지를 보려면 클릭
API 레지스트리 스키마 보기

다음은 API 허브 API, 버전, 배포, 사양 간의 관계를 보여줍니다.

alt_text
참조 항목 설명
레지스트리 레지스트리는 API 카탈로그 역할을 수행하는 API 모음입니다.
버전 API는 여러 버전을 포함할 수 있습니다. 버전은 클라이언트가 API 호출을 위해 사용할 수 있는 안정적인 인터페이스에 해당합니다. 이러한 버전 중 하나를 권장 버전으로 지정할 수 있습니다. semver의 경우 이러한 버전을 주 버전으로 이해하는 것이 좋습니다.
배포 API에는 여러 스테이징 환경 또는 리전과 같은 여러 배포가 포함될 수 있습니다. 배포는 사용자가 API를 호출할 수 있는 위치(주소)입니다. 이러한 배포 중 하나를 권장 배포로 지정할 수 있습니다.
사양 API 버전을 공식 사양으로 설명하는 것이 좋으며(필수는 아님), 여러 API 사양 형식을 사용하는 경우가 많습니다. 이러한 사양 형식 중 하나가 기본 형식일 수 있으며, 이는 이 버전의 다른 사양에서 파생됨을 나타냅니다.
버전
  • 배포는 업데이트 기록을 갖습니다. 배포 버전은 배포의 특정 인스턴스를 나타내며, 배포가 제공하는 API 구현이 변경된 경우 하나 이상의 사양 버전을 참조할 수 있습니다.
  • 사양에는 업데이트 기록이 포함됩니다. 사양 버전은 사양의 후속 인스턴스를 나타내며 일반적으로 사양 콘텐츠에 대한 브레이킹 체인지가 아닌 다른 변경사항을 나타냅니다. semver의 경우 버전은 부 버전 또는 포인트 버전에 해당할 수 있습니다.

버전 테이블 정렬

테이블을 정렬하려면 업데이트 열 제목을 클릭합니다.

버전 추가

버전을 추가하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 API 허브 페이지로 이동합니다.

    API 허브로 이동

    기본적으로 API 목록 페이지가 표시됩니다.

  2. API 목록에서 API 행을 클릭합니다. 개요 탭이 기본적으로 표시됩니다.
  3. 기록 탭을 선택합니다.
  4. 버전 추가를 클릭합니다.
  5. 찾아보기를 클릭한 후 설명 문서 또는 ZIP 파일을 선택합니다.
  6. 열기를 클릭합니다.
  7. 세부정보를 지정합니다.
    • API 버전을 선택합니다.
    • MIME 유형 선택 기타를 선택하면 MIME 유형을 수동으로 지정할 수 있는 텍스트 필드가 표시됩니다.
    • 커밋 메시지를 입력합니다(선택사항).
    • 커밋 해시를 입력합니다(선택사항).
  8. 저장 또는 취소를 클릭합니다.

버전 보기

사양 보기 또는 다운로드를 참조하세요.

버전 삭제

버전을 삭제하려면 다음 안내를 따르세요.

  1. Cloud 콘솔에서 API 허브 페이지로 이동합니다.

    API 허브로 이동

    기본적으로 API 목록 페이지가 표시됩니다.

  2. API 목록에서 API 행을 클릭합니다. 개요 탭이 기본적으로 표시됩니다.
  3. 기록 탭을 선택합니다.
  4. 원하는 버전 옆에 있는 삭제를 클릭합니다.
  5. 프롬프트에서 삭제(또는 취소)를 클릭합니다.