Elenco dei soggetti

Puoi elencare gli argomenti all'interno di un registro o di un contesto di schema specifico nel tuo progetto.

Questo documento mostra come elencare gli argomenti utilizzando la consoleGoogle Cloud o l'API Managed Kafka.

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per elencare gli argomenti, chiedi all'amministratore di concederti il ruolo IAM Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) nel registro di schema o nel contesto. 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 soggetti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per elencare gli argomenti sono necessarie le seguenti autorizzazioni:

  • Concedi la seguente autorizzazione nel registro o nel contesto dello schema principale: managedkafka.googleapis.com/subjects.list

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

Elenca i soggetti in un registro di schema

Per elencare tutti gli argomenti in un registro o contesto di schema specifico all'interno del progetto, segui questi passaggi.

Console

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

    Vai a Registri di schema

  2. Fai clic sul nome del registro degli schemi di cui vuoi visualizzare i dettagli.

  3. Nella pagina Dettagli registro di schema, i soggetti sono elencati in Soggetti in questo registro di schema.

  4. (Facoltativo) Per filtrare i soggetti visualizzati, fai clic su Filtra. Puoi filtrare in base alle seguenti proprietà:

    • Nome
    • Contesto
    • Eliminato temporaneamente (sì/no)

  5. (Facoltativo) Per mostrare o nascondere le colonne, fai clic su Opzioni di visualizzazione delle colonne, quindi seleziona le colonne da visualizzare o nascondere.

REST

La richiesta deve essere autenticata con un token di accesso nell'intestazione Authorization. Per ottenere un token di accesso per le credenziali predefinite dell'applicazione correnti: gcloud auth application-default print-access-token.

Per elencare gli argomenti direttamente in un registro di schema, invia una richiesta GET all'URI specifico utilizzando il metodo projects.locations.schemaRegistries.schemas.subjects.list per il contesto predefinito.

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/subjects
Authorization: Bearer $(gcloud auth application-default print-access-token)

Per elencare gli argomenti in un contesto all'interno di un registro di schema, invia una richiesta GET all'URI specifico utilizzando il metodo projects.locations.schemaRegistries.contexts.schemas.subjects.list:

GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/REGISTRY_ID/contexts/CONTEXT_ID/subjects?subjectPrefix=SUBJECT_PREFIX
Authorization: Bearer $(gcloud auth application-default print-access-token)

Sostituisci quanto segue:

  • PROJECT_ID (obbligatorio): il tuo Google Cloud ID progetto.

  • LOCATION (obbligatorio): la Google Cloud regione in cui si trova il registro di schema.

  • REGISTRY_ID (obbligatorio): l'ID del registro dello schema.

  • CONTEXT_ID (facoltativo): l'ID del contesto (se elenco di argomenti all'interno di un contesto).

  • (Facoltativo) SUBJECT_PREFIX: il contesto in base al quale filtrare gli argomenti, nel formato :.{context}:. Se non è impostato, vengono restituiti tutti i soggetti nel registro. Se impostato su una stringa vuota, elenca le materie nel contesto predefinito.

Se la richiesta va a buon fine, l'API restituisce un codice di stato 200 OK. Il corpo della risposta contiene un array JSON di nomi di soggetti.

Di seguito è riportato un esempio di risposta corretta di argomenti in una matrice JSON per il contesto predefinito:

[
  "orders-topic-key",
  "orders-topic-value",
  "user-profile-event"
]

Gli argomenti nei contesti non predefiniti vengono restituiti nel formato :.context:subject.

Per saperne di più, consulta la documentazione del metodo projects.locations.schemaRegistries.contexts.schemas.subjects/list.

Passaggi successivi

Apache Kafka® è un marchio registrato di Apache Software Foundation o dei suoi affiliati negli Stati Uniti e/o in altri paesi.