Dokumen ini membahas cara menetapkan izin dan mengaktifkan akses sehingga Anda dapat:
- Melihat peristiwa Service Health menggunakan dasbor Service Health.
- Mengambil informasi Service Health menggunakan Service Health API.
- Mengonfigurasi pemberitahuan yang relevan dengan project Anda.
Sebelum memulai
Pastikan penagihan diaktifkan untuk Google Cloud project Anda.
Mengakses Service Health API dan dasbor
Personalized Service Health menyediakan peran servicehealth.viewer bawaan yang dapat Anda gunakan untuk memberikan akses kepada anggota project. Gunakan peran ini untuk mengakses Service Health API dan dasbor.
| Nama peran | Deskripsi | Izin Personalized Service Health |
roles/servicehealth.viewer Personalized Service Health viewer
|
Akses hanya baca ke peristiwa Service Health. | servicehealth.location.list
|
Anda dapat menggunakan peran dan izin langsung melalui gcloud CLI untuk menyiapkan kontrol akses yang tepat. Misalnya, Anda dapat memberikan peran secara langsung dengan perintah berikut:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member {USER|GROUP|SERVICE_ACCOUNT} \
--role roles/servicehealth.viewer
Anda dapat melihat kebijakan Identity and Access Management (IAM) untuk project tertentu dengan perintah berikut:
gcloud projects get-iam-policy PROJECT_ID
Atau, Anda dapat menambahkan izin langsung ke peran yang ada:
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
--add-permissions=servicehealth.events.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
--add-permissions=servicehealth.events.get
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
--add-permissions=servicehealth.locations.list
gcloud iam roles update ROLE_ID --project=PROJECT_ID \
--add-permissions=servicehealth.locations.get
Menggunakan API dan layanan di project Anda
- Aktifkan Service Health API untuk project.
- Berikan peran Service Usage Consumer (
roles/serviceusage.serviceUsageConsumer).
Mengakses log dan mengonfigurasi pemberitahuan log
Lakukan tindakan berikut:
- Aktifkan Service Health API untuk project.
- Dapatkan izin untuk pemberitahuan berbasis log.
Jika tidak ingin memberikan peran Monitoring NotificationChannel Editor
(roles/monitoring.notificationChannelEditor), Anda dapat memberikan peran Monitoring NotificationChannel Viewer (roles/monitoring.notificationChannelViewer) sebagai gantinya untuk memungkinkan Anda menautkan ke saluran notifikasi ke kebijakan pemberitahuan.
Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran kustom atau peran bawaan lainnya.
Mengaktifkan Service Health API untuk satu project
Menyiapkan pemberitahuan dan mengambil informasi Service Health memerlukan pengaktifan Service Health API. Anda dapat mengaktifkan API melalui Google Cloud konsol atau Google Cloud CLI.
Konsol
Di library APIs and Services, buka Service Health API.
Atau, Anda dapat membuka API Library dan menelusuri "Service Health API".
Pilih project.
Pilih tombol Enable.
gcloud
-
Di Google Cloud konsol, aktifkan Cloud Shell.
Pastikan Google Cloud CLI versi terbaru telah diinstal. Jalankan perintah berikut dari Cloud Shell:
gcloud components update
Buat atau pilih project baru,
PROJECT_ID.Buat Google Cloud project:
gcloud projects create PROJECT_ID
Pilih Google Cloud project yang Anda buat:
gcloud projects config set project PROJECT_ID
Aktifkan Service Health API di project yang baru Anda buat.
gcloud services enable servicehealth.googleapis.com \ --project PROJECT_ID
Skrip
Anda dapat menggunakan skrip untuk mengaktifkan Service Health API untuk project di organisasi atau folder Anda.
Untuk informasi latar belakang, lihat Mengaktifkan API di Google Cloud project Anda.
Service Health API dan pemberitahuan akan mengenali peristiwa baru beberapa jam setelah pengaktifan API.