Halaman ini menjelaskan cara membuat, menghapus, dan menghapus project tenant.
Anda menggunakan Service Consumer Management API untuk membuat dan mengonfigurasi project tenant, yaitu project Google Cloud yang digunakan untuk menghosting resource layanan terkelola yang didedikasikan untuk satu konsumen layanan. Setiap project tenant dikaitkan dengan unit tenancy.
Unit sewa dapat berisi beberapa project tenant, yang masing-masing diberi
ID tag: string yang dapat Anda gunakan untuk menunjukkan tujuan project
dan untuk merujuknya saat melakukan de-provisioning.
Setelah dibuat, project tenant hanyalah project Google Cloud di organisasi Anda. Anda dapat menggunakan alat pengelolaan apa pun untuk menggunakannya seperti yang biasa Anda gunakan untuk project Google Cloud.
Membuat project tenant
Untuk membuat project tenant dan menambahkannya ke unit sewa, panggil metode
services.tenancyUnits.addProject.
Contoh berikut menambahkan project tenant baru dengan tag tag1 ke unit
tenancy 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: 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
mengelak perlindungan ini.
Project tenant dibuat di folder yang Anda tentukan selama Penyiapan dan Konfigurasi. Sebaiknya jangan pindahkan 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 hapus akun ini sebagai pemilik.
Dalam beberapa kasus, Anda mungkin ingin memperbarui project Google Cloud yang ada menjadi project tenant, bukan membuat project tenant baru. Untuk menambahkan project Google Cloud yang ada ke unit sewa, panggil metode services.tenancyUnits.attachProject.
Menghapus project tenant
Untuk menghapus project tenant dengan tag abc, panggil metode
services.tenancyUnits.removeProject
seperti yang diilustrasikan 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 metadata terkait dari unit tenancy.
Tindakan ini akan menghapus project, dan menghapus semua metadata tentang project tersebut dari unit
tenancy. Jika Anda ingin menghapus project, tetapi menyimpan catatannya, panggil metode
services.tenancyUnits.deleteProject. Metode ini menghapus project dan mempertahankan metadata,
menambahkan anotasi dengan status DELETED. Untuk membatalkan penghapusan project yang dihapus, panggil metode
services.tenancyUnits.undeleteProject.