이 문서에서는 Apache Kafka용 관리형 서비스 내에서 스키마 레지스트리 리소스의 세부정보를 보는 방법을 보여줍니다. 구성, 연결된 컨텍스트, 주제와 같은 세부정보를 볼 수 있습니다.
오픈소스 Apache Kafka 클라이언트 API를 사용하여 이러한 특정 Apache Kafka용 관리형 서비스 스키마 레지스트리 리소스 세부정보를 볼 수는 없습니다.
필수 역할 및 권한
스키마 레지스트리를 보는 데 필요한 권한을 얻으려면 관리자에게 스키마 레지스트리 인스턴스에 대한 관리형 Kafka 스키마 레지스트리 뷰어 (roles/managedkafka.schemaRegistryViewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 스키마 레지스트리를 보는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
스키마 레지스트리를 보려면 다음 권한이 필요합니다.
-
스키마 레지스트리 리소스에 이 권한을 부여합니다.
managedkafka.schemaRegistries.get
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
Apache Kafka용 관리형 서비스에 사용할 수 있는 사전 정의된 역할에 대한 자세한 내용은 액세스 제어 문서를 참고하세요.
스키마 레지스트리 세부정보 보기
특정 스키마 레지스트리의 구성과 세부정보를 가져오려면 다음 단계를 따르세요.
콘솔
- Google Cloud 콘솔에서 스키마 레지스트리 페이지로 이동합니다.
프로젝트의 스키마 레지스트리 목록이 표시됩니다.
- 세부정보를 보려는 스키마 레지스트리의 이름을 클릭합니다.
스키마 레지스트리 세부정보 페이지가 열립니다. 이 페이지에 표시되는 정보는 스키마 레지스트리 페이지 세부정보 섹션에 설명되어 있습니다.
gcloud
-
Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.
gcloud init외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
- 특정 스키마 레지스트리의 구성과 세부정보를 가져오려면
gcloud beta managed-kafka schema-registries describe명령어를 실행합니다. - SCHEMA_REGISTRY_ID (필수): 설명할 스키마 레지스트리의 ID입니다.
- LOCATION (필수사항): 스키마 레지스트리가 있는 Google Cloud 리전입니다.
gcloud beta managed-kafka schema-registries describe SCHEMA_REGISTRY_ID \ --location=LOCATION \
다음을 바꿉니다.
예를 들어 다음 명령어는 us-central1 리전에 있는 test_SR라는 스키마 레지스트리의 세부정보를 가져옵니다.
gcloud beta managed-kafka schema-registries describe test_SR \ --location=us-central1
이 명령어는 다음과 유사한 출력을 반환합니다.
Describing schema registry: projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR name: projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR mode: READWRITE config: - compatibility: BACKWARD contexts: - projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR/contexts/. - projects/test-pubsub/locations/us-central1/schemaRegistries/test_SR/contexts/user-record
REST
- REST API를 사용하여 특정 스키마 레지스트리 인스턴스의 세부정보를 가져오려면 다음 URI에
GET요청을 수행하세요. - PROJECT_ID (필수): Google Cloud 프로젝트 ID입니다.
- LOCATION (필수사항): 스키마 레지스트리가 있는 리전입니다.
- SCHEMA_REGISTRY_ID (필수): 보려는 스키마 레지스트리의 고유 ID입니다.
GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID Authorization: Bearer $(gcloud auth application-default print-access-token)
다음을 바꿉니다.
요청이 성공하면 API가 200 OK 상태 코드를 반환합니다. 응답 본문에는 요청된 스키마 레지스트리의 세부정보를 나타내는 JSON 객체가 포함됩니다.
예를 들어 다음은 us-central1 리전에 있는 gcloud_test라는 스키마 레지스트리의 세부정보를 가져오는 명령어에 대한 응답입니다.
{ "name": "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test", "contexts": [ "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test/contexts/default", "projects/testing-311516/locations/us-central1/schemaRegistries/gcloud_test/contexts/." ] }
자세한 내용은 REST API 문서를 참고하세요.
스키마 레지스트리 페이지 세부정보
Google Cloud 콘솔에서 스키마 레지스트리를 보면 스키마 레지스트리 세부정보 페이지에 선택한 레지스트리에 대한 다음 정보가 표시됩니다.
- 리전: 레지스트리가 있는 Google Cloud 리전입니다.
- 스키마 레지스트리 URL: 스키마 레지스트리의 엔드포인트 URL입니다. 형식은
https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID입니다.예:
https://managedkafka.googleapis.com/v1main/projects/managed-kafka-project/locations/us-central1/schemaRegistries/testschemaregistry - 스키마 모드: 스키마 레지스트리 수준 및 개별 주제 수준에서 설정할 수 있는 작동 모드입니다. 이 설정은 수정 가능 여부를 제어합니다.
- 호환성 유형: 이 레지스트리 내의 새 주제 또는 스키마 버전에 적용되는 기본 호환성 설정의 레지스트리 수준 구성입니다 (주제 또는 컨텍스트 수준에서 재정의되지 않는 한).
일반적인 값은
BACKWARD,FORWARD,FULL또는NONE입니다. - 이 스키마 레지스트리의 주제: 레지스트리와 연결된 주제 이름 목록입니다. 컨텍스트를 사용할 수 있는 경우 각 주제의 컨텍스트도 볼 수 있습니다.