Mengelola permintaan perubahan dengan alur kerja tata kelola

Dokumen ini menjelaskan cara pemohon, pemberi persetujuan, dan administrator alur kerja mengelola permintaan tata kelola di Knowledge Catalog.

Sebelum memulai

Untuk menggunakan alur kerja tata kelola, pastikan Anda telah mengaktifkan API yang diperlukan dan bahwa pemberi persetujuan serta administrator memiliki peran dan izin Identity and Access Management (IAM) yang diperlukan.

Mengaktifkan Dataplex API.

Peran yang diperlukan untuk mengaktifkan API

Untuk mengaktifkan API, Anda memerlukan izin serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Admin Penggunaan Layanan (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.

Mengaktifkan API

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan alur kerja tata kelola, minta administrator untuk memberi Anda peran IAM berikut di project Anda:

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Untuk mengetahui informasi selengkapnya, lihat Peran IAM Knowledge Catalog.

Mengelola permintaan sebagai pemohon

Sebagai pemohon, Anda memulai permintaan perubahan, seperti meminta akses ke produk data. Setelah mengirimkan permintaan, Anda dapat memantau progresnya, melihat detail permintaan, mengedit detail untuk permintaan yang menunggu persetujuan dalam status NEW, atau menghapus permintaan sebelum disetujui oleh pemberi persetujuan.

Melihat permintaan yang dibuat

Untuk membuat daftar semua permintaan yang telah Anda buat, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Alur Kerja Tata Kelola Knowledge Catalog.

    Buka Alur kerja tata kelola

  2. Klik tab Permintaan saya untuk melihat daftar yang menampilkan semua permintaan Anda yang lalu dan yang tertunda.

REST

Melihat permintaan yang dibuat

Untuk mendapatkan daftar permintaan yang Anda buat:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada (misalnya, us-central1).
  • USER_EMAIL: alamat email Anda.

Metode HTTP dan URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "USER_EMAIL",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Melihat permintaan tertentu

Untuk melihat permintaan tertentu:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada (misalnya, us-central1).
  • CHANGE_REQUEST_ID: ID permintaan.

Metode HTTP dan URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID",
  "uid": "123e4567-e89b-12d3-a456-426614174000",
  "createTime": "2026-07-20T10:00:00Z",
  "updateTime": "2026-07-20T10:00:00Z",
  "justification": "Proposing a new glossary term definition for business accuracy.",
  "author": "user@example.com",
  "state": "NEW",
  "resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
  "createGlossaryTerm": {
    "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
    "termId": "sample-term-id",
    "term": {
      "displayName": "Sample term name",
      "description": "Sample term description",
      "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
    }
  }
}

Mengedit permintaan

Anda dapat memperbarui detail permintaan tertunda yang ada dalam status NEW. Misalnya, Anda dapat mengubah alasan yang diberikan dalam permintaan.

REST

Untuk mengedit permintaan, kirim permintaan PATCH yang berisi kolom yang diubah:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada (misalnya, us-central1).
  • CHANGE_REQUEST_ID: ID unik permintaan perubahan.
  • NEW_JUSTIFICATION: justifikasi yang diperbarui untuk permintaan perubahan.

Metode HTTP dan URL:

PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification

Meminta isi JSON:

{
  "justification": "NEW_JUSTIFICATION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Menghapus permintaan

Anda hanya dapat menghapus permintaan yang berstatus NEW. Untuk menghapus permintaan, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Alur Kerja Tata Kelola Knowledge Catalog.

    Buka Alur kerja tata kelola

  2. Klik tab Permintaan saya.

  3. Temukan baris yang berisi permintaan target Anda. Jika perlu, terapkan filter untuk mengisolasi entri.

  4. Klik Tindakan, lalu klik Hapus.

REST

Untuk menghapus permintaan, kirim permintaan DELETE yang menyertakan ID permintaan:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada (misalnya, us-central1).
  • CHANGE_REQUEST_ID: ID permintaan yang ingin Anda hapus.

Metode HTTP dan URL:

DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Mengelola permintaan sebagai pemberi persetujuan

Sebagai pemberi persetujuan, Anda meninjau, mengevaluasi, dan menindaklanjuti permintaan tata kelola yang tertunda yang dikirimkan untuk resource data Anda. Saat Anda menyetujui atau menolak permintaan, sistem akan otomatis memproses keputusan tersebut dan mengirimkan notifikasi email kepada pemohon yang berisi detail keputusan dan justifikasi Anda.

Mencantumkan permintaan yang menunggu keputusan

Untuk mencantumkan permintaan yang menunggu peninjauan, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Alur Kerja Tata Kelola Knowledge Catalog.

    Buka Alur Kerja Tata Kelola

  2. Klik tab Persetujuan Tertunda untuk melihat permintaan yang menunggu peninjauan. Anda dapat memfilter permintaan menurut jenis resource, jenis permintaan, atau tanggal.

REST

Untuk mencantumkan permintaan akses yang menunggu peninjauan dalam project dan lokasi tertentu, kirim permintaan GET:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada. Contoh, us-central1.

Metode HTTP dan URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "user@example.com",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Menyetujui permintaan

Untuk menyetujui permintaan, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Alur Kerja Tata Kelola Knowledge Catalog.

    Buka Alur Kerja Tata Kelola

  2. Klik tab Persetujuan Tertunda.

  3. Temukan baris yang berisi permintaan yang ingin Anda setujui.

  4. Klik Tindakan, lalu klik Setujui.

REST

Untuk menyetujui permintaan, kirim permintaan POST ke metode kustom :approve:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada (misalnya, us-central1).
  • CHANGE_REQUEST_ID: ID unik permintaan perubahan yang ingin Anda setujui.

Metode HTTP dan URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID:approve

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Setelah diproses, status permintaan akan diperbarui secara otomatis dan entri akan dipindahkan ke tab Log persetujuan.

Menolak permintaan

Untuk menolak permintaan, ikuti langkah-langkah berikut:

Konsol

  1. Di konsol Google Cloud , buka halaman Alur Kerja Tata Kelola Knowledge Catalog.

    Buka Alur Kerja Tata Kelola

  2. Klik tab Persetujuan Tertunda.

  3. Cari baris yang berisi permintaan yang ingin Anda tolak.

  4. Klik Tindakan , lalu klik Tolak.

  5. Dalam dialog, masukkan alasan penolakan.

  6. Klik Tolak untuk mengonfirmasi.

REST

Untuk menolak permintaan, kirim permintaan POST ke metode kustom :reject beserta payload justifikasi:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada (misalnya, us-central1).
  • CHANGE_REQUEST_ID: ID unik permintaan perubahan yang ingin Anda tolak.
  • REJECTION_REASON: alasan penolakan.

Metode HTTP dan URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID:reject

Meminta isi JSON:

{
  "comment": "REJECTION_REASON"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima kode status berhasil (2xx) dan respons kosong.

Memberikan komentar penolakan yang jelas membantu pemohon memahami keputusan dan menyempurnakan alasan akses mereka sebelum mengirim ulang permintaan.

Mengelola permintaan sebagai administrator alur kerja

Sebagai administrator alur kerja, Anda mengawasi semua permintaan tata kelola di seluruh organisasi, memantau histori persetujuan, dan memastikan kepatuhan. Anda dapat mencantumkan semua permintaan aktif dan historis, melacak jejak audit di semua status permintaan (NEW, APPROVED, REJECTED, DELETED), dan menghapus permintaan apa pun terlepas dari statusnya saat ini.

Lihat semua permintaan

Untuk mencantumkan semua permintaan dalam project dan lokasi tertentu, ikuti langkah-langkah berikut:

REST

Untuk mencantumkan semua permintaan akses dalam project dan lokasi tertentu, kirim permintaan GET:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada. Contoh, us-central1.

Metode HTTP dan URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "user@example.com",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Melacak histori persetujuan

Log persetujuan memberikan visibilitas audit menyeluruh untuk permintaan akses produk data, sehingga memungkinkan administrator dan tim kepatuhan melacak perubahan dan akses di semua status.

Konsol

  1. Di konsol Google Cloud , buka halaman Alur Kerja Tata Kelola.

    Buka Alur Kerja Tata Kelola

  2. Buka tab Log Persetujuan untuk melihat persetujuan yang telah diselesaikan, penolakan, dan jejak audit historis.

REST

Untuk mencantumkan semua permintaan untuk project tertentu, kirim permintaan GET:

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • PROJECT_ID: ID Google Cloud project Anda.
  • LOCATION: region tempat resource berada. Contoh, us-central1.

Metode HTTP dan URL:

GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan menerima respons JSON yang mirip seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/changeRequests/sample-change-request-1",
      "uid": "123e4567-e89b-12d3-a456-426614174000",
      "createTime": "2026-07-20T10:00:00Z",
      "updateTime": "2026-07-20T10:00:00Z",
      "justification": "Proposing a new glossary term definition for business accuracy.",
      "author": "user@example.com",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Langkah berikutnya