Informazioni sui pattern di percorso

Eventarc supporta l'applicazione di un pattern di percorso durante il filtraggio. La sintassi del pattern del percorso ti consente di definire un'espressione che corrisponda agli eventi. In questo modo puoi controllare la granularità del trigger Eventarc che stai creando e acquisire determinati eventi e intervenire in relazione agli stessi. Ad esempio, puoi creare un trigger che si applica a un singolo evento, ad esempio una modifica a un file specifico, oppure puoi estendere l'ambito del pattern e creare un trigger che si applica in modo più ampio.

Applicare un pattern del percorso

Puoi applicare un pattern di percorso per filtrare gli eventi quando crei un trigger utilizzando la pagina della console Eventarc Google Cloud o eseguendo un comando gcloud.

Ad esempio, puoi applicare un pattern di percorso quando filtri in base a nomi delle risorse o istanze di database (una singola istanza o un percorso).

• La specifica di un pattern del percorso del nome della risorsa si applica quando crei un trigger per gli eventi Cloud Audit Logs e ai valori resourceName. Un nome della risorsa indica la risorsa sottoposta a controllo tramite un log di controllo. I nomi delle risorse sono organizzati gerarchicamente utilizzando identificatori composti dall'ID della risorsa stessa e dagli ID di eventuali risorse padre, tutti separati da barre, come in questo esempio: /projects/project-1/datasets/dataset-id. Il filtro eseguito da Eventarc corrisponde ai pattern in base ai valori di questi identificatori. Per saperne di più, consulta la sezione Formato del nome della risorsa in questo documento.

• La specifica di un pattern del percorso dell'istanza del database si applica quando si crea un trigger per gli eventi Firebase Realtime Database e ai valori instance o ref. Un'istanza di database indica un'istanza di Firebase Realtime Database. Puoi applicare un pattern di percorso al nome dell'istanza del database o a un percorso del documento per il quale vuoi ricevere eventi quando i dati vengono creati, aggiornati o eliminati in quel percorso o in uno dei relativi elementi secondari.

• La specifica di un pattern del percorso dell'ID risorsa si applica quando crei un trigger per gli eventi Cloud IoT e ai valori registry e device. Puoi applicare un pattern del percorso per filtrare le modifiche nei registri e nei dispositivi di un registro con la corrispondenza con caratteri jolly.

Per maggiori dettagli, consulta le istruzioni per creare un trigger per un fornitore, un tipo di evento e una destinazione specifici.

Identificare se puoi applicare un pattern di percorso

Per verificare se puoi applicare un pattern di percorso a un attributo di un evento di un provider, descrivi il provider di eventi. Ad esempio:

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

L'output è simile al seguente e un valore pathPatternSupported di true indica che puoi applicare un pattern di percorso:

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

Ad esempio:

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

L'output è simile al seguente:

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
[...]

Per ulteriori informazioni, vedi gcloud eventarc providers describe.

Sintassi del pattern del percorso

La sintassi del pattern del percorso è definita come segue:

Legenda:

Espressioni

Un'espressione può essere uno dei seguenti tipi di segmento e non può essere vuota:

• Un singolo segmento Wildcard definito come * corrisponde a zero o più caratteri nel pattern.
• Un MultiSegmentWildcard definito come ** corrisponde a zero o più segmenti nel pattern.
• Un NameSegmentè composto da zero o un * e altri caratteri. Questa combinazione ti consente di filtrare in base al prefisso, al suffisso o all'estensione del file; ad esempio, file-*.txt.

Tieni presente che un percorso può contenere molti caratteri jolly per un singolo segmento, ma solo un carattere jolly per più segmenti. Ad esempio, il seguente percorso non è valido: /projects/**/buckets/**.

Regionalità delle risorse

I nomi delle risorse possono contenere identificatori di località. Ad esempio:

/projects/$PROJECT_ID/locations/$REGION/triggers/my-trigger

Tuttavia, la corrispondenza dei pattern di percorso è vincolata dalla regionalità delle risorse. Ad esempio, per i trigger Cloud Audit Logs, i caratteri jolly di località corrispondono solo ai trigger della regione Cloud Audit Logs o ai trigger globali.

Gruppi di acquisizione

Un CaptureGroup ti consente di acquisire il contenuto di un'espressione. Per farlo, assegna il valore a un nome di variabile tra parentesi graffe, ad esempio, buckets/{path=**}/files/{filename=file-*.txt}. Un singolo carattere jolly di segmento può omettere =* in un gruppo di acquisizione; ad esempio, /projects/_/buckets/{bucket}/objects/file.*

Formato del nome della risorsa

La tabella seguente fornisce esempi di nomi completi delle risorse per i serviziGoogle Cloud di uso comune. Non si tratta di un elenco esaustivo. Per scoprire di più su come vengono formattati i nomi completi delle risorse, consulta la sezione Nomi delle risorse della guida alla progettazione delle API.

¹ Per Cloud Firestore, non specificare una barra iniziale quando crei un trigger (vedi gli esempi). Per ulteriori informazioni, consulta Modello di dati di Cloud Firestore.

² Per Cloud Storage, i nomi delle risorse contengono un trattino basso (_) anziché un ID progetto. Non puoi sostituire il carattere di sottolineatura con un ID progetto, un nome progetto o un numero di progetto.

³ Per Cloud Storage, utilizza l'intero nome dell'oggetto, incluse le barre avanti. Questi caratteri fanno parte del nome dell'oggetto, non sono separatori di percorso.

Esempi

I seguenti esempi mostrano come puoi e non puoi utilizzare la sintassi.

Pattern validi

Pattern non validi

Corrispondenza di pattern

Passaggi successivi

• Per un elenco degli eventi supportati da Eventarc, consulta Tipi di eventi Google supportati da Eventarc.