Méthode : admin.projects.locations.topics.subscriptions.list

Répertorie les abonnements associés au sujet spécifié.

Requête HTTP

GET https://{endpoint}/v1/admin/{name=projects/*/locations/*/topics/*}/subscriptions

{endpoint} est l'un des points de terminaison de service compatibles.

Les URL utilisent la syntaxe de transcodage gRPC.

Paramètres de chemin

Paramètres
name

string

Obligatoire. Nom du sujet dont les abonnements doivent être répertoriés.

Paramètres de requête

Paramètres
pageSize

integer

Nombre maximal d'abonnements à afficher. Le service peut renvoyer un nombre inférieur à cette valeur. Si la valeur n'est pas définie ou si elle est nulle, tous les abonnements pour le sujet donné sont renvoyés.

pageToken

string

Jeton de page reçu d'un appel subscriptions.list précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à subscriptions.list doivent correspondre à l'appel ayant fourni le jeton de page.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Réponse pour subscriptions.list.

Représentation JSON

{
  "subscriptions": [
    string
  ],
  "nextPageToken": string
}
Champs
subscriptions[]

string

Noms des abonnements associés au sujet. L'ordre des abonnements n'est pas spécifié.

nextPageToken

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page de résultats suivante. Si ce champ est omis, il n'y a plus de résultats.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/cloud-platform

Pour en savoir plus, consultez la page Présentation de l'authentification.