Cloud Data Loss Prevention (Cloud DLP) is now a part of Sensitive Data Protection. The API name remains the same: Cloud Data Loss Prevention API (DLP API). For information about the services that make up Sensitive Data Protection, see Sensitive Data Protection overview.

Halaman ini diterjemahkan oleh Cloud Translation API.

Memeriksa data dari sumber eksternal menggunakan tugas hybrid

Topik ini menjelaskan cara menggunakan tugas hybrid dan pemicu tugas hybrid untuk memeriksa data eksternal guna menemukan informasi sensitif. Untuk mempelajari lebih lanjut tugas hybrid dan pemicu tugas hybrid—termasuk contoh lingkungan hybrid—lihat Tugas hybrid dan pemicu tugas hybrid.

Pengantar pekerjaan hybrid dan pemicu pekerjaan hybrid

Tugas hybrid dan pemicu tugas hybrid memungkinkan Anda memperluas cakupan perlindungan yang disediakan Perlindungan Data Sensitif di luar permintaan pemeriksaan konten sederhana dan pemindaian repositori penyimpanan Google Cloud. Dengan menggunakan tugas hybrid dan pemicu tugas hybrid, Anda dapat melakukan streaming data dari hampir semua sumber—termasuk di luar Google Cloud—langsung ke Perlindungan Data Sensitif, dan mengizinkan Perlindungan Data Sensitif memeriksa data untuk menemukan informasi sensitif. Perlindungan Data Sensitif otomatis menyimpan dan menggabungkan hasil pemindaian untuk analisis lebih lanjut.

Perbandingan tugas hybrid dan pemicu tugas hybrid

Saat Anda membuat tugas hybrid, tugas tersebut akan berjalan sampai Anda menghentikannya. Metode ini menerima semua data yang masuk selama data tersebut diarahkan dan diformat dengan benar.

Pemicu tugas hybrid berfungsi dengan cara yang mirip dengan tugas hybrid, tetapi Anda tidak perlu menghentikan tugas secara eksplisit dalam pemicu tugas hybrid. Perlindungan Data Sensitif otomatis menghentikan tugas dalam pemicu tugas hybrid pada akhir setiap hari.

Selain itu, dengan pemicu tugas hybrid, Anda dapat menghentikan dan memulai tugas baru dalam pemicu tanpa harus mengonfigurasi ulang permintaan hybridInspect. Misalnya, Anda dapat mengirim data ke pemicu tugas hybrid, lalu menghentikan tugas aktif, mengubah konfigurasinya, memulai tugas baru dalam pemicu tersebut, lalu melanjutkan untuk mengirim data ke pemicu yang sama.

Untuk panduan selengkapnya tentang opsi yang sesuai dengan kasus penggunaan Anda, lihat Skenario pemeriksaan hybrid standar di halaman ini.

Definisi istilah

Topik ini menggunakan istilah berikut:

Data eksternal: data yang disimpan di luar Google Cloud atau data yang tidak didukung oleh Perlindungan Data Sensitif secara native.
Tugas hybrid: tugas pemeriksaan yang dikonfigurasi untuk memindai data dari hampir semua sumber.
Pemicu tugas hybrid: pemicu tugas yang dikonfigurasi untuk memindai data dari hampir semua sumber.
Permintaan hybridInspect: permintaan yang berisi data eksternal yang ingin Anda periksa. Saat mengirim permintaan ini, Anda menentukan tugas hybrid atau pemicu tugas hybrid yang akan dikirimi permintaan.

Untuk informasi umum tentang tugas dan pemicu tugas, lihat Tugas dan pemicu tugas.

Proses pemeriksaan hybrid

Ada tiga langkah dalam proses pemeriksaan hibrida.

Pilih data yang ingin Anda kirim ke Perlindungan Data Sensitif.

Data dapat berasal dari dalam Google Cloud atau dari luarnya. Misalnya, Anda dapat mengonfigurasi skrip atau aplikasi kustom untuk mengirim data ke Perlindungan Data Sensitif, sehingga Anda dapat memeriksa data secara bertahap, dari layanan cloud lain, repositori data lokal, atau hampir semua sumber data lainnya.
Siapkan pemicu tugas hybrid atau tugas hybrid di Perlindungan Data Sensitif dari awal atau menggunakan template pemeriksaan.

