Elenco dei soggetti

Puoi elencare gli argomenti all'interno di un registro di schema o di un contesto specifici 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 i soggetti, chiedi all'amministratore di concederti il ruolo IAM Managed Kafka Schema Registry Viewer (roles/managedkafka.schemaRegistryViewer) nel registro degli schemi 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 le materie 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.

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

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 dello schema di cui vuoi visualizzare i dettagli.

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

  4. (Facoltativo) Per filtrare i soggetti visualizzati, fai clic su Filtro. 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 che vuoi 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 corrente: 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 schemi.

  • CONTEXT_ID (facoltativo): l'ID del contesto (se elenco di soggetti 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 ha esito positivo, 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 dei soggetti in un array 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 delle sue affiliate negli Stati Uniti e/o in altri paesi.