Halaman ini menjelaskan langkah-langkah yang perlu diselesaikan sebelum Anda dapat mulai menggunakan Service Consumer Management API. Contoh ini mengasumsikan bahwa Anda sudah memiliki projectGoogle 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, API ini 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 produser layanan.
Cara termudah untuk mengaktifkan Service Consumer Management API untuk project produser layanan Anda adalah dengan menggunakan konsol Google Cloud . Atau, Anda dapat mengaktifkannya dari command line atau secara terprogram. Anda dapat mengetahui selengkapnya 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 di resource Anda sehingga dapat membuat project tenant di folder Anda dan menyiapkan akun penagihan yang benar di 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.
- Login dengan akun pengguna Anda.
gcloud auth login
- Buat identitas layanan.
gcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID
Menetapkan izin folder
Pastikan Anda memiliki folder untuk menyimpan project tenant: Anda harus memiliki Organisasi untuk membuat folder dalam project produsen layanan. Jika Anda tidak memiliki folder, ikuti petunjuk di Membuat dan Mengelola Folder untuk membuatnya. Folder Anda akan memiliki FOLDER_ID berbasis bilangan bulat.
Di folder Anda, tetapkan peran Project Creator/Deleter ke akun layanan Service Consumer Management API. Ikuti petunjuk di bagian 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 digunakan bersama untuk project tenant. Jika Anda tidak memiliki akun penagihan, lihat Membuat, Mengubah, atau Menutup Akun Penagihan untuk mengetahui petunjuk cara membuatnya.
Ikuti petunjuk 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 kuota yang cukup untuk membuatnya.
- Lihat dokumentasi batas project untuk mengetahui jumlah project yang dapat dibuat secara default dan untuk meminta peningkatan batas tersebut.