Setelah Anda menyiapkan tugas hybrid atau pemicu tugas hybrid, Perlindungan Data Sensitif akan secara aktif memproses data yang dikirim ke tugas tersebut. Saat skrip kustom atau aplikasi Anda mengirimkan data ke tugas hybrid atau pemicu tugas hybrid ini, data akan diperiksa dan hasilnya disimpan sesuai dengan konfigurasi.

Saat menyiapkan tugas hybrid atau pemicu tugas hybrid, Anda dapat menentukan tempat untuk menyimpan atau memublikasikan temuan. Opsi termasuk menyimpan ke BigQuery dan memublikasikan notifikasi ke Pub/Sub, Cloud Monitoring, atau email.
Kirim permintaan hybridInspect ke tugas hybrid atau pemicu tugas hybrid.

Permintaan hybridInspect berisi data yang akan dipindai. Dalam permintaan, sertakan metadata (juga disebut sebagai label dan ID tabel) yang menjelaskan konten dan memungkinkan Perlindungan Data Sensitif mengidentifikasi informasi yang ingin Anda lacak. Misalnya, jika memindai data terkait di beberapa permintaan (seperti baris dalam tabel database yang sama), Anda dapat menggunakan metadata yang sama dalam permintaan terkait tersebut. Selanjutnya, Anda dapat mengumpulkan, menghitung, dan menganalisis temuan untuk tabel {i>database<i} itu.

Saat tugas hybrid menjalankan dan memeriksa permintaan, hasil pemeriksaan akan tersedia saat Perlindungan Data Sensitif membuatnya. Sebaliknya, tindakan, seperti notifikasi Pub/Sub, tidak akan terjadi sampai aplikasi Anda mengakhiri tugas hybrid.

Diagram yang menggambarkan proses pemeriksaan pekerjaan hybrid

Pertimbangan

Saat bekerja dengan tugas hybrid dan pemicu tugas, pertimbangkan hal-hal berikut:

Tugas hybrid dan pemicu tugas hybrid tidak mendukung pemfilteran dan pengambilan sampel.
Tugas dan pemicu tugas tidak tunduk pada tujuan tingkat layanan (SLO), tetapi ada beberapa langkah yang dapat Anda ambil untuk mengurangi latensi. Untuk mengetahui informasi selengkapnya, lihat Latensi tugas.

Sebelum memulai

Sebelum menyiapkan dan menggunakan tugas hybrid atau pemicu tugas hybrid, pastikan Anda telah melakukan hal berikut:

Buat project baru, aktifkan penagihan, dan aktifkan Perlindungan Data Sensitif

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

Buka pemilih project

Make sure that billing is enabled for your Google Cloud project.

Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

Buka pemilih project

Make sure that billing is enabled for your Google Cloud project.

Aktifkan API Sensitive Data Protection.
Mengaktifkan API

Mengonfigurasi sumber data

Sebelum Perlindungan Data Sensitif dapat memeriksa data, Anda harus mengirim data tersebut ke Perlindungan Data Sensitif. Terlepas dari metode yang digunakan untuk mengonfigurasi pemicu tugas hybrid atau tugas hybrid, Anda harus menyiapkan sumber eksternal untuk mengirim data ke DLP API.

Untuk informasi tentang format yang diperlukan untuk permintaan pemeriksaan hybrid, lihat Pemformatan item konten campuran. Untuk mengetahui informasi tentang jenis metadata yang dapat Anda sertakan dengan data dalam permintaan, baca Jenis metadata yang dapat Anda berikan.

Membuat tugas hybrid atau pemicu tugas hybrid

Agar Perlindungan Data Sensitif memeriksa data yang Anda kirim ke sana, Anda harus menyiapkan tugas hybrid atau pemicu tugas hybrid terlebih dahulu. Untuk mengetahui informasi tentang skenario mana yang harus dibuat, lihat Skenario pemeriksaan hybrid standar di halaman ini.

