Pubblicare eventi da origini Google

Console

Abilita le API

gcloud

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

Console

1. Nella console Google Cloud , vai alla pagina Eventarc > Bus.

   Vai a Bus

2. Puoi creare un bus o, se stai aggiornando un bus, fai clic su edit Modifica.

3. Nella pagina Modifica bus, per aggiungere un'origine messaggio, fai clic su add Aggiungi origine.

   1. Nel riquadro Aggiungi origine messaggio, per il fornitore di messaggi dell'API Google, accetta il valore predefinito google-api-source o inserisci un nome di origine messaggio diverso.
   2. Fai clic su Crea.

4. Fai clic su Salva.

gcloud

1. Apri un terminale.

2. Puoi abilitare gli eventi dalle origini Google utilizzando il comando 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

   Sostituisci quanto segue:

   • GOOGLE_API_SOURCE_NAME: l'ID o l'identificatore completo della risorsa GoogleApiSource che rappresenta un abbonamento agli eventi API di Google per un bus specifico
   • BUS_NAME: l'ID o l'identificatore completo del bus per il quale vuoi abbonarti agli eventi dell'API Google
   • BUS_PROJECT_ID: l' Google Cloud ID progetto per il bus

   (Facoltativo) Puoi anche utilizzare i seguenti flag:

   • --async per tornare immediatamente dal comando, senza attendere il completamento dell'operazione in corso.
   • --crypto-key per specificare il nome completo di una chiave di crittografia gestita dal cliente; se non specificato,vengono utilizzati Google-owned and managed keys .
   • --logging-config per configurare il livello di logging, che deve essere uno dei seguenti: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Per ulteriori informazioni, vedi LogSeverity.

API REST

Per attivare gli eventi provenienti da origini Google, utilizza il metodo projects.locations.googleApiSources.create.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• GOOGLE_API_SOURCE_NAME: il nome visualizzato della risorsa GoogleApiSource che rappresenta un abbonamento agli eventi API di Google per un bus specifico, ad esempio my_google_source.
• LABEL_KEY e LABEL_VALUE: facoltativi. Una mappa di coppie chiave-valore di etichette che ti aiutano a organizzare le tue Google Cloud risorse. Per saperne di più, vedi Che cosa sono le etichette?
• ANNOTATION_KEY e ANNOTATION_VALUE: facoltativi. Una mappa di coppie chiave-valore di annotazione di testo in formato libero. Puoi utilizzarli per allegare informazioni arbitrarie associate alla risorsa. Per ulteriori informazioni, consulta la sezione Annotazioni.
• DESTINATION: l'identificatore completo del bus Eventarc Advanced a cui devono essere pubblicati gli eventi di origine Google nel formato projects/PROJECT_NAME/locations/LOCATION/messageBuses/BUS_NAME. Per maggiori informazioni, vedi Creare un bus per instradare i messaggi.
• ENCRYPT_KEY: facoltativo. Una chiave Cloud KMS che la risorsa GoogleApiSource deve utilizzare per la crittografia dei dati nel formato projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. Per saperne di più, vedi Utilizzare le chiavi di crittografia gestite dal cliente.
• PROJECT_ID: l'ID progetto in cui creare la risorsa GoogleApiSource. Google Cloud
• LOCATION: la regione supportata in cui creare la risorsa GoogleApiSource, ad esempio us-central1.
• LOG_SEVERITY: facoltativo. La gravità minima dell'evento descritto in una voce di log. Uno tra: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. Il valore predefinito è NONE. Per ulteriori informazioni, vedi LogSeverity.

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

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

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di 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. Nella console Google Cloud , vai alla pagina Eventarc > Dettagli bus.

   Vai ai dettagli dell'autobus

2. Fai clic su edit Modifica.

3. Nella pagina Modifica bus, per eliminare il provider di messaggi dell'API Google, fai clic su delete Elimina risorsa per l'origine dei messaggi google-api-source (o il nome che le hai assegnato).

4. Al prompt Elimina risorsa, fai clic su Conferma.

5. Fai clic su Salva.

gcloud

1. Apri un terminale.

2. Puoi disattivare gli eventi provenienti da origini Google utilizzando il comando gcloud beta eventarc google-api-sources delete:

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

   Sostituisci quanto segue:

   • GOOGLE_API_SOURCE_NAME: l'ID o l'identificatore completo della risorsa GoogleApiSource
   • REGION: la posizione della risorsa GoogleApiSource

API REST

Per disattivare gli eventi provenienti da origini Google, utilizza il metodo projects.locations.googleApiSources.delete.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto in cui viene creata la risorsa GoogleApiSource. Google Cloud
• LOCATION: la regione in cui viene creata la risorsa GoogleApiSource, ad esempio us-central1.
• GOOGLE_API_SOURCE_NAME: il nome della risorsa GoogleApiSource che vuoi eliminare.

Per inviare la richiesta, espandi una di queste opzioni:

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

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di 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
}