Mengelola permintaan perubahan dengan alur kerja tata kelola

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Alur kerja tata kelola di Knowledge Catalog memungkinkan Anda melacak, mengevaluasi, dan mengaudit permintaan perubahan, seperti permintaan akses produk data, di seluruh siklus prosesnya. Sebagai pemohon, pemberi persetujuan, atau administrator alur kerja, Anda dapat mengubah permintaan yang tertunda, menyetujui atau menolak akses untuk mengotomatiskan penyediaan, dan memantau log persetujuan untuk kepatuhan.

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.

Aktifkan Dataplex API, jika belum diaktifkan.

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 Service Usage Admin (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 pada project Anda:

• Menelusuri produk data: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
• Menelusuri aset data dan meminta akses: Dataplex Data Products Consumer (roles/dataplex.dataProductsConsumer)
• Akses hanya baca untuk melihat definisi dan metadata produk data: Dataplex Data Products Viewer (roles/dataplex.dataProductsViewer)
• Menyetujui permintaan akses produk data:
  • Dataplex Data Products Editor (roles/dataplex.dataProductsEditor)
  • Dataplex Data Products Admin (roles/dataplex.dataProductsAdmin)
  • Dataplex Workflow Approver (roles/dataplex.workflowApprover)
• Mengelola alur kerja tata kelola: Dataplex Workflow Admin (roles/dataplex.workflowAdmin)

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 tertunda dalam status NEW, atau menghapus permintaan sebelum pemberi persetujuan menanganinya.

Melihat permintaan yang dibuat

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

Konsol

1. Di konsol Google Cloud , buka halaman Governance Workflows Knowledge Catalog.

   Buka Governance workflows

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 project Google Cloud 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:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests?filter=author=USER_EMAIL" | Select-Object -Expand Content

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 project Google Cloud 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/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_ID/locations/TARGET_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": "[e-mail]",
  "state": "NEW",
  "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
  "createGlossaryTerm": {
    "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
    "termId": "sample-term-id",
    "term": {
      "displayName": "Sample term name",
      "description": "Sample term description",
      "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
    }
  }
}

Mengedit permintaan

Anda dapat memperbarui detail permintaan tertunda yang ada dalam status NEW. Misalnya, Anda dapat mengubah justifikasi 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 project Google Cloud 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/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification

Meminta isi JSON:

{
  "justification": "NEW_JUSTIFICATION"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID?updateMask=justification" | Select-Object -Expand Content

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

Menghapus permintaan

Anda hanya dapat menghapus permintaan yang berada dalam status NEW. Untuk menghapus permintaan, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Governance Workflows Knowledge Catalog.

   Buka Governance workflows

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 project Google Cloud 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/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID" | Select-Object -Expand Content

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 diajukan untuk resource data Anda. Saat Anda menyetujui atau menolak permintaan, sistem akan otomatis memproses keputusan dan mengirimkan notifikasi email kepada pemohon yang berisi detail keputusan dan alasan Anda.

Mencantumkan permintaan yang menunggu keputusan

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

Konsol

1. Di konsol Google Cloud , buka halaman Governance Workflows Knowledge Catalog.

   Buka Governance Workflows

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 project Google Cloud Anda.
• LOCATION: region tempat resource berada. Contoh, us-central1.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/TARGET_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": "[e-mail]",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Menyetujui permintaan

Untuk menyetujui permintaan, ikuti langkah-langkah berikut:

Konsol

1. Di konsol Google Cloud , buka halaman Governance Workflows Knowledge Catalog.

   Buka Governance Workflows

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 project Google Cloud 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/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:approve" | Select-Object -Expand Content

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

Setelah diproses, status permintaan akan otomatis diperbarui 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 Governance Workflows Knowledge Catalog.

   Buka Governance Workflows

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 project Google Cloud Anda.
• LOCATION: region tempat resource berada (misalnya, us-central1).
• CHANGE_REQUEST_ID: ID unik permintaan perubahan yang ingin Anda tolak.
• REJECTION_REASON: justifikasi penolakan.

Metode HTTP dan URL:

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

Meminta isi JSON:

{
  "comment": "REJECTION_REASON"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:reject"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests/CHANGE_REQUEST_ID:reject" | Select-Object -Expand Content

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

Memberikan komentar penolakan yang jelas akan membantu pemohon memahami keputusan dan menyempurnakan justifikasi 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 project Google Cloud Anda.
• LOCATION: region tempat resource berada. Contoh, us-central1.

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/TARGET_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": "[e-mail]",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Melacak histori persetujuan

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

Konsol

1. Di konsol Google Cloud , buka halaman Governance Workflows.

   Buka Governance Workflows

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

REST

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

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

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

Metode HTTP dan URL:

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

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/TARGET_LOCATION/changeRequests" | Select-Object -Expand Content

Anda akan menerima respons JSON yang mirip seperti berikut:

{
  "changeRequests": [
    {
      "name": "projects/PROJECT_ID/locations/TARGET_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": "[e-mail]",
      "state": "NEW",
      "resource": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
      "createGlossaryTerm": {
        "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary",
        "termId": "sample-term-id",
        "term": {
          "displayName": "Sample term name",
          "description": "Sample term description",
          "parent": "projects/PROJECT_ID/locations/TARGET_LOCATION/glossaries/sample-glossary"
        }
      }
    }
  ]
}

Langkah berikutnya

• Pelajari lebih lanjut alur kerja tata kelola