Répertorier les fournisseurs d'événements

Un fournisseur Eventarc est un service ou une entité pouvant directement envoyer à Google Cloud des événements qui sont ensuite acheminés vers votre projet.

Les fournisseurs propriétaires sont des sources Google Cloud. Par exemple, Cloud Storage. Les fournisseurs tiers sont des entités autres que Google Cloud qui proposent une source Eventarc.

Vous pouvez lister tous les fournisseurs et récupérer leurs détails, y compris les types d'événements compatibles, en exécutant les commandes gcloud avec les options obligatoires, ainsi que des options facultatives.

Prérequis

Avant d'exécuter les commandes gcloud, assurez-vous d'avoir effectué les opérations suivantes :

  1. Définissez l'ID du projet Google Cloud.

    gcloud config set project PROJECT_ID

    Remplacez PROJECT_ID par l'ID de votre projet Google Cloud.

    Vous pouvez trouver l'ID de votre projet sur la page de Bienvenue de la console Google Cloud.

  2. Activez l'API Eventarc :

    gcloud services enable eventarc.googleapis.com

Lister tous les fournisseurs pour un emplacement spécifique

Pour lister tous les fournisseurs d'un emplacement spécifique :

gcloud eventarc providers list \
    --location=LOCATION

Remplacez LOCATION par une région Eventarc compatible.

Par exemple : gcloud eventarc providers list --location=us-central1

Le résultat ressemble à ce qui suit :

NAME                       LOCATION
bigquery.googleapis.com    us-central1
cloudbuild.googleapis.com  us-central1
storage.googleapis.com     us-central1
workflows.googleapis.com   us-central1
[...]

Lister tous les fournisseurs pour tous les emplacements

Pour lister tous les fournisseurs de tous les emplacements :

gcloud eventarc providers list

Le résultat ressemble à ce qui suit :

NAME                       LOCATION
workflows.googleapis.com   asia-northeast3
pubsub.googleapis.com      europe-west3
storage.googleapis.com     nam4
bigquery.googleapis.com    us-central1
cloudbuild.googleapis.com  us-central1
storage.googleapis.com     us-central1
workflows.googleapis.com   us-central1
storage.googleapis.com     us-east1
[...]

Lister un fournisseur spécifique pour tous les emplacements

Pour lister un fournisseur spécifique dans tous les emplacements :

gcloud eventarc providers list \
    --name=PROVIDER

Remplacez PROVIDER par le nom du fournisseur.

Par exemple : gcloud eventarc providers list --name=storage.googleapis.com

Le résultat ressemble à ce qui suit :

NAME                    LOCATION
storage.googleapis.com  nam4
storage.googleapis.com  us-central1
storage.googleapis.com  us-east1

Répertorier tous les fournisseurs tiers dans n'importe quel emplacement

Pour répertorier tous les fournisseurs tiers de n'importe quel emplacement, procédez comme suit :

gcloud eventarc providers list --filter='eventTypes.type!~^google*'

Le résultat est une liste de tous les fournisseurs tiers.

Décrire un fournisseur spécifique et ses types d'événements acceptés

Pour décrire un fournisseur spécifique et ses types d'événements acceptés :

  gcloud eventarc providers describe PROVIDER \
      --location=LOCATION

Remplacez les éléments suivants :

  • PROVIDER : nom d'un fournisseur spécifique.
  • LOCATION : une région Eventarc compatible.

Par exemple : gcloud eventarc providers describe storage.googleapis.com --location=us-central1

Le résultat ressemble à ce qui suit :

displayName: Cloud Storage
eventTypes:
- description: 'The live version of an object has become a noncurrent version, either
    because it was explicitly made noncurrent or because it was replaced by the upload
    of an object of the same name. Only sent when a bucket has enabled object versioning. '
  filteringAttributes:
  - attribute: bucket
    description: The bucket name being watched.
    required: true
  - attribute: type
    required: true
  type: google.cloud.storage.object.v1.archived
[...]

Notez le type d'événement à utiliser lors de la création d'un déclencheur Eventarc.