Konsol

Di konsol Google Cloud, buka halaman Buat tugas atau pemicu tugas:

Buka Buat tugas atau pemicu tugas

Bagian berikut menjelaskan cara mengisi bagian halaman Membuat tugas atau pemicu tugas yang relevan dengan operasi pemeriksaan hybrid.

Pilih data input

Di bagian ini, Anda akan menentukan data input untuk Perlindungan Data Sensitif yang akan diperiksa.

Opsional: Untuk Name, beri nama tugas dengan memasukkan nilai di kolom Job ID. Membiarkan kolom ini kosong akan menyebabkan Perlindungan Data Sensitif membuat ID secara otomatis.
Opsional: Dari menu Resource location, pilih region tempat Anda ingin menyimpan tugas hybrid atau pemicu tugas hybrid. Untuk mengetahui informasi selengkapnya, lihat Menentukan lokasi pemrosesan.
Untuk Jenis penyimpanan, pilih Hybrid.
Opsional: Untuk Deskripsi, jelaskan tugas hybrid atau pemicu tugas hybrid yang Anda buat. Misalnya, Anda dapat menyertakan informasi tentang sumber data yang akan diperiksa.
Opsional: Untuk Label yang diperlukan, klik Tambahkan label, lalu masukkan label yang ingin Anda wajibkan dari permintaan hybridInspect. Permintaan hybridInspect yang tidak menentukan label ini tidak akan diproses oleh tugas hybrid atau pemicu tugas hybrid ini. Anda dapat menambahkan hingga 10 label yang diperlukan. Untuk mengetahui informasi selengkapnya, lihat Mewajibkan label dari permintaan hybridInspect di halaman ini.
Opsional: Untuk Label opsional, masukkan key-value pair yang ingin Anda lampirkan ke hasil semua permintaan hybridInspect yang dikirim ke tugas atau pemicu tugas ini. Anda dapat menambahkan hingga 10 label opsional. Untuk informasi selengkapnya, lihat Label opsional.
Opsional: Untuk Opsi data tabular, masukkan nama kolom kolom kunci utama jika Anda berencana untuk mengirim data tabel dalam permintaan hybridInspect. Untuk informasi selengkapnya, lihat Opsi data tabular.
Klik Lanjutkan.

Konfigurasikan deteksi

Di bagian ini, Anda akan menentukan jenis data sensitif yang data inputnya akan diperiksa oleh Perlindungan Data Sensitif. Pilihan untuk Anda adalah:

Template: Jika Anda sudah membuat template dalam project saat ini yang ingin Anda gunakan untuk menentukan parameter deteksi Perlindungan Data Sensitif, klik kolom Nama template, lalu pilih template dari daftar yang muncul.
InfoTypes: Perlindungan Data Sensitif memilih infoType bawaan yang paling umum untuk dideteksi. Untuk mengubah infoType, atau memilih infoType kustom yang akan digunakan, klik Manage infoTypes. Anda juga dapat menyesuaikan kriteria deteksi di bagian Kumpulan aturan pemeriksaan dan Batas keyakinan. Untuk detail selengkapnya, lihat Mengonfigurasi deteksi.

Setelah mengonfigurasi parameter deteksi, klik Lanjutkan.

Tambah tindakan

Bagian ini adalah tempat Anda menentukan tempat untuk menyimpan temuan dari setiap pemindaian pemeriksaan dan apakah akan diberi tahu melalui email atau pesan notifikasi Pub/Sub setiap kali pemindaian selesai. Jika Anda tidak menyimpan temuan ke BigQuery, hasil pemindaian hanya akan berisi statistik tentang jumlah dan infoType temuan.

Simpan ke BigQuery: Setiap kali pemindaian berjalan, Perlindungan Data Sensitif menyimpan temuan pemindaian ke tabel BigQuery yang Anda tentukan di sini. Jika Anda tidak menentukan ID tabel, BigQuery akan menetapkan nama default ke tabel baru saat pemindaian pertama kali dijalankan. Jika Anda menentukan tabel yang sudah ada, Perlindungan Data Sensitif akan menambahkan temuan pemindaian ke tabel tersebut.
Publikasikan ke Pub/Sub: Setelah tugas selesai, pesan Pub/Sub akan muncul.

