프로젝트의 특정 스키마 레지스트리 내에서 주제의 버전을 나열할 수 있습니다.
이 문서에서는Google Cloud 콘솔 또는 관리형 Kafka API를 사용하여 주제 버전을 나열하는 방법을 보여줍니다.
필수 역할 및 권한
주제 버전을 나열하는 데 필요한 권한을 얻으려면 관리자에게 스키마 레지스트리에 대한 관리형 Kafka 스키마 레지스트리 뷰어 (roles/managedkafka.schemaRegistryViewer) IAM 역할을 부여해 달라고 요청하세요.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이 사전 정의된 역할에는 주제 버전을 나열하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.
필수 권한
주제 버전을 나열하려면 다음 권한이 필요합니다.
-
상위 주제에 다음 권한을 부여합니다.
managedkafka.versions.list
커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.
사전 정의된 역할에 대한 자세한 내용은 Apache Kafka용 관리형 서비스 사전 정의된 역할을 참고하세요.
주제의 스키마 버전 나열
프로젝트 내 특정 스키마 레지스트리의 모든 주제 버전을 나열하려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 스키마 레지스트리 페이지로 이동합니다.
주제가 있는 스키마 레지스트리의 이름을 클릭합니다.
Subjects in this schema registry(이 스키마 레지스트리의 제목)에서 제목 이름을 클릭합니다.
주체 세부정보 페이지의 모든 버전 아래에 스키마 버전이 나열됩니다.
선택사항: 버전의 스키마 정의를 보려면 버전 ID의 체크박스를 선택합니다. 스키마 정의는 정의에 표시됩니다.
선택사항: 이 주제의 스키마 버전 간 차이점을 보려면 다음 단계를 따르세요.
- 모든 버전에서 비교할 버전을 선택합니다.
- 정의 영역에서 차이점 보기를 클릭합니다.
두 스키마 정의가 나란히 표시되며 추가, 삭제, 변경사항이 강조 표시됩니다.
REST
Authorization 헤더의 액세스 토큰으로 요청을 인증해야 합니다. 현재 애플리케이션 기본 사용자 인증 정보의 액세스 토큰을 얻으려면 gcloud auth application-default print-access-token을 실행합니다.
주체 버전을 나열하려면 projects.locations.schemaRegistries.subjects.versions.list 메서드에 GET 요청을 실행합니다.
GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects/SUBJECT_ID/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)
다음을 바꿉니다.
- PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- LOCATION: 스키마 레지스트리가 있는 Google Cloud 리전입니다.
- REGISTRY_ID: 스키마 레지스트리의 ID입니다.
- SUBJECT_ID: 주제의 ID입니다.
예:
GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)
또는 컨텍스트를 사용합니다.
GET https://managedkafka.googleapis.com/v1main/projects/test-project/locations/us-central1/schemaRegistries/test_registry/contexts/test_context/subjects/test_subject/versions
Authorization: Bearer $(gcloud auth application-default print-access-token)
각 항목의 의미는 다음과 같습니다.
test-project는 Google Cloud 프로젝트 ID입니다.us-central1은 스키마 레지스트리가 있는 Google Cloud 리전입니다.test_registry는 스키마 레지스트리의 ID입니다.test_context은 컨텍스트의 ID입니다.test_subject는 주제의 ID입니다.
요청이 성공하면 API가 200 OK 상태 코드를 반환합니다. 응답 본문에는 주제 버전의 JSON 배열이 포함됩니다.
다음은 성공적인 응답의 샘플입니다.
{
"versions": [
{
"name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/1",
"revisionId": "1a2b3c4d",
"schemaId": "S12345",
"createTime": "2024-07-15T12:00:00Z",
"revisionCreateTime": "2024-07-15T12:00:00Z"
},
{
"name": "projects/test-project/locations/us-central1/schemaRegistries/test_registry/subjects/test_subject/versions/2",
"revisionId": "5e6f7g8h",
"schemaId": "S67890",
"createTime": "2024-07-16T14:30:00Z",
"revisionCreateTime": "2024-07-16T14:30:00Z"
}
]
}
자세한 내용은 projects.locations.schemaRegistries.subjects.versions.list 메서드 문서를 참조하세요.