분류 관리

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

분류는 API를 정리하는 방법과 API 메타데이터를 정의할 수 있는 유연한 옵션을 제공합니다. 시스템에 정의된 분류는 특정 정보의 분류 옵션을 제공하는 이름이 지정된 값 목록입니다. 분류 설정 페이지를 통해 시스템에서 사용할 수 있는 다양한 분류를 보고 관리할 수 있습니다.

분류 탭, 큰 이미지를 보려면 클릭

시스템 분류는 API 허브에서 특별한 의미를 갖는 값을 정의하며, UI에서 특별한 방식으로 표시되거나 동작을 지시할 수 있습니다. 시스템 분류는 시스템에 의해 사전 정의되며 변경 또는 확장 방법이 더 제한적입니다. 그러나 값 목록은 어느 정도 수정할 수 있습니다.

커스텀 분류는 API에 연결할 커스텀 정보를 정의합니다. 관리자 권한이 있는 경우 원하는 방식으로 이 목록을 만들고 수정할 수 있습니다.

대부분의 분류는 배타적이며 라벨은 항목을 겹치지 않는 (단일 선택) 컬렉션으로 그룹화합니다. 하지만 필요한 경우 단일 객체에 여러 라벨을 할당할 수 있도록 분류를 구성할 수 있습니다. 이러한 다중 선택 분류는 구성에서 다음과 같이 표시됩니다.

사전 정의된 시스템 분류

다음과 같은 사전 정의된 시스템 분류는 삭제할 수 없으며 구성의 특정 부분을 수정할 수 없습니다. 사전 정의된 시스템 분류 중 일부는 사전 정의된 요소도 지정합니다.

  • 대상 사용자: API의 대상 사용자(소비자)(다중 선택 가능)
  • 스타일(기본): API의 기본 아키텍처 스타일(단일 선택만 가능)
  • 팀: API를 담당하는 프로덕션팀(단일 선택만 가능)
  • 사업부: API를 담당하는 사업부(단일 선택만 가능)
  • 게이트웨이: API를 제공하고 보호하는 데 사용되는 프록시(단일 선택만 가능)

커스텀 분류

커스텀 분류는 API에 커스텀 정보를 연결하는 방법을 제공합니다. 예를 들면 다음과 같습니다.

  • 승인: 규정 준수 또는 규제 대상 등의 상태 검토
  • 주제:재무 또는 HR 등의 주제별 API 분류
  • 속성: PII 포함 등의 API 특성
  • 제품: API가 지원하도록 설계된 소비자 제품

분류 추가

분류를 추가하려면 다음 안내를 따르세요.

  1. Google Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.

    API 허브 분류로 이동

  2. 커스텀 분류 추가를 클릭합니다.
  3. 다음 사항을 지정합니다.
    • ID: API 리소스의 식별자입니다. ID는 소문자, 숫자, 하이픈만 포함할 수 있습니다. ID는 프로젝트에서 고유해야 합니다. ID는 4~63자여야 합니다. 분류가 생성된 후에는 ID를 변경할 수 없습니다. 예를 들어 API 리소스 이름 projects/my-project/locations/global/apis/my-api의 경우 리소스 ID는 my-api입니다.
    • 이름: 분류의 표시 이름입니다.
    • 설명: 분류에 대한 간단한 설명입니다.
    • 옵션:
      • 단일 선택으로 제한: 이 옵션을 선택하면 한 번에 하나의 분류 값만 API에 적용할 수 있습니다. API에 이미 여러 값을 적용했고 이 옵션이 사용 설정되어 있으면 여러 개로 유지됩니다.
      • 검색 필터에서 제외: 이 옵션을 선택하면 필터 창에 이 분류가 표시되지 않습니다.
    • 분류 요소: 분류에 사용할 수 있는 값을 정의하는 이름, 설명 또는 URL 쌍의 목록입니다.
      • 이름: 분류 표시 이름을 기준으로 이름이 자동으로 생성됩니다. 이 이름은 개요 페이지의 정보 아이콘 위로 마우스를 가져가면 표시됩니다.
      • URL: URL을 입력하면 분류 요소가 URL로 표시됩니다.
      • 요소 추가를 클릭하여 다른 요소를 추가합니다.
  4. 저장(또는 취소)을 클릭합니다.

분류 수정

분류를 수정하려면 다음 안내를 따르세요.

  1. Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.

    API 허브 분류로 이동

  2. 시스템 분류 옆의 있는 수정을 클릭하거나 더보기 > 커스텀 분류 옆의 수정을 클릭합니다.
  3. 필요에 따라 수정합니다. 시스템 분류의 모든 필드를 수정할 수 있는 것은 아닙니다. 자세한 내용은 사전 정의된 시스템 분류를 참조하세요.

  4. 저장(또는 취소)을 클릭합니다.

분류 삭제

분류를 삭제하려면 다음 안내를 따르세요.

  1. Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.

    API 허브 분류로 이동

  2. 원하는 분류 옆의 더보기 > 삭제 를 클릭합니다.

  3. 확인 메시지에서 삭제(또는 취소)를 클릭합니다.

분류 목록 재정렬

분류를 재정렬하여 API 필터 창과 API 개요 페이지에 분류가 표시되는 순서를 결정할 수 있습니다.

분류 목록을 재정렬하려면 다음 안내를 따르세요.

  1. Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.

    API 허브 분류로 이동

  2. 수명 주기가 원하는 위치에 올 때까지 위쪽 또는 아래쪽 화살표를 클릭합니다.