Catatan: Jika ada masalah konfigurasi atau izin pada topik Pub/Sub, Perlindungan Data Sensitif akan mencoba mengirimkan notifikasi Pub/Sub hingga dua minggu. Setelah dua minggu, notifikasi tersebut akan dihapus.
Beri tahu melalui email: Ketika tugas selesai, pesan email akan dikirim.
Publikasikan ke Cloud Monitoring: Setelah tugas selesai, temuannya akan dipublikasikan ke Monitoring.

Setelah memilih tindakan, klik Lanjutkan.

Jadwal

Bagian ini adalah tempat Anda menentukan apakah akan membuat satu tugas yang langsung berjalan, atau pemicu tugas yang berjalan setiap kali dirutekan dengan benar dan data yang diformat diterima oleh Perlindungan Data Sensitif.

Lakukan salah satu hal berikut:

Untuk langsung menjalankan tugas hybrid, pilih Tidak ada (langsung jalankan tugas satu kali setelah pembuatan).
Untuk mengonfigurasi tugas agar data yang diterima dari sumber memicu tugas, pilih Create a trigger to run the job on a periodic schedule.

Tugas hybrid memicu panggilan API gabungan, sehingga Anda dapat melihat hasil dan tren dari waktu ke waktu.

Untuk informasi selengkapnya, lihat Perbandingan tugas hybrid dan pemicu tugas hybrid.

Ulasan

Anda dapat meninjau ringkasan pemindaian JSON di sini. Pastikan untuk mencatat nama alat hybrid atau pemicu tugas hybrid. Anda memerlukan informasi ini saat mengirim data ke Perlindungan Data Sensitif untuk diperiksa.

Setelah meninjau ringkasan JSON, klik Buat.

Perlindungan Data Sensitif memulai tugas hybrid atau pemicu tugas hybrid dengan segera. Pemindaian inspeksi dimulai saat Anda mengirim permintaan hybridInspect ke tugas hybrid atau pemicu tugas hybrid ini.

API

Tugas direpresentasikan dalam DLP API oleh resource DlpJobs. Untuk membuat tugas hybrid, panggil metode projects.locations.dlpJobs.create.

Pemicu tugas direpresentasikan dalam DLP API oleh resource JobTrigger. Untuk membuat pemicu tugas hybrid, panggil metode projects.locations.jobTriggers.create.

Objek DlpJobs atau JobTrigger yang Anda buat harus memiliki setelan berikut:

Di kolom inspectJob, tetapkan objek InspectJobConfig.
Pada objek InspectJobConfig, di kolom storageConfig, tetapkan objek StorageConfig.
Pada objek StorageConfig, di kolom hybridOptions, tetapkan objek HybridOptions. Objek ini berisi metadata tentang data yang ingin Anda periksa.
Pada objek InspectJobConfig, di kolom actions, tambahkan tindakan apa pun (Action) yang Anda inginkan untuk dilakukan Perlindungan Data Sensitif di akhir setiap tugas.

Tindakan publishSummaryToCscc dan publishFindingsToCloudDataCatalog tidak didukung untuk operasi ini. Untuk informasi selengkapnya tentang tindakan, lihat Tindakan.
Tentukan file yang akan dipindai dan cara memindainya dengan melakukan salah satu atau kedua hal berikut:
- Tetapkan kolom inspectTemplateName ke nama resource lengkap dari template pemeriksaan yang ingin Anda gunakan, jika tersedia.
- Tetapkan kolom inspectConfig.
Jika Anda menetapkan kolom inspectTemplateName dan inspectConfig, setelannya akan digabungkan.

Tentang contoh JSON

Tab berikut berisi contoh JSON yang dapat Anda kirim ke Perlindungan Data Sensitif untuk membuat tugas hybrid atau pemicu tugas hybrid. Contoh pemicu tugas hybrid dan tugas hybrid ini dikonfigurasi untuk melakukan hal berikut:

