Questo documento descrive come elencare un argomento Pub/Sub. Per elencare un argomento, puoi utilizzare la console Google Cloud , gcloud CLI, la libreria client o l'API Pub/Sub.
Prima di iniziare
- Scopri di più sugli argomenti e sul flusso di lavoro per la pubblicazione dei messaggi.
- Crea un argomento.
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni
necessarie per elencare gli argomenti e gestirli,
chiedi all'amministratore di concederti il
ruolo IAM Editor Pub/Sub(roles/pubsub.editor
)
nell'argomento o nel progetto.
Per saperne di più sull'assegnazione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per elencare gli argomenti e gestirli. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per elencare gli argomenti e gestirli sono necessarie le seguenti autorizzazioni:
-
Crea un argomento:
pubsub.topics.create
-
Eliminare un argomento:
pubsub.topics.delete
-
Scollega un abbonamento da un argomento:
pubsub.topics.detachSubscription
-
Trovare un argomento:
pubsub.topics.get
-
Elenca un argomento:
pubsub.topics.list
-
Pubblica in un argomento:
pubsub.topics.publish
-
Aggiorna un argomento:
pubsub.topics.update
-
Recupera il criterio IAM per un argomento:
pubsub.topics.getIamPolicy
-
Configura il criterio IAM per un argomento:
pubsub.topics.setIamPolicy
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Puoi configurare il controllo dell'accesso a livello di progetto e a livello di singola risorsa. Puoi creare una sottoscrizione in un progetto e collegarla a un argomento che si trova in un altro progetto. Assicurati di disporre delle autorizzazioni necessarie per ogni progetto.
Elencare un argomento
Console
Nella console Google Cloud , vai alla pagina Argomenti di Pub/Sub.
La pagina Argomenti elenca tutti gli argomenti disponibili.
Per impostazione predefinita, la console restituisce 50 argomenti. Puoi aumentare questo valore per restituire un massimo di 200 argomenti utilizzando il menu a discesa Righe per pagina. Questo pulsante di attivazione/disattivazione viene visualizzato nella console solo se un progetto contiene più di 20 argomenti.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Per elencare gli argomenti, utilizza il comando
gcloud pubsub topics list
:gcloud pubsub topics list
Per impostazione predefinita, vengono restituiti al massimo 100 risultati per query.
Puoi specificare un valore alternativo fino a 1000 utilizzando il parametro delle dimensioni della pagina.
Ad esempio, utilizzando Google Cloud CLI, specifica --page-size=1000
.
REST
Per elencare gli argomenti, utilizza il metodo
projects.topics.list
:
Richiesta:
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
.
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics Authorization: Bearer ACCESS_TOKEN
Dove:
Risposta:
{ "topics": [ { "name": "projects/PROJECT_ID/topics/mytopic1", ... }, { "name": "projects/PROJECT_ID/topics/mytopic2", ... } ] }
C++
Prima di provare questo esempio, segui le istruzioni di configurazione di C++ nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub C++.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub C#.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Go.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Java.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione di PHP nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub PHP.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Python.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida di Pub/Sub per l'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Ruby.
Per eseguire l'autenticazione in Pub/Sub, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Passaggi successivi
Scegli il tipo di abbonamento per l'argomento.
Crea una sottoscrizione per l'argomento: pull, push o BigQuery.
Crea o modifica un argomento con gcloud CLI.
Crea o modifica un argomento con le API REST.