Panduan ini menjelaskan semua langkah penyiapan yang diperlukan untuk mulai menggunakan Cloud Billing Budget API.
Sebelum memulai
Anda harus melakukan hal berikut sebelum membaca panduan ini:
- Membaca Ringkasan Cloud Billing Budget API.
- Membaca Prasyarat Cloud Billing Budget API.
Tentang konsol Google Cloud
Konsol Google Cloud (kunjungi dokumentasi, buka konsol) adalah UI web yang digunakan untuk menyediakan, mengonfigurasi, mengelola, dan memantau sistem yang digunakan produk Google Cloud. Anda dapat menggunakan Konsol Google Cloud untuk menyiapkan dan mengelola resource Google Cloud dan Penagihan Cloud.
1. Memilih atau Membuat project
Untuk menggunakan layanan yang disediakan oleh Google Cloud, Anda harus membuat project. Project menyusun semua resource Google Cloud Anda. Project terdiri dari sekumpulan kolaborator, API yang diaktifkan (dan resource lainnya), alat pemantauan, informasi penagihan, serta kontrol akses dan autentikasi. Anda dapat membuat satu atau beberapa project, dan menggunakannya untuk menyusun resource Google Cloud Anda dalam hierarki resource. Untuk mengetahui informasi project lebih lanjut, lihat dokumentasi Resource Manager.
Rekomendasi tentang project: Sebaiknya buat dan gunakan project Google Cloud terpisah untuk menampung semua kebutuhan FinOps dan administrasi penagihan untuk akun Penagihan Cloud, termasuk penggunaan Cloud Billing Budget API. Pelajari lebih lanjut manfaat menggunakan project yang berfokus pada FinOps untuk kasus penggunaan administrasi penagihan Anda.
Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.
2. Mengaktifkan penagihan
Anda harus memastikan bahwa penagihan diaktifkan telah pada project yang Anda gunakan untuk memanggil Cloud Billing Budget API. Jika Anda mengikuti rekomendasi di bagian project, berarti ini adalah project Google Cloud FinOps atau administrasi penagihan Anda.
Make sure that billing is enabled for your Google Cloud project.
Akun Penagihan Cloud digunakan untuk menentukan individu yang akan membayar kumpulan resource Google Cloud tertentu. Resource, seperti API yang diaktifkan, diatur dalam project. Akun Penagihan Cloud dapat ditautkan ke satu atau beberapa project. Penggunaan project ditagihkan ke akun penagihan tertaut. Dalam sebagian besar kasus, Anda mengonfigurasi penagihan saat membuat project. Untuk mengetahui informasi selengkapnya, lihat dokumentasi Penagihan Cloud.
Biaya penggunaan
Anda menyiapkan anggaran Penagihan Cloud untuk memantau biaya yang dikeluarkan di akun Penagihan Cloud. Akun Penagihan Cloud yang Anda pantau dapat merupakan akun Penagihan Cloud yang sama dengan yang ditautkan ke project yang digunakan untuk memanggil Cloud Billing Budget API. Perhatikan bahwa Cloud Billing Budget API gratis digunakan oleh pelanggan Google Cloud. Jika memilih mengonfigurasi notifikasi anggaran terprogram, Anda akan dikenai harga Pub/Sub standar.
3. Mengaktifkan API
Anda harus mengaktifkan Cloud Billing Budget API di project yang Anda gunakan untuk memanggil Cloud Billing Budget API. Jika Anda mengikuti rekomendasi di bagian project, berarti ini adalah project Google Cloud FinOps atau administrasi penagihan Anda.
Untuk informasi selengkapnya tentang mengaktifkan API, lihat dokumentasi Service Usage.
Aktifkan Cloud Billing Budget API.
4. Menyiapkan autentikasi dan otorisasi
Jika berencana menggunakan Cloud Billing Budget API, Anda perlu menyiapkan autentikasi. Setiap aplikasi klien yang menggunakan API harus mengonfirmasi identitasnya dengan cara mengautentikasi. Untuk mengetahui detailnya, lihat Mengautentikasi ke Penagihan Cloud.
Anda mengautentikasi sebagai akun utama tertentu, seperti Akun Google atau akun layanan. Akun utama tersebut harus memiliki peran Identity and Access Management (IAM) yang berisi izin yang diperlukan untuk Cloud Billing Budget API.
Untuk memastikan akun utama memiliki izin yang
diperlukan untuk mengelola anggaran,
minta administrator Anda untuk memberikan peran IAM
Billing Account Administrator (roles/billing.admin) kepada akun utama di akun penagihan Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Administrator Anda mungkin juga dapat memberikan izin yang diperlukan kepada akun utama melalui peran khusus atau peran bawaan lainnya.
Untuk mempelajari cara memberikan peran pada akun penagihan, lihat Memperbarui izin Penagihan Cloud.
5. Menginstal dan melakukan inisialisasi gcloud CLI.
Jika berencana menggunakan Cloud Billing Budget API, Anda harus menginstal dan melakukan inisialisasi Google Cloud CLI. Google Cloud CLI adalah serangkaian alat yang dapat Anda gunakan untuk mengelola resource dan aplikasi yang dihosting di Google Cloud. Alat ini mencakup gcloud CLI. Link berikut berisi petunjuk:
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init6. Menguji SDK dan autentikasi
Jika di langkah sebelumnya Anda telah menyiapkan autentikasi, Anda dapat menggunakan gcloud CLI untuk menguji lingkungan autentikasi Anda. Jalankan perintah berikut untuk memverifikasi bahwa tidak terjadi error dan kredensial dapat ditampilkan:
gcloud auth print-access-token
Perintah tersebut digunakan oleh semua sampel REST command line Cloud Billing Budget API untuk mengautentikasi panggilan API.
7. Menginstal library klien Cloud Billing Budget API
Cloud Billing Budget API dibuat di HTTP dan JSON sehingga semua klien HTTP standar dapat mengirim permintaan ke Cloud Billing Budget API dan mengurai responsnya.
Anda memiliki tiga opsi untuk memanggil API:
Library klien yang didukung Google (direkomendasikan)
Library klien menyediakan integrasi bahasa yang lebih baik, keamanan yang ditingkatkan, dan dukungan untuk melakukan panggilan yang memerlukan otorisasi pengguna. Library klien yang didukung Google tersedia untuk beberapa bahasa populer, dan bahasa-bahasa ini adalah opsi yang direkomendasikan.