Halaman ini menjelaskan langkah-langkah yang perlu diselesaikan sebelum Anda dapat mulai menggunakan Service Consumer Management API. Anda dianggap sudah memiliki project Google Cloud dan layanan terkelola (seperti layanan terkelola yang dibuat menggunakan Cloud Endpoints) dalam project tersebut, dan bahwa Anda memahami Unit Tenancy.
Mengaktifkan layanan
Meskipun Service Consumer Management API membantu Anda mengelola penggunaan layanan terkelola Anda sendiri, Service Consumer Management API juga merupakan layanan itu sendiri. Oleh karena itu, sebelum dapat menggunakannya, Anda harus mengaktifkan Service Consumer Management API untuk project Google Cloud yang menghosting layanan terkelola Anda. Project ini dikenal sebagai project produsen layanan.
Cara termudah untuk mengaktifkan Service Consumer Management API untuk project produsen layanan Anda adalah dengan menggunakan Google Cloud Console. Atau, Anda dapat mengaktifkannya dari command line atau secara terprogram. Anda dapat mencari tahu lebih lanjut di Mengaktifkan dan Menonaktifkan Layanan.
Menetapkan izin
Setelah Service Consumer Management API diaktifkan untuk project produsen layanan, Anda harus membuat identitas layanan Anda sendiri dan memberikan izin pada resource Anda agar dapat membuat project tenant di folder Anda dan menyiapkan akun penagihan yang benar pada project tenant. Tindakan ini dijalankan oleh akun layanan yang dimiliki oleh Service Consumer Management API, yang ditentukan dalam format berikut:
service-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com
dengan PROJECT_NUMBER adalah nomor project untuk project produsen layanan Anda yang mengaktifkan layanan Pengelolaan Konsumen Layanan.
Bagian selanjutnya dari panduan ini menggunakan GCM_SA untuk mewakili akun layanan Service Consumer Management API.
Anda dapat menggunakan perintah berikut untuk membuat identitas layanan.
- Masuk dengan akun pengguna Anda.
gcloud auth login
- Membuat identitas layanan.
gcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID
Menyetel izin folder
Pastikan Anda memiliki folder untuk menyimpan project tenant: Anda harus memiliki Organisasi untuk membuat folder dalam project produsen layanan Anda. Jika Anda tidak memiliki folder, ikuti petunjuk dalam Membuat dan Mengelola Folder untuk membuatnya. Folder Anda akan memiliki FOLDER_ID berbasis bilangan bulat.
Di folder Anda, tetapkan peran Project Creator/Deleter untuk akun layanan Service Consumer Management API. Ikuti petunjuk di Mengonfigurasi Akses ke Folder untuk menambahkan peran Project Creator dan Project Deleter, menggunakan GCM_SA sebagai pengguna.
Menetapkan izin akun penagihan
Pastikan Anda memiliki akun penagihan yang dapat dibagikan untuk project tenant. Jika Anda belum memiliki akun penagihan, lihat Membuat, Mengubah, atau Menutup Akun Penagihan untuk mengetahui petunjuk cara membuatnya.
Ikuti instructions untuk menambahkan peran Billing Account User ke GCM_SA.
Persyaratan resource
- Service Consumer Management API membuat project tenant atas nama Anda, jadi pastikan Anda memiliki cukup kuota untuk membuatnya.
- Lihat dokumentasi batas project untuk mengetahui jumlah project yang dapat dibuat secara default dan untuk meminta peningkatan batas tersebut.