Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Halaman ini menjelaskan langkah-langkah yang perlu diselesaikan sebelum Anda
dapat mulai menggunakan Service Consumer Management API. Ini mengasumsikan bahwa Anda sudah memiliki
projectGoogle Cloud dan layanan terkelola
(seperti layanan terkelola yang dibuat menggunakan Cloud Endpoints) di
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 produsen layanan Anda adalah dengan menggunakan konsolGoogle 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:
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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-11 UTC."],[],[],null,["# Getting Started with the Service Consumer Management API\n\nThe page describes the steps that need to be completed before you\ncan start to use the Service Consumer Management API. It assumes that you already have a\nGoogle Cloud project and a [managed service](/service-infrastructure/docs/glossary#managed)\n(such as a managed service created using [Cloud Endpoints](/endpoints/docs)) in\nthat project, and that you understand\n[Tenancy Units](/service-infrastructure/docs/glossary#tenancy).\n\nActivating the service\n----------------------\n\nWhile the Service Consumer Management API helps you to manage the usage of your own\n[managed services](/service-infrastructure/docs/glossary#managed), it is also a service\nitself. Therefore, before you can use it, you must activate the\nService Consumer Management API for the Google Cloud project that hosts your managed\nservice. This project is known as a [service producer](/service-infrastructure/docs/glossary#producer)\nproject.\n\nThe simplest way to enable the Service Consumer Management API for your service\nproducer project is to use the\n[Google Cloud console](https://console.cloud.google.com/apis/api/serviceconsumermanagement.googleapis.com).\nAlternatively, you can enable it from the command line or programmatically. You\ncan find out more in\n[Enabling and Disabling Services](/service-usage/docs/enable-disable).\n\nSetting permissions\n-------------------\n\nAfter the Service Consumer Management API is enabled for your service producer\nproject, you must create your own service identity and grant it permissions on\nyour resources so that it can create [tenant projects](/service-infrastructure/docs/glossary#tenant) in\nyour folders and set up the correct billing account on tenant projects. These\nactions are executed by a service account owned by the Service Consumer Management\nAPI, which is specified in the following format: \n\n```\nservice-PROJECT_NUMBER@service-consumer-management.iam.gserviceaccount.com\n```\n\nwhere *PROJECT_NUMBER* is the project number for your service producer project\nthat activated the Service Consumer Management service.\n\nThe remainder of this guide uses *GCM_SA* to represent the\nService Consumer Management API service account.\n\nYou can use the following commands to generate the service identity.\n\n1. Login with your user account.\n\n```\ngcloud auth login\n```\n\n1. Generate the service identity.\n\n```\ngcloud beta services identity create --service=serviceconsumermanagement.googleapis.com --project=PROJECT_ID\n```\n\n### Setting folder permissions\n\n1. Ensure that you have a folder for holding your tenant projects: you'll need\n to have an [Organization](/resource-manager/docs/creating-managing-organization)\n to create folders within your service producer project. If you don't have a\n folder, follow the instructions in\n [Creating and Managing Folders](/resource-manager/docs/creating-managing-folders#create-folder)\n to create one. Your folder will have an integer based *FOLDER_ID*.\n\n2. On your folder, assign the **Project Creator/Deleter** role to the\n Service Consumer Management API service account. Follow the instructions in\n [Configuring Access to Folders](/resource-manager/docs/creating-managing-folders#configuring_access_to_folders)\n to add the **Project Creator** and **Project Deleter** role, using *GCM_SA* as\n the user.\n\n### Setting billing account permissions\n\n1. Ensure that you have a billing account that can be shared for tenant\n projects. If you don't have a billing account, see\n [Create, Modify, or Close a Billing Account](/billing/docs/how-to/manage-billing-account)\n for instructions to create one.\n\n2. Follow the\n [instructions](/billing/docs/how-to/billing-access)\n to add the **Billing Account User** role to *GCM_SA*.\n\nResource requirements\n---------------------\n\n- The Service Consumer Management API creates [tenant projects](/service-infrastructure/docs/glossary#tenant) on your behalf, so ensure you have enough quota to create them.\n- See the [project limits](https://cloud.google.com/resource-manager/docs/limits#project-limits) documentation to know how many projects can be created by default and to request increases to that limit."]]
