Memahami pola jalur

Eventarc mendukung penerapan pola jalur saat memfilter. Sintaksis pola jalur memungkinkan Anda menentukan ekspresi yang cocok dengan peristiwa. Hal ini memungkinkan Anda mengontrol perincian pemicu Eventarc yang Anda buat, serta merekam dan menindaklanjuti peristiwa tertentu. Misalnya, Anda dapat membuat pemicu yang berlaku untuk satu peristiwa, seperti perubahan pada file tertentu, atau Anda dapat memperluas cakupan pola dan membuat pemicu yang berlaku lebih luas.

Menerapkan pola jalur

Anda dapat menerapkan pola jalur untuk memfilter peristiwa saat membuat pemicu menggunakan halaman konsol Eventarc Google Cloud atau dengan menjalankan perintah gcloud.

Misalnya, Anda dapat menerapkan pola jalur saat memfilter nama resource atau instance database (instance tunggal atau jalur).

• Menentukan pola jalur nama resource berlaku saat membuat pemicu untuk peristiwa Cloud Audit Logs dan untuk nilai resourceName. Nama resource menunjukkan resource yang diaudit melalui log audit. Nama resource disusun secara hierarkis menggunakan ID yang terdiri dari ID resource itu sendiri dan ID resource induk, yang semuanya dipisahkan dengan garis miring, seperti ini: /projects/project-1/datasets/dataset-id. Pemfilteran yang dilakukan oleh Eventarc mencocokkan pola berdasarkan nilai ID ini. Untuk mengetahui informasi selengkapnya, lihat Format nama resource dalam dokumen ini.

• Menentukan pola jalur instance database berlaku saat membuat pemicu untuk peristiwa Firebase Realtime Database dan untuk nilai instance atau ref. Instance database menunjukkan instance Firebase Realtime Database. Anda dapat menerapkan pola jalur ke nama instance database, atau jalur dokumen yang ingin Anda terima peristiwanya saat data dibuat, diperbarui, atau dihapus di jalur tersebut, atau di turunan mana pun.

• Menentukan pola jalur ID resource berlaku saat membuat pemicu untuk peristiwa Cloud IoT dan untuk nilai registry dan device. Anda dapat menerapkan pola jalur untuk memfilter perubahan di registry, dan perangkat di registry, dengan pencocokan karakter pengganti.

Untuk mengetahui detailnya, lihat petunjuk untuk membuat pemicu bagi penyedia, jenis peristiwa, dan tujuan tertentu.

Mengidentifikasi apakah Anda dapat menerapkan pola jalur

Untuk mengonfirmasi apakah Anda dapat menerapkan pola jalur ke atribut peristiwa dari penyedia, jelaskan penyedia peristiwa. Contoh:

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

Output-nya mirip dengan berikut ini dan nilai pathPatternSupported sebesar true menunjukkan bahwa Anda dapat menerapkan pola jalur:

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

Atau, misalnya:

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

Jika outputnya mirip dengan berikut ini:

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

Untuk informasi selengkapnya, lihat gcloud eventarc providers describe.

Sintaksis pola jalur

Sintaksis pola jalur ditentukan sebagai berikut:

Legenda:

Ekspresi

Ekspresi dapat berupa salah satu jenis segmen berikut dan tidak boleh kosong:

• Satu segmen Wildcard yang ditentukan sebagai * cocok dengan nol atau lebih karakter dalam pola.
• MultiSegmentWildcard yang ditentukan sebagai ** cocok dengan nol atau beberapa segmen dalam pola.
• NameSegment terdiri dari nol atau satu * dan karakter lainnya. Kombinasi ini memungkinkan Anda memfilter menurut awalan, akhiran, atau ekstensi file; misalnya, file-*.txt.

Perhatikan bahwa jalur dapat berisi banyak karakter pengganti segmen tunggal, tetapi hanya satu karakter pengganti multi-segmen. Misalnya, jalur berikut tidak valid: /projects/**/buckets/**.

Regionalitas resource

Nama resource dapat berisi ID lokasi. Contoh:

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

Namun, pencocokan pola jalur dibatasi oleh regionalitas resource. Misalnya, untuk pemicu Cloud Audit Logs, karakter pengganti lokasi hanya cocok dengan pemicu dari region Cloud Audit Logs, atau pemicu global.

Grup tangkapan

CaptureGroup memungkinkan Anda mengambil konten ekspresi. Anda melakukannya dengan menetapkan nilai ke nama variabel dalam tanda kurung; misalnya, buckets/{path=**}/files/{filename=file-*.txt}. Karakter pengganti segmen tunggal dapat menghilangkan =* dalam grup pengambilan; misalnya, /projects/_/buckets/{bucket}/objects/file.*

Format nama resource

Tabel berikut memberikan contoh nama lengkap resource untuk layananGoogle Cloud yang umum digunakan. Ini bukan daftar lengkap. Untuk mempelajari lebih lanjut cara nama lengkap resource yang diformat, lihat bagian Nama resource dalam panduan desain API.

¹ Untuk Cloud Firestore, jangan tentukan garis miring di awal saat membuat pemicu (lihat contoh). Untuk mengetahui informasi selengkapnya, lihat model data Cloud Firestore.

² Untuk Cloud Storage, nama resource berisi garis bawah (_), bukan project ID. Anda tidak dapat mengganti garis bawah dengan project ID, nama project, atau nomor project.

³ Untuk Cloud Storage, gunakan seluruh nama objek, termasuk garis miring ke depan. Karakter ini adalah bagian dari nama objek, bukan pemisah jalur.

Contoh

Contoh berikut menunjukkan cara Anda dapat dan tidak dapat menggunakan sintaksis.

Pola yang valid

Pola yang tidak valid

Pencocokan pola

Langkah berikutnya

• Untuk mengetahui daftar peristiwa yang didukung oleh Eventarc, lihat Jenis peristiwa Google yang didukung oleh Eventarc.