Elenca tutti i registri di schemi

Anteprima

Questo prodotto o funzionalità è soggetto ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini di servizio specifici. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni delle fasi di lancio.

Puoi elencare i registri di schemi nel tuo progetto. Questo documento mostra come elencare i registri di schema utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API Managed Kafka.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per elencare i registri di schema, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore del registro di schema Kafka gestito (roles/managedkafka.schemaRegistryViewer) nel progetto e nella località. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per elencare i registri di schemi. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per elencare i registri dello schema sono necessarie le seguenti autorizzazioni:

• Concedi la seguente autorizzazione nella posizione genitore: managedkafka.schemaRegistries.list

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

I ruoli di livello superiore come Editor del registro di schema Kafka gestito (roles/managedkafka.schemaRegistryEditor) e Amministratore del registro di schema Kafka gestito (roles/managedkafka.schemaRegistryAdmin) consentono anche di elencare i registri di schema.

Per ulteriori informazioni sui ruoli predefiniti, consulta la pagina Ruoli predefiniti di Managed Service per Apache Kafka.

Elenca i registri di schemi

Per elencare tutti i registri di schema all'interno del progetto, segui questi passaggi.

Console

1. Nella console Google Cloud , vai alla pagina Registri di schemi.

   Vai ai registri di schemi

   La pagina mostra un elenco dei registri di schema nel progetto. L'elenco include colonne per le seguenti proprietà:

   • Nome: l'identificatore univoco del registro degli schemi.
   • Regione: la Google Cloud regione in cui è ospitato il registro di schemi.

gcloud

1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il comando seguente:

   gcloud init

   Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

2. Esegui il comando gcloud beta managed-kafka schema-registries list:

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

Sostituisci quanto segue:

• LOCATION (obbligatorio): la regione Google Cloud per cui elencare i registri di schema.

Ad esempio, per elencare tutti i registri di schema nella località us-central1, esegui questo comando:

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

Esempio di output:

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

REST

Per elencare i registri degli schemi, utilizza il metodo projects.locations.schemaRegistries.list.

Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

• PROJECT_ID: il tuo Google Cloud ID progetto
• LOCATION: la località in cui vuoi ottenere l'elenco dei registri di schemi, ad esempio us-central1

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$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

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "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"
      ]
    }
}

L'oggetto JSON restituito include un elenco dei registri dello schema trovati nella posizione specificata. Se il parametro di query view è SCHEMA_REGISTRY_VIEW_FULL, la risposta include anche i contesti associati a ogni registro dello schema.

Apache Kafka® è un marchio registrato di Apache Software Foundation o delle sue affiliate negli Stati Uniti e/o in altri paesi.