Elenco delle versioni dell'argomento

Puoi elencare le versioni di un soggetto all'interno di un registro di schema specifico nel tuo progetto.

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

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per elencare le versioni dei soggetti, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore del registro di schemi Managed Kafka (roles/managedkafka.schemaRegistryViewer) nel registro di schemi. 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 le versioni dei soggetti. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per elencare le versioni dell'argomento sono necessarie le seguenti autorizzazioni:

Concedi la seguente autorizzazione per l'argomento principale: managedkafka.versions.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 le versioni dello schema in un soggetto

Per elencare tutte le versioni di un soggetto in un registro di schema specifico all'interno del tuo progetto, segui questi passaggi.

Console

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

Vai a Registri di schema
Fai clic sul nome del registro degli schemi in cui si trova l'argomento.
In Soggetti in questo registro di schema, fai clic sul nome del soggetto.
Nella pagina Dettagli soggetto, le versioni dello schema sono elencate in Tutte le versioni.
(Facoltativo) Per visualizzare la definizione dello schema per una versione, seleziona la casella di controllo per l'ID versione. La definizione dello schema è mostrata in Definizione.
(Facoltativo) Per visualizzare le differenze tra due versioni dello schema per questo soggetto, segui questi passaggi:
1. In Tutte le versioni, seleziona le versioni da confrontare.
2. Nell'area Definizione, fai clic su Visualizza differenze.
Le due definizioni dello schema vengono visualizzate una accanto all'altra, con aggiunte, eliminazioni e modifiche evidenziate.

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 le versioni di un argomento, invia una richiesta GET al metodo projects.locations.schemaRegistries.subjects.versions.list.

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)

Sostituisci quanto segue:

PROJECT_ID: il tuo ID progetto Google Cloud .
LOCATION: la Google Cloud regione in cui si trova il registro degli schemi.
REGISTRY_ID: l'ID del registro degli schemi.
SUBJECT_ID: l'ID del soggetto.

Esempio:

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)

Oppure con un contesto:

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)

Dove:

test-project è l'ID progetto Google Cloud .
us-central1 è la regione Google Cloud in cui si trova il registro di schemi.
test_registry è l'ID del registro degli schemi.
test_context è l'ID del contesto.
test_subject è l'ID del soggetto.

Se la richiesta ha esito positivo, l'API restituisce un codice di stato 200 OK. Il corpo della risposta contiene un array JSON di versioni dell'oggetto.

Di seguito è riportato un esempio di risposta corretta:

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

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

Passaggi successivi

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