Proses permintaan hybridInspect apa pun jika permintaan memiliki label appointment-bookings-comments.
Pindai konten dalam permintaan hybridInspect untuk menemukan alamat email.
Lampirkan label "env": "prod" ke temuan.
Untuk data tabel, dapatkan nilai sel di kolom booking_id (kunci utama) yang berada di baris yang sama dengan sel tempat data sensitif ditemukan. Perlindungan Data Sensitif melampirkan ID ini ke temuan, sehingga Anda dapat melacak penemuan tersebut ke baris asalnya.
Kirim email saat tugas dihentikan. Email tersebut akan ditujukan ke pemilik project IAM dan Kontak Penting teknis.
Kirim temuan ke Cloud Monitoring saat tugas dihentikan.

Untuk melihat contoh JSON, lihat tab berikut.

Tugas hybrid

Tab ini berisi contoh JSON yang dapat Anda gunakan untuk membuat tugas hybrid.

Untuk membuat tugas hybrid, kirim permintaan POST ke endpoint berikut.

Metode HTTP dan URL

POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/dlpJobs

Ganti kode berikut:

PROJECT_ID: ID project tempat Anda ingin menyimpan tugas hybrid.
REGION: region geografis tempat Anda ingin menyimpan tugas hybrid.

Input JSON

{
  "jobId": "postgresql-table-comments",
  "inspectJob": {
    "actions": [
      {
        "jobNotificationEmails": {}
      },
      {
        "publishToStackdriver": {}
      }
    ],
    "inspectConfig": {
      "infoTypes": [
        {
          "name": "EMAIL_ADDRESS"
        }
      ],
      "minLikelihood": "POSSIBLE",
      "includeQuote": true
    },
    "storageConfig": {
      "hybridOptions": {
        "description": "Hybrid job for data from the comments field of a table that contains customer appointment bookings",
        "requiredFindingLabelKeys": [
          "appointment-bookings-comments"
        ],
        "labels": {
          "env": "prod"
        },
        "tableOptions": {
          "identifyingFields": [
            {
              "name": "booking_id"
            }
          ]
        }
      }
    }
  }
}

Output JSON

{
"name": "projects/PROJECT_ID/locations/REGION/dlpJobs/i-postgresql-table-comments",
"type": "INSPECT_JOB",
"state": "ACTIVE",
"inspectDetails": {
  "requestedOptions": {
    "snapshotInspectTemplate": {},
    "jobConfig": {
      "storageConfig": {
        "hybridOptions": {
          "description": "Hybrid job for data from the comments field of a table that contains customer appointment bookings",
          "requiredFindingLabelKeys": [
            "appointment-bookings-comments"
          ],
          "labels": {
            "env": "prod"
          },
          "tableOptions": {
            "identifyingFields": [
              {
                "name": "booking_id"
              }
            ]
          }
        }
      },
      "inspectConfig": {
        "infoTypes": [
          {
            "name": "EMAIL_ADDRESS"
          }
        ],
        "minLikelihood": "POSSIBLE",
        "limits": {},
        "includeQuote": true
      },
      "actions": [
        {
          "jobNotificationEmails": {}
        },
        {
          "publishToStackdriver": {}
        }
      ]
    }
  },
  "result": {
    "hybridStats": {}
  }
},
"createTime": "JOB_CREATION_DATETIME",
"startTime": "JOB_START_DATETIME"
}

Perlindungan Data Sensitif membuat tugas hybrid dan menghasilkan ID pekerjaan. Dalam contoh ini, ID tugas adalah i-postgresql-table-comments. Catat ID pekerjaan. Anda memerlukannya dalam permintaan hybridInspect.

Untuk menghentikan tugas hybrid, Anda harus memanggil metode projects.locations.dlpJobs.finish secara eksplisit. DLP API tidak secara otomatis menghentikan tugas hybrid. Sebaliknya, DLP API secara otomatis menghentikan tugas dalam pemicu tugas hybrid di penghujung hari.

Pemicu tugas hybrid

Tab ini berisi contoh JSON yang dapat Anda gunakan untuk membuat pemicu tugas hybrid.

Untuk membuat pemicu tugas hybrid, kirim permintaan POST ke endpoint berikut.

Metode HTTP dan URL

POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobTriggers

Ganti kode berikut:

PROJECT_ID: ID project tempat Anda ingin menyimpan pemicu tugas hybrid.
REGION: region geografis tempat Anda ingin menyimpan pemicu tugas hybrid.

Input JSON

{
    "triggerId": "postgresql-table-comments",
    "jobTrigger": {
      "triggers": [
        {
          "manual": {}
        }
      ],
      "inspectJob": {
        "actions": [
          {
            "jobNotificationEmails": {}
          },
          {
            "publishToStackdriver": {}
          }
        ],
        "inspectConfig": {
          "infoTypes": [
              {
                "name": "EMAIL_ADDRESS"
              }
          ],
          "minLikelihood": "POSSIBLE",
          "limits": {},
          "includeQuote": true
        },
        "storageConfig": {
          "hybridOptions": {
            "description": "Hybrid job trigger for data from the comments field of a table that contains customer appointment bookings",
            "requiredFindingLabelKeys": [
                "appointment-bookings-comments"
              ],
            "labels": {
              "env": "prod"
            },
            "tableOptions": {
              "identifyingFields": [
                {
                  "name": "booking_id"
                }
              ]
            }
          }
        }
      }
    }
  }

Output JSON

{
"name": "projects/PROJECT_ID/locations/REGION/jobTriggers/postgresql-table-comments",
"inspectJob": {
  "storageConfig": {
    "hybridOptions": {
      "description": "Hybrid job trigger for data from the comments field of a table that contains customer appointment bookings",
      "requiredFindingLabelKeys": [
        "appointment-bookings-comments"
      ],
      "labels": {
        "env": "prod"
      },
      "tableOptions": {
        "identifyingFields": [
          {
            "name": "booking_id"
          }
        ]
      }
    }
  },
  "inspectConfig": {
    "infoTypes": [
      {
        "name": "EMAIL_ADDRESS"
      }
    ],
    "minLikelihood": "POSSIBLE",
    "limits": {},
    "includeQuote": true
  },
  "actions": [
    {
      "jobNotificationEmails": {}
    },
    {
      "publishToStackdriver": {}
    }
  ]
},
"triggers": [
  {
    "manual": {}
  }
],
"createTime": ""JOB_CREATION_DATETIME",
"updateTime": "TRIGGER_UPDATE_DATETIME",
"status": "HEALTHY"
}

Perlindungan Data Sensitif membuat pemicu tugas hybrid. Output-nya berisi nama pemicu tugas hybrid. Dalam contoh ini, atribut tersebut adalah postgresql-table-comments. Catat namanya. Anda memerlukannya dalam permintaan hybridInspect.

Tidak seperti tugas hybrid, DLP API secara otomatis menghentikan tugas dalam pemicu tugas hybrid di penghujung hari. Dengan demikian, Anda tidak perlu secara eksplisit memanggil metode projects.locations.dlpJobs.finish.

Saat membuat tugas hybrid atau pemicu tugas hybrid, Anda dapat menggunakan APIs Explorer di halaman referensi API berikut:

Di kolom Parameter permintaan, masukkan projects/PROJECT_ID/locations/REGION. Kemudian, di kolom Isi permintaan, tempel contoh JSON untuk objek yang ingin Anda buat.

Permintaan yang berhasil, bahkan yang dibuat di APIs Explorer, akan membuat tugas hybrid atau pemicu tugas hybrid.

Untuk mengetahui informasi umum tentang penggunaan JSON untuk mengirim permintaan ke DLP API, lihat panduan memulai JSON.

Mengirim data ke tugas hybrid atau pemicu tugas hybrid

Untuk memeriksa data, Anda harus mengirim permintaan hybridInspect, dalam format yang benar, ke tugas hybrid atau pemicu tugas hybrid.

Format item konten campuran

Berikut adalah contoh sederhana permintaan hybridInspect yang dikirim ke Perlindungan Data Sensitif untuk diproses oleh pemicu tugas hybrid atau tugas hybrid. Perhatikan struktur objek JSON, termasuk kolom hybridItem, yang berisi kolom berikut:

item: berisi konten sebenarnya yang akan diperiksa.
findingDetails: berisi metadata yang akan dikaitkan dengan konten.

{
  "hybridItem": {
    "item": {
      "value": "My email is test@example.org"
    },
    "findingDetails": {
      "containerDetails": {
        "fullPath": "10.0.0.2:logs1:app1",
        "relativePath": "app1",
        "rootPath": "10.0.0.2:logs1",
        "type": "logging_sys",
        "version": "1.2"
      },
      "labels": {
        "env": "prod",
        "appointment-bookings-comments": ""
      }
    }
  }
}

Untuk mengetahui informasi komprehensif tentang konten item pemeriksaan campuran, lihat konten referensi API untuk objek HybridContentItem.

Endpoint pemeriksaan hybrid

Agar data diperiksa menggunakan tugas hybrid atau pemicu tugas hybrid, Anda harus mengirim permintaan hybridInspect ke endpoint yang benar.

Metode HTTP dan URL untuk tugas hybrid

POST https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/dlpJobs/JOB_ID:hybridInspect

Untuk mengetahui informasi selengkapnya tentang endpoint ini, lihat halaman referensi API untuk metode projects.locations.dlpJobs.hybridInspect.

Metode HTTP dan URL untuk pemicu tugas hybrid

https://dlp.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobTriggers/TRIGGER_NAME:hybridInspect

Untuk mengetahui informasi selengkapnya tentang endpoint ini, lihat halaman referensi API untuk metode projects.locations.jobTriggers.hybridInspect.

Ganti kode berikut:

PROJECT_ID: ID project Anda.
REGION: region geografis tempat Anda ingin menyimpan permintaan hybridInspect. Region ini harus sama dengan region tugas hybrid.
JOB_ID: ID yang Anda berikan ke tugas hybrid, yang diawali dengan i-.

Untuk mencari ID tugas, di Sensitive Data Protection, klik Inspection > Inspect jobs.
TRIGGER_NAME: nama yang Anda berikan untuk pemicu tugas hybrid.

Untuk mencari nama pemicu tugas, di bagian Sensitive Data Protection, klik Inspection > Job trigger.

Wajibkan label dari `hybridInspect` permintaan

Jika ingin mengontrol permintaan hybridInspect mana yang dapat diproses oleh tugas hybrid atau pemicu tugas hybrid, Anda dapat menetapkan label yang diperlukan. Semua permintaan hybridInspect untuk tugas hybrid atau pemicu tugas hybrid yang tidak menyertakan label wajib ini akan ditolak.

Untuk menetapkan label yang diperlukan, lakukan hal berikut:

Saat membuat tugas hybrid atau pemicu tugas hybrid, tetapkan kolom requiredFindingLabelKeys ke daftar label yang diperlukan.

Contoh berikut menetapkan appointment-bookings-comments sebagai label yang diperlukan dalam tugas hybrid atau pemicu tugas hybrid.
```
"hybridOptions": {
  ...
  "requiredFindingLabelKeys": [
    "appointment-bookings-comments"
  ],
  "labels": {
    "env": "prod"
  },
  ...
}
```
Pada permintaan hybridInspect, di kolom labels, tambahkan setiap label yang diperlukan sebagai kunci dalam pasangan nilai kunci. Nilai yang sesuai bisa berupa string kosong.

Contoh berikut menetapkan label yang diperlukan, appointment-bookings-comments, dalam permintaan hybridInspect.
```
{
  "hybridItem": {
    "item": {
      "value": "My email is test@example.org"
    },
    "findingDetails": {
      "containerDetails": {...},
      "labels": {
        "appointment-bookings-comments": ""
      }
    }
  }
}
```

Jika label yang diperlukan tidak disertakan dalam permintaan hybridInspect, Anda akan mendapatkan error seperti berikut:

{
  "error": {
    "code": 400,
    "message": "Trigger required labels that were not included: [appointment-bookings-comments]",
    "status": "INVALID_ARGUMENT"
  }
}