이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.
분류는 API를 정리하는 방법과 API 메타데이터를 정의할 수 있는 유연한 옵션을 제공합니다. 시스템에 정의된 분류는 특정 정보의 분류 옵션을 제공하는 이름이 지정된 값 목록입니다. 분류 설정 페이지를 통해 시스템에서 사용할 수 있는 다양한 분류를 보고 관리할 수 있습니다.
시스템 분류는 API 허브에서 특별한 의미를 갖는 값을 정의하며, UI에서 특별한 방식으로 표시되거나 동작을 지시할 수 있습니다. 시스템 분류는 시스템에 의해 사전 정의되며 변경 또는 확장 방법이 더 제한적입니다. 그러나 값 목록은 어느 정도 수정할 수 있습니다.
커스텀 분류는 API에 연결할 커스텀 정보를 정의합니다. 관리자 권한이 있는 경우 원하는 방식으로 이 목록을 만들고 수정할 수 있습니다.
대부분의 분류는 배타적이며 라벨은 항목을 겹치지 않는 (단일 선택) 컬렉션으로 그룹화합니다. 하지만 필요한 경우 단일 객체에 여러 라벨을 할당할 수 있도록 분류를 구성할 수 있습니다. 이러한 다중 선택 분류는 구성에서 다음과 같이 표시됩니다.
사전 정의된 시스템 분류
다음과 같은 사전 정의된 시스템 분류는 삭제할 수 없으며 구성의 특정 부분을 수정할 수 없습니다. 사전 정의된 시스템 분류 중 일부는 사전 정의된 요소도 지정합니다.
- 대상 사용자: API의 대상 사용자(소비자)(다중 선택 가능)
- 스타일(기본): API의 기본 아키텍처 스타일(단일 선택만 가능)
- 팀: API를 담당하는 프로덕션팀(단일 선택만 가능)
- 사업부: API를 담당하는 사업부(단일 선택만 가능)
- 게이트웨이: API를 제공하고 보호하는 데 사용되는 프록시(단일 선택만 가능)
커스텀 분류
커스텀 분류는 API에 커스텀 정보를 연결하는 방법을 제공합니다. 예를 들면 다음과 같습니다.
- 승인: 규정 준수 또는 규제 대상 등의 상태 검토
- 주제:재무 또는 HR 등의 주제별 API 분류
- 속성: PII 포함 등의 API 특성
- 제품: API가 지원하도록 설계된 소비자 제품
분류 추가
분류를 추가하려면 다음 안내를 따르세요.
- Google Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.
- 커스텀 분류 추가를 클릭합니다.
- 다음 사항을 지정합니다.
- 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로 표시됩니다.
- 요소 추가를 클릭하여 다른 요소를 추가합니다.
- ID: API 리소스의 식별자입니다. ID는 소문자, 숫자, 하이픈만 포함할 수 있습니다. ID는 프로젝트에서 고유해야 합니다. ID는 4~63자여야 합니다. 분류가 생성된 후에는 ID를 변경할 수 없습니다. 예를 들어 API 리소스 이름
- 저장(또는 취소)을 클릭합니다.
분류 수정
분류를 수정하려면 다음 안내를 따르세요.
- Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.
- 시스템 분류 옆의 있는 수정을 클릭하거나 더보기 > 커스텀 분류 옆의 수정을 클릭합니다.
필요에 따라 수정합니다. 시스템 분류의 모든 필드를 수정할 수 있는 것은 아닙니다. 자세한 내용은 사전 정의된 시스템 분류를 참조하세요.
- 저장(또는 취소)을 클릭합니다.
분류 삭제
분류를 삭제하려면 다음 안내를 따르세요.
- Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.
원하는 분류 옆의
더보기 > 삭제 를 클릭합니다.- 확인 메시지에서 삭제(또는 취소)를 클릭합니다.
분류 목록 재정렬
분류를 재정렬하여 API 필터 창과 API 개요 페이지에 분류가 표시되는 순서를 결정할 수 있습니다.
분류 목록을 재정렬하려면 다음 안내를 따르세요.
- Cloud 콘솔에서 API 허브, 설정, 분류 페이지로 이동합니다.
- 수명 주기가 원하는 위치에 올 때까지 위쪽 또는 아래쪽 화살표를 클릭합니다.