모든 스키마 레지스트리 나열

프리뷰

이 제품이나 기능에는 서비스별 약관이 적용됩니다. 정식 버전(GA) 이전 제품과 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

프로젝트의 스키마 레지스트리를 나열할 수 있습니다. 이 문서에서는Google Cloud 콘솔, Google Cloud CLI 또는 관리형 Kafka API를 사용하여 스키마 레지스트리를 나열하는 방법을 보여줍니다.

필수 역할 및 권한

스키마 레지스트리를 나열하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트 및 위치에 대한 관리형 Kafka 스키마 레지스트리 뷰어 (roles/managedkafka.schemaRegistryViewer) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 스키마 레지스트리를 나열하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

스키마 레지스트리를 나열하려면 다음 권한이 필요합니다.

• 상위 위치에 다음 권한을 부여합니다. managedkafka.schemaRegistries.list

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

관리형 Kafka 스키마 레지스트리 편집자(roles/managedkafka.schemaRegistryEditor) 및 관리형 Kafka 스키마 레지스트리 관리자 (roles/managedkafka.schemaRegistryAdmin)와 같은 상위 수준 역할로도 스키마 레지스트리를 나열할 수 있습니다.

사전 정의된 역할에 대한 자세한 내용은 Apache Kafka용 관리형 서비스 사전 정의된 역할을 참고하세요.

스키마 레지스트리 나열

프로젝트 내의 모든 스키마 레지스트리를 나열하려면 다음 단계를 따르세요.

콘솔

1. Google Cloud 콘솔에서 스키마 레지스트리 페이지로 이동합니다.

   스키마 레지스트리로 이동

   페이지에 프로젝트의 스키마 레지스트리 목록이 표시됩니다. 목록에는 다음 속성의 열이 포함됩니다.

   • 이름: 스키마 레지스트리의 고유 식별자입니다.
   • 리전: 스키마 레지스트리가 호스팅되는 Google Cloud 리전입니다.

gcloud

1. Google Cloud CLI를 설치합니다. 설치 후 다음 명령어를 실행하여 Google Cloud CLI를 초기화합니다.

   gcloud init

   외부 ID 공급업체(IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.

2. gcloud beta managed-kafka schema-registries list 명령어를 실행합니다.

gcloud beta managed-kafka schema-registries list \
    --location=LOCATION \

다음을 바꿉니다.

• LOCATION (필수): 스키마 레지스트리를 나열할 Google Cloud 리전입니다.

예를 들어 us-central1 위치의 모든 스키마 레지스트리를 나열하려면 다음 명령어를 실행합니다.

gcloud beta managed-kafka schema-registries list --location=us-central1

샘플 출력:

NAME             LOCATION
sr_docs      us-central1
sr_docs23    us-central1
sr23wert     us-central1

REST

스키마 레지스트리를 나열하려면 projects.locations.schemaRegistries.list 메서드를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트 ID
• LOCATION: 스키마 레지스트리 목록을 가져올 위치입니다(예: us-central1).

HTTP 메서드 및 URL:

GET https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://managedkafka.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/schemaRegistries?view=SCHEMA_REGISTRY_VIEW_FULL" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "schemaRegistries": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID",
      "contexts": [
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/.",
        "projects/PROJECT_ID/locations/LOCATION/REGISTRY_ID/contexts/CONTEXT_NAME"
      ]
    }
}

반환된 JSON 객체에는 지정된 위치에서 발견된 스키마 레지스트리 목록이 포함됩니다. view 쿼리 매개변수가 SCHEMA_REGISTRY_VIEW_FULL인 경우 응답에는 각 스키마 레지스트리와 연결된 컨텍스트도 포함됩니다.

Apache Kafka®는 미국 및/또는 다른 국가에서 사용되는 Apache Software Foundation 또는 해당 계열사의 등록 상표입니다.