Publier des événements à partir de sources Google

Console

Activer les API

gcloud

gcloud services enable eventarc.googleapis.com eventarcpublishing.googleapis.com

Console

1. Dans la console Google Cloud , accédez à la page Eventarc > Bus.

   Accéder à Bus

2. Vous pouvez créer un bus ou, si vous mettez à jour un bus, cliquez sur edit Modifier.

3. Sur la page Modifier le bus, pour ajouter une source de message, cliquez sur add Ajouter une source.

   1. Dans le volet Ajouter une source de message, pour le fournisseur de messages de l'API Google, acceptez la valeur par défaut google-api-source ou saisissez un autre nom de source de message.
   2. Cliquez sur Créer.

4. Cliquez sur Enregistrer.

gcloud

1. Ouvrez un terminal.

2. Vous pouvez activer les événements provenant de sources Google à l'aide de la commande gcloud beta eventarc google-api-sources create :

   gcloud beta eventarc google-api-source create GOOGLE_API_SOURCE_NAME \
       --destination-message-bus=BUS_NAME \
       --destination-message-bus-project=BUS_PROJECT_ID

   Remplacez les éléments suivants :

   • GOOGLE_API_SOURCE_NAME : ID ou identifiant complet de votre ressource GoogleApiSource qui représente un abonnement aux événements de l'API Google pour un bus spécifique
   • BUS_NAME : ID ou identifiant complet du bus auquel vous souhaitez vous abonner pour recevoir les événements de l'API Google
   • BUS_PROJECT_ID : ID du projet Google Cloud pour le bus

   Facultatif : Vous pouvez également utiliser les options suivantes :

   • --async pour quitter immédiatement la commande, sans attendre la fin de l'opération en cours.
   • --crypto-key pour spécifier le nom complet d'une clé de chiffrement gérée par le client ; si aucune clé n'est spécifiée, Google-owned and managed keys est utilisé.
   • --logging-config pour configurer le niveau de journalisation, qui doit être l'un des suivants : NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Pour en savoir plus, consultez LogSeverity.

API REST

Pour activer les événements provenant de sources Google, utilisez la méthode projects.locations.googleApiSources.create.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• GOOGLE_API_SOURCE_NAME : nom à afficher de la ressource GoogleApiSource qui représente un abonnement aux événements de l'API Google pour un bus spécifique (par exemple, my_google_source).
• LABEL_KEY et LABEL_VALUE : facultatifs. Il s'agit d'un mappage des paires clé/valeur de libellés qui vous aident à organiser vos ressources Google Cloud . Pour en savoir plus, consultez Que sont les libellés ?.
• ANNOTATION_KEY et ANNOTATION_VALUE : facultatifs. Carte des paires clé/valeur d'annotations de texte libre. Vous pouvez les utiliser pour joindre des informations arbitraires associées à la ressource. Pour en savoir plus, consultez Annotations.
• DESTINATION : identifiant complet du bus Eventarc Advanced auquel les événements sources Google doivent être publiés au format projects/PROJECT_NAME/locations/LOCATION/messageBuses/BUS_NAME. Pour en savoir plus, consultez Créer un bus pour acheminer les messages.
• ENCRYPT_KEY : Facultatif. Clé Cloud KMS que la ressource GoogleApiSource doit utiliser pour le chiffrement des données au format projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. Pour en savoir plus, consultez Utiliser des clés de chiffrement gérées par le client.
• PROJECT_ID : ID du projet dans lequel créer la ressource GoogleApiSource. Google Cloud
• LOCATION : région compatible dans laquelle créer la ressource GoogleApiSource (par exemple, us-central1).
• LOG_SEVERITY : Facultatif. Gravité minimale de l'événement décrit dans une entrée de journal. Au choix : NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT ou EMERGENCY. La valeur par défaut est NONE. Pour en savoir plus, consultez LogSeverity.

Corps JSON de la requête :

{
  "displayName": "GOOGLE_API_SOURCE_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "destination": "DESTINATION",
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}

Pour envoyer votre requête, développez l'une des options suivantes :

cat > request.json << 'EOF'
{
  "displayName": "GOOGLE_API_SOURCE_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "destination": "DESTINATION",
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources?googleApiSourceId=GOOGLE_API_SOURCE_NAME"

@'
{
  "displayName": "GOOGLE_API_SOURCE_NAME",
  "labels": {"LABEL_KEY":"LABEL_VALUE"},
  "annotations": {"ANNOTATION_KEY":"ANNOTATION_VALUE"},
  "destination": "DESTINATION",
  "cryptoKeyName": "ENCRYPT_KEY",
  "loggingConfig": {"logSeverity":"LOG_SEVERITY"}
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources?googleApiSourceId=GOOGLE_API_SOURCE_NAME" | Select-Object -Expand Content

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation :

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

Console

1. Dans la console Google Cloud , accédez à la page Eventarc > Détails du bus.

   Accéder aux détails du bus

2. Cliquez sur edit Modifier.

3. Sur la page Modifier le bus, pour supprimer le fournisseur de messages de l'API Google, cliquez sur delete Supprimer la ressource pour la source de messages google-api-source (ou le nom que vous lui avez donné).

4. Dans l'invite Supprimer la ressource, cliquez sur Confirmer.

5. Cliquez sur Enregistrer.

gcloud

1. Ouvrez un terminal.

2. Vous pouvez désactiver les événements provenant de sources Google à l'aide de la commande gcloud beta eventarc google-api-sources delete :

   gcloud beta eventarc google-api-source delete GOOGLE_API_SOURCE_NAME \
       --location=REGION

   Remplacez les éléments suivants :

   • GOOGLE_API_SOURCE_NAME : ID ou identifiant complet de la ressource GoogleApiSource
   • REGION : emplacement de la ressource GoogleApiSource

API REST

Pour désactiver les événements provenant de sources Google, utilisez la méthode projects.locations.googleApiSources.delete.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID du projet Google Cloud dans lequel la ressource GoogleApiSource est créée.
• LOCATION : région dans laquelle la ressource GoogleApiSource est créée, par exemple us-central1.
• GOOGLE_API_SOURCE_NAME : nom de la ressource GoogleApiSource que vous souhaitez supprimer.

Pour envoyer votre requête, développez l'une des options suivantes :

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://eventarc.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME" | Select-Object -Expand Content

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Operation :

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.eventarc.v1.OperationMetadata",
    "createTime": "2024-01-25T17:17:45.782370139Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/googleApiSources/GOOGLE_API_SOURCE_NAME",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}