Elenca le revisioni dello schema per un argomento

Questo documento mostra come elencare le revisioni di uno schema per gli argomenti Pub/Sub.

Prima di iniziare

Ruoli e autorizzazioni richiesti

Per ottenere le autorizzazioni necessarie per elencare le revisioni dello schema e gestirle, chiedi all'amministratore di concederti il ruolo IAM Pub/Sub Editor (roles/pubsub.editor) nel progetto. 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 revisioni dello schema e gestirle. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per elencare le revisioni dello schema e gestirle sono necessarie le seguenti autorizzazioni:

  • Crea schema: pubsub.schemas.create
  • Allega schema all'argomento: pubsub.schemas.attach
  • Esegui il commit di una revisione dello schema: pubsub.schemas.commit
  • Elimina uno schema o una revisione dello schema: pubsub.schemas.delete
  • Ottieni uno schema o le revisioni dello schema: pubsub.schemas.get
  • Elenca schemi: pubsub.schemas.list
  • Elenca revisioni dello schema: pubsub.schemas.listRevisions
  • Esegui il rollback di uno schema: pubsub.schemas.rollback
  • Convalida un messaggio: pubsub.schemas.validate
  • Ottieni la policy IAM per uno schema: pubsub.schemas.getIamPolicy
  • Configura la policy IAM per uno schema: pubsub.schemas.setIamPolicy

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

Puoi concedere ruoli e autorizzazioni a entità come utenti, gruppi, domini o service account. Puoi creare uno schema in un progetto e allegarlo a un argomento che si trova in un altro progetto. Assicurati di disporre delle autorizzazioni necessarie per ogni progetto.

Elenca le revisioni di uno schema

Puoi elencare le revisioni di uno schema in un Google Cloud progetto utilizzando la Google Cloud console, gcloud CLI, l'API Pub/Sub, o le librerie client di Cloud.

Console

  1. Nellaconsole, vai alla pagina Schemi Pub/Sub. Google Cloud

    Vai a Schemi

    Viene visualizzato l'elenco degli schemi.

  2. Fai clic sul nome dello schema che vuoi visualizzare.

    Viene visualizzata la pagina Dettagli schema per lo schema.

    Nella sezione Revisioni puoi visualizzare l'elenco delle revisioni disponibili per lo schema.

gcloud

Per visualizzare l'ultima revisione di uno schema:

gcloud pubsub schemas list-revisions SCHEMA_ID

Utilizza il gcloud pubsub schemas list-revisions <var>SCHEMA_ID</var> --view=FULL comando per visualizzare le definizioni delle revisioni dello schema.

REST

Per elencare le revisioni dello schema, invia una richiesta GET come la seguente:

GET https://pubsub.googleapis.com/v1/projects/SCHEMA_NAME:listRevisions

In caso di esito positivo, il corpo della risposta contiene un oggetto JSON contenente tutte le revisioni dello schema.

C++

Prima di provare questo esempio, segui le istruzioni di configurazione di C++ in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub C++ . 

namespace pubsub = ::google::cloud::pubsub;
[](pubsub::SchemaServiceClient client, std::string const& project_id,
   std::string const& schema_id) {
  auto const parent = pubsub::Schema(project_id, schema_id).FullName();
  for (auto& s : client.ListSchemaRevisions(parent)) {
    if (!s) throw std::move(s).status();
    std::cout << "Schema revision: " << s->DebugString() << "\n"