Halaman ini menjelaskan cara membuat, menghapus, dan menghapus project tenant.
Anda dapat menggunakan Service Consumer Management API untuk membuat dan mengonfigurasi project tenant, yaitu project Google Cloud yang digunakan untuk menghosting resource layanan terkelola yang dikhususkan untuk satu konsumen layanan. Setiap project tenant dikaitkan dengan unit tenancy.
Unit tenant dapat berisi beberapa project tenant, yang masing-masing diberikan ID tag: string yang dapat Anda gunakan untuk menunjukkan tujuan project dan merujuknya saat pencabutan akses.
Setelah dibuat, project tenant hanyalah project Google Cloud di organisasi Anda. Anda dapat menggunakan alat pengelolaan apa pun untuk mengerjakannya seperti yang biasa Anda gunakan untuk project Google Cloud.
Membuat project tenant
Untuk membuat project tenant dan menambahkannya ke unit tenant, panggil metode services.tenancyUnits.addProject.
Contoh berikut menambahkan project tenant baru dengan tag tag1 ke unit tenant menggunakan REST API:
POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef:addProject
Panggilan tersebut mencakup data berikut:
{"tag":"tag1", "project_config":{"folder":"folders/9876543210", "tenant_project_policy":{"policy_bindings":{"role":"roles/owner", "members":"user:bob@example.com"}}, "billing_config":{"billing_account":"billingAccounts/123456-472F22-28F9AA"}}}
Panggilan ini menampilkan operasi yang berjalan lama yang dapat Anda kueri untuk mengonfirmasi bahwa pembuatan project berhasil.
Project tenant baru dikonfigurasi dengan lien project, yaitu properti yang ditetapkan pada project tenant untuk mencegah penghapusan yang tidak disengaja. Anda harus memanggil metode
services.tenancyUnits.removeProject
untuk melepaskan lien dan menghapus project. Sebaiknya jangan
mengabaikan perlindungan ini.
Project tenant dibuat di folder yang Anda tentukan selama Penyiapan dan Konfigurasi. Sebaiknya jangan memindahkan project ke folder lain setelah dibuat.
Akun layanan Service Consumer Management API adalah pembuat dan pemilik project tenant, selain pemilik lain yang ditentukan dalam konfigurasi project tenant. Sebaiknya jangan menghapus akun ini sebagai pemilik.
Dalam beberapa kasus, Anda mungkin ingin memperbarui project Google Cloud yang ada agar menjadi project tenant, bukan membuat project tenant baru. Untuk menambahkan project Google Cloud yang ada ke unit tenancy, panggil metode services.tenancyUnits.attachProject.
Menghapus project tenant
Untuk menghapus project tenant dengan tag abc, panggil metode services.tenancyUnits.removeProject seperti yang ditunjukkan oleh contoh berikut:
POST https://serviceconsumermanagement.googleapis.com/v1/services/your-service.example.com/projects/12345678901/tenancyUnits/absdef:removeProject
Panggilan tersebut mencakup data berikut:
{"tag":"abc"}
Operasi ini menghapus lien project, menghapus project dan semua resource di dalamnya, serta menghapus semua metadata yang terkait dari unit tenancy.
Tindakan ini akan menghapus project dan semua metadata tentangnya dari unit
tenancy. Jika Anda ingin menghapus project, tetapi tetap menyimpan catatannya, panggil
metode
services.tenancyUnits.deleteProject. Metode ini menghapus project dan mempertahankan metadata,
menganotasinya dengan status DELETED. Untuk membatalkan penghapusan project yang telah dihapus, panggil metode services.tenancyUnits.undeleteProject.