Menghapus domain dari daftar yang diizinkan

Halaman ini menjelaskan cara menghapus domain dari daftar yang diizinkan menggunakan Allowlisted Domains API.

Sebelum memulai

• Baca Ringkasan Allowlisted Domains API.
• Siapkan Allowlisted Domains API.

Menghapus domain dari daftar yang diizinkan

Gunakan metode delete untuk menghapus domain. Mutasi ini bersifat asinkron dan menampilkan Operasi yang Berjalan Lama (LRO).

Python

def delete_allowlisted_domain(service, resource_name):
  """Deletes an allowlisted domain."""
  if not resource_name:
    print('Resource name is missing.')
    return None

  try:
    response = (
        service.allowlistedDomains().delete(name=resource_name).execute()
    )
    return response
  except Exception as e:
    print(f'An error occurred during delete: {e}')
    return None

Penanganan Error

Kondisi Error	Kode Status RPC	Pesan Error	Pemecahan Masalah / Justifikasi
Tidak memiliki otorisasi ke resource	PERMISSION_DENIED (403)	"Permission denied for allowlisted domain resource."	• Pastikan pengguna telah diberi cakupan yang sesuai. • Pastikan pengguna memiliki izin yang diperlukan. • Hubungi email kontak untuk memastikan apakah project/pengguna telah dimasukkan dalam daftar yang diizinkan atau tidak.
ID Pelanggan tidak ditemukan untuk pengguna	NOT_FOUND (404)	"Customer ID not found for user."	Pengguna yang login tidak ditautkan ke domain yang valid.
Pembaruan daftar yang diizinkan sedang berlangsung.	FAILED_PRECONDITION (400)	"An allowlist update is already in progress. Please wait for it to complete before making another request."	Tunggu hingga operasi mutasi (pembuatan atau penghapusan) sebelumnya selesai sebelum memulai permintaan baru.
Domain tidak ditemukan dalam daftar yang diizinkan	NOT_FOUND (404)	"Allowlisted domain <domain> not found."	Domain yang diberikan tidak ada dalam daftar yang diizinkan. Hal ini dapat terjadi jika domain tidak ditambahkan atau sudah dihapus dari daftar yang diizinkan. Anda dapat memeriksa log audit untuk memvalidasi apakah domain ditambahkan/dihapus dalam 6 bulan terakhir.
Nama resource tidak valid	INVALID_ARGUMENT (400)	"Invalid resource name: <resourceName>."	Untuk mengatasi error Nama resource tidak valid, pastikan ID yang diberikan dalam permintaan DELETE diformat dan bersumber dengan benar: • Validasi format nama resource: String yang digunakan untuk parameter nama harus mengikuti format allowlistedDomains/UNIQUE_IDENTIFIER dengan tepat. • Verifikasi sumber nama: Nama resource adalah ID Hanya output dan harus diperoleh dari panggilan sebelumnya yang berhasil ke metode allowlistedDomains.list untuk pelanggan yang sama. Jangan membuat atau menebak nama resource.

Log Audit

Penghapusan menggunakan Allowlisted Domains API menghasilkan peristiwa log audit yang dapat ditinjau oleh administrator. Untuk mengetahui informasi selengkapnya, lihat Melihat log audit.