Compreenda os padrões de caminhos

O Eventarc suporta a aplicação de um padrão de caminho ao filtrar. A sintaxe do padrão de caminho permite-lhe definir uma expressão que corresponda a eventos. Isto permite-lhe controlar a granularidade do acionador do Eventarc que está a criar, bem como capturar e agir em determinados eventos. Por exemplo, pode criar um acionador que se aplique a um único evento, como uma alteração a um ficheiro específico, ou pode expandir o âmbito do padrão e criar um acionador que se aplique de forma mais abrangente.

Aplique um padrão de caminho

Pode aplicar um padrão de caminho para filtrar eventos quando cria um acionador usando a página da consola do Eventarc Google Cloud ou executando um comando gcloud.

Por exemplo, pode aplicar um padrão de caminho ao filtrar por nomes de recursos ou instâncias da base de dados (uma única instância ou um caminho).

• A especificação de um padrão do caminho do nome do recurso aplica-se quando cria um acionador para eventos dos registos de auditoria da nuvem e a valores resourceName. Um nome do recurso indica o recurso que está a ser auditado através de um registo de auditoria. Os nomes dos recursos estão organizados hierarquicamente através de identificadores compostos pelo ID do próprio recurso e pelos IDs de quaisquer recursos principais, todos separados por barras invertidas, da seguinte forma: /projects/project-1/datasets/dataset-id. A filtragem feita pelo Eventarc corresponde a padrões com base nos valores destes identificadores. Para mais informações, consulte a secção Formato do nome do recurso neste documento.

• A especificação de um padrão do caminho da instância da base de dados aplica-se quando cria um acionador para eventos da Firebase Realtime Database e a valores instance ou ref. Uma instância da base de dados indica uma instância da Firebase Realtime Database. Pode aplicar um padrão de caminho ao nome da instância da instância da base de dados ou a um caminho de documento para o qual quer receber eventos quando os dados são criados, atualizados ou eliminados nesse caminho ou em qualquer um dos respetivos filhos.

• A especificação de um padrão do caminho do ID do recurso aplica-se quando cria um acionador para eventos da Cloud IoT e aos valores registry e device. Pode aplicar um padrão de caminho para filtrar alterações em registos e dispositivos num registo com correspondência de carateres universais.

Para ver detalhes, consulte as instruções para criar um acionador para um fornecedor, um tipo de evento e um destino específicos.

Identifique se pode aplicar um padrão de caminho

Para confirmar se pode aplicar um padrão de caminho a um atributo de um evento de um fornecedor, descreva o fornecedor de eventos. Por exemplo:

gcloud eventarc providers describe cloudaudit.googleapis.com --location=us-central1

A saída é semelhante à seguinte e um valor de pathPatternSupportedtrue indica que pode aplicar um padrão de caminho:

displayName: Cloud Audit Logs
eventTypes:
- description: An audit log is created that matches the trigger's filter criteria.
  filteringAttributes:
  - attribute: methodName
    description: The identifier of the service's operation.
    required: true
  - attribute: resourceName
    description: The complete path to a resource. Used to filter events for a specific
      resource.
    pathPatternSupported: true
  - attribute: serviceName
    description: The identifier of the Google Cloud service.
    required: true
  - attribute: type
    required: true
  type: google.cloud.audit.log.v1.written
name: projects/project-name/locations/us-central1/providers/cloudaudit.googleapis.com

Em alternativa, por exemplo:

gcloud eventarc providers describe firebasedatabase.googleapis.com --location=us-central1

Quando o resultado é semelhante ao seguinte:

displayName: Firebase Realtime Database
eventTypes:
- description: New data has been created in the database.
  filteringAttributes:
  - attribute: instance
    description: A single database instance.
    pathPatternSupported: true
    required: true
  - attribute: ref
    description: Pattern to match for the database instance.
    pathPatternSupported: true
    required: true
  - attribute: type
    required: true
  type: google.firebase.database.ref.v1.created
[...]

Para mais informações, consulte gcloud eventarc providers describe.

Sintaxe do padrão de caminho

A sintaxe do padrão do caminho é definida da seguinte forma: