Cloud Data Loss Prevention (Cloud DLP) kini menjadi bagian dari Sensitive Data Protection. Nama API tetap sama: Cloud Data Loss Prevention API (DLP API). Untuk informasi tentang layanan yang membentuk Perlindungan Data Sensitif, lihat Ringkasan Perlindungan Data Sensitif.

Halaman ini diterjemahkan oleh Cloud Translation API.

Memeriksa data dari sumber eksternal menggunakan tugas hybrid

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

Pengantar tugas hybrid dan pemicu tugas hybrid

Tugas hybrid dan pemicu tugas hybrid memungkinkan Anda memperluas cakupan perlindungan yang disediakan oleh 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 Sensitive Data Protection, dan mengizinkan Sensitive Data Protection memeriksa data untuk informasi sensitif. Sensitive Data Protection otomatis menyimpan dan menggabungkan hasil pemindaian untuk analisis lebih lanjut.

Perbandingan tugas hybrid dan pemicu tugas hybrid

Saat Anda membuat tugas campuran, tugas tersebut akan berjalan hingga Anda menghentikannya. Fungsi ini menerima semua data masuk selama data tersebut dirutekan 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 campuran, Anda dapat menghentikan dan memulai tugas baru dalam pemicu tanpa harus mengonfigurasi ulang permintaan hybridInspect. Misalnya, Anda dapat mengirim data ke pemicu tugas campuran, 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 campuran yang umum di halaman ini.

Definisi istilah

Topik ini menggunakan istilah berikut:

Data eksternal: data yang disimpan di luar Google Cloud atau data yang tidak didukung secara native oleh Perlindungan Data Sensitif.
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 hibrida atau pemicu tugas hibrida yang akan menerima permintaan.

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

Proses inspeksi campuran

Ada tiga langkah dalam proses pemeriksaan campuran.

Pilih data yang ingin Anda kirim ke Perlindungan Data Sensitif.

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

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

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

Permintaan hybridInspect berisi data yang akan dipindai. Dalam permintaan, sertakan metadata (juga disebut sebagai label dan ID tabel) yang menjelaskan konten dan memungkinkan Sensitive Data Protection mengidentifikasi informasi yang ingin Anda lacak. Misalnya, jika Anda memindai data terkait di beberapa permintaan (seperti baris dalam tabel database yang sama), Anda dapat menggunakan metadata yang sama dalam permintaan terkait tersebut. Kemudian, Anda dapat mengumpulkan, menjumlahkan, dan menganalisis temuan untuk tabel database tersebut.

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

Diagram yang menggambarkan proses inspeksi tugas campuran

Pertimbangan

Saat menggunakan tugas campuran dan pemicu tugas, pertimbangkan poin-poin berikut:

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

Sebelum memulai

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

Membuat project baru, mengaktifkan penagihan, dan mengaktifkan 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 Sensitive Data Protection dapat memeriksa data Anda, Anda harus mengirim data tersebut ke Sensitive Data Protection. Terlepas dari metode yang Anda gunakan untuk mengonfigurasi tugas campuran atau pemicu tugas campuran, Anda harus menyiapkan sumber eksternal untuk mengirim data ke DLP API.

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

Membuat tugas hybrid atau pemicu tugas hybrid

Agar Perlindungan Data Sensitif dapat memeriksa data yang Anda kirimkan, Anda harus menyiapkan tugas hybrid atau pemicu tugas hybrid terlebih dahulu. Untuk mengetahui informasi tentang yang harus dibuat, lihat Skenario pemeriksaan campuran umum di halaman ini.

Konsol

Di konsol Google Cloud, buka halaman Create job or job trigger:

Buka Membuat tugas atau pemicu tugas

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

Pilih data input

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

Opsional: Untuk Nama, beri nama tugas dengan memasukkan nilai di kolom ID Tugas. Jika kolom ini dibiarkan kosong, Sensitive Data Protection akan membuat ID secara otomatis.
Opsional: Dari menu Resource location, pilih region tempat Anda ingin menyimpan tugas campuran atau pemicu tugas campuran. Untuk informasi selengkapnya, lihat Menentukan lokasi pemrosesan.
Untuk Storage type, pilih Hybrid.
Opsional: Untuk Deskripsi, deskripsikan tugas campuran atau pemicu tugas campuran yang Anda buat. Misalnya, Anda dapat menyertakan informasi tentang sumber data yang akan diperiksa.
Opsional: Untuk Label wajib, klik Tambahkan label, lalu masukkan label yang ingin Anda tetapkan sebagai wajib dari permintaan hybridInspect. Permintaan hybridInspect yang tidak menentukan label ini tidak diproses oleh tugas hibrida atau pemicu tugas hibrida ini. Anda dapat menambahkan hingga 10 label yang diperlukan. Untuk informasi selengkapnya, lihat Memerlukan label dari permintaan hybridInspect di halaman ini.
Opsional: Untuk Label opsional, masukkan pasangan nilai kunci yang ingin Anda lampirkan ke hasil semua permintaan hybridInspect yang dikirim ke tugas ini atau pemicu tugas. Anda dapat menambahkan hingga 10 label opsional. Untuk informasi selengkapnya, lihat Label opsional.
Opsional: Untuk Opsi data tabel, masukkan nama kolom kunci utama jika Anda berencana mengirim data tabel dalam permintaan hybridInspect. Untuk mengetahui informasi selengkapnya, lihat Opsi data tabel.
Klik Lanjutkan.

Konfigurasikan deteksi

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

Template: Jika Anda telah membuat template di project saat ini yang ingin digunakan untuk menentukan parameter deteksi Perlindungan Data Sensitif, klik kolom Template name, lalu pilih template dari daftar yang muncul.
InfoTypes: Sensitive Data Protection memilih infoType bawaan yang paling umum untuk dideteksi. Untuk mengubah infoTypes, atau memilih infoType kustom yang akan digunakan, klik Kelola infoTypes. Anda juga dapat menyesuaikan kriteria deteksi di bagian Aturan pemeriksaan dan Batas kepercayaan. Untuk mengetahui detail selengkapnya, lihat Mengonfigurasi deteksi.

Setelah mengonfigurasi parameter deteksi, klik Lanjutkan.

Tambah tindakan

Di bagian ini, Anda menentukan tempat untuk menyimpan temuan dari setiap pemindaian inspeksi 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 infoTypes temuan.

Save to BigQuery: Setiap kali pemindaian berjalan, Perlindungan Data Sensitif akan 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: Saat tugas selesai, pesan Pub/Sub akan dikeluarkan.

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

Setelah memilih tindakan, klik Lanjutkan.

Jadwal

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

Lakukan salah satu hal berikut:

Untuk segera menjalankan tugas campuran, pilih None (jalankan langsung tugas satu kali saat dibuat).
Untuk mengonfigurasi tugas agar data yang diterima dari sumber memicu tugas, pilih Create a trigger to run the job on a periodic schedule.

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

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

Ulasan

Anda dapat meninjau ringkasan JSON pemindaian di sini. Pastikan untuk mencatat nama pemicu tugas campuran atau ob campuran; Anda memerlukan informasi ini saat mengirim data ke Sensitive Data Protection untuk diperiksa.

Setelah meninjau ringkasan JSON, klik Create.

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

API

Tugas direpresentasikan di DLP API oleh resource DlpJobs. Untuk membuat tugas campuran, Anda harus memanggil metode projects.locations.dlpJobs.create.

Pemicu tugas direpresentasikan di DLP API oleh resource JobTrigger. Untuk membuat pemicu tugas campuran, Anda harus memanggil 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.
Di objek InspectJobConfig, di kolom actions, tambahkan tindakan apa pun (Action) yang ingin Anda lakukan oleh Perlindungan Data Sensitif di akhir setiap tugas.

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

Tentang contoh JSON

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

Memproses permintaan hybridInspect jika permintaan memiliki label appointment-bookings-comments.
Pindai konten dalam permintaan hybridInspect untuk 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 temuan ke baris tertentu tempat temuan berasal.
Kirim email saat tugas berhenti. Email akan dikirim ke pemilik project IAM dan Kontak Penting teknis.
Kirim temuan ke Cloud Monitoring saat tugas dihentikan.

Untuk melihat contoh JSON, lihat tab berikut.

Pekerjaan hybrid

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

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

Metode dan URL HTTP

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

Ganti kode berikut:

PROJECT_ID: ID project tempat Anda ingin menyimpan tugas campuran.
REGION: Region geografis tempat Anda ingin menyimpan tugas campuran.

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 campuran dan menghasilkan ID tugas. Dalam contoh ini, ID tugas adalah i-postgresql-table-comments. Catat ID tugas. Anda memerlukannya dalam permintaan hybridInspect.

Untuk menghentikan tugas campuran, Anda harus memanggil metode projects.locations.dlpJobs.finish secara eksplisit. DLP API tidak otomatis menghentikan tugas hibrida. Sebaliknya, DLP API otomatis menghentikan tugas dalam pemicu tugas hibrida pada akhir setiap hari.

Pemicu tugas hybrid

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

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

Metode dan URL HTTP

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 campuran.
REGION: Region geografis tempat Anda ingin menyimpan pemicu tugas campuran.

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"
}

Sensitive Data Protection membuat pemicu tugas hybrid. Output-nya berisi nama pemicu tugas campuran. Dalam contoh ini, nilainya adalah postgresql-table-comments. Catat namanya. Anda memerlukannya dalam permintaan hybridInspect.

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

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

Di kolom Request parameters, 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 API Explorer, akan membuat tugas hybrid atau pemicu tugas hybrid.

Untuk 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.

Pemformatan item konten campuran

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

item: berisi konten sebenarnya yang akan diperiksa.
findingDetails: berisi metadata untuk 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 informasi komprehensif tentang konten item pemeriksaan campuran, lihat konten referensi API untuk objek HybridContentItem.

Endpoint pemeriksaan hybrid

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

Metode dan URL HTTP untuk tugas campuran

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

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

Metode dan URL HTTP untuk pemicu tugas campuran

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

Untuk 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 campuran.
JOB_ID: ID yang Anda berikan ke tugas campuran, diawali dengan i-.

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

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

Memerlukan label dari permintaan `hybridInspect`

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 yang diperlukan ini akan ditolak.

Untuk menetapkan label yang diperlukan, lakukan hal berikut:

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

Contoh berikut menetapkan appointment-bookings-comments sebagai label yang diperlukan dalam tugas campuran atau pemicu tugas campuran.
```
"hybridOptions": {
  ...
  "requiredFindingLabelKeys": [
    "appointment-bookings-comments"
  ],
  "labels": {
    "env": "prod"
  },
  ...
}
```

Dalam permintaan hybridInspect, di kolom labels, tambahkan setiap label yang diperlukan sebagai kunci dalam pasangan nilai kunci. Nilai yang sesuai dapat 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 tidak menyertakan label yang diperlukan 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"
  }
}