Publica eventos desde fuentes de Google

Console

Habilita las APIs

gcloud

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

Console

1. En la consola de Google Cloud , ve a la página Eventarc > Bus.

   Ir a Bus

2. Puedes crear un colectivo o, si vas a actualizar uno, haz clic en edit Editar.

3. En la página Edit bus, para agregar una fuente de mensajes, haz clic en add Agregar fuente.

   1. En el panel Agregar fuente de mensajes, para el proveedor de mensajes de la API de Google, acepta el valor predeterminado google-api-source o ingresa un nombre de fuente de mensajes diferente.
   2. Haz clic en Crear.

4. Haz clic en Guardar.

gcloud

1. Abre una terminal.

2. Puedes habilitar los eventos de fuentes de Google con el 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

   Reemplaza lo siguiente:

   • GOOGLE_API_SOURCE_NAME: Es el ID o el identificador completamente calificado de tu recurso GoogleApiSource, que representa una suscripción a los eventos de la API de Google para un bus en particular.
   • BUS_NAME: Es el ID o el identificador completamente calificado del colectivo al que deseas suscribirte para recibir eventos de la API de Google.
   • BUS_PROJECT_ID: ID del proyecto Google Cloud del colectivo

   Opcional: También puedes usar las siguientes marcas:

   • --async para que el comando se muestre de inmediato, sin necesidad de esperar a que se complete la operación en curso.
   • --crypto-key para especificar el nombre completamente calificado de una clave de encriptación administrada por el cliente. Si no se especifica,se usan Google-owned and managed keys .
   • --logging-config para configurar el nivel de registro, que debe ser uno de los siguientes: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY Para obtener más información, consulta LogSeverity.

API de REST

Para habilitar los eventos de las fuentes de Google, usa el método projects.locations.googleApiSources.create.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• GOOGLE_API_SOURCE_NAME: Es el nombre visible del recurso GoogleApiSource que representa una suscripción a eventos de la API de Google para un bus en particular, por ejemplo, my_google_source.
• LABEL_KEY y LABEL_VALUE: Opcionales. Es un mapa de pares clave-valor de etiquetas que te ayudan a organizar tus recursos de Google Cloud . Para obtener más información, consulta ¿Qué son las etiquetas?
• ANNOTATION_KEY y ANNOTATION_VALUE: Opcionales. Es un mapa de pares clave-valor de anotación de texto de formato libre. Puedes usarlos para adjuntar información arbitraria asociada al recurso. Para obtener más información, consulta Anotaciones.
• DESTINATION: Es el identificador completamente calificado del bus de Eventarc Advanced en el que se deben publicar los eventos de la fuente de Google en el formato projects/PROJECT_NAME/locations/LOCATION/messageBuses/BUS_NAME. Para obtener más información, consulta Crea un bus para enrutar mensajes.
• ENCRYPT_KEY: es opcional. Una clave de Cloud KMS que el recurso GoogleApiSource debe usar para la encriptación de datos en el formato projects/PROJECT_NAME/locations/LOCATION/keyRings/RING_NAME/cryptoKeys/KEY_NAME. Para obtener más información, consulta Usa claves de encriptación administradas por el cliente.
• PROJECT_ID: Es el ID del proyecto en el que se creará el recurso Google Cloud.GoogleApiSource
• LOCATION: Es la región admitida en la que se creará el recurso GoogleApiSource, por ejemplo, us-central1.
• LOG_SEVERITY: es opcional. Es la gravedad mínima del evento que se describe en una entrada de registro. Uno de los siguientes: NONE, DEBUG, INFO, NOTICE, WARNING, ERROR, CRITICAL, ALERT, EMERGENCY. El valor predeterminado es NONE. Para obtener más información, consulta LogSeverity.

Cuerpo JSON de la solicitud:

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

Para enviar tu solicitud, expande una de estas opciones:

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 el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada 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. En la consola de Google Cloud , ve a la página Eventarc > Detalles del bus.

   Ir a Detalles del autobús

2. Haz clic en edit Editar.

3. En la página Edit bus, para borrar el proveedor de mensajes de la API de Google, haz clic en delete Borrar recurso para la fuente de mensajes google-api-source (o el nombre que le hayas asignado).

4. En el mensaje Borrar recurso, haz clic en Confirmar.

5. Haz clic en Guardar.

gcloud

1. Abre una terminal.

2. Puedes inhabilitar los eventos de fuentes de Google con el comando gcloud beta eventarc google-api-sources delete:

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

   Reemplaza lo siguiente:

   • GOOGLE_API_SOURCE_NAME: Es el ID o el identificador completamente calificado del recurso GoogleApiSource.
   • REGION: la ubicación del recurso GoogleApiSource

API de REST

Para inhabilitar los eventos de las fuentes de Google, usa el método projects.locations.googleApiSources.delete.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

• PROJECT_ID: Es el ID del proyecto Google Cloud en el que se crea el recursoGoogleApiSource.
• LOCATION: la región en la que se crea el recurso GoogleApiSource, por ejemplo, us-central1.
• GOOGLE_API_SOURCE_NAME: Es el nombre del recurso GoogleApiSource que deseas borrar.

Para enviar tu solicitud, expande una de estas opciones:

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 el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada 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
}