Dokumen ini membahas cara menetapkan izin dan mengaktifkan akses agar Anda dapat:
- Melihat peristiwa Personalized Service Health menggunakan dasbor Service Health.
- Tarik informasi Service Health menggunakan Service Health API.
- Konfigurasikan pemberitahuan yang relevan dengan project Anda.
Sebelum memulai
Pastikan penagihan diaktifkan untuk project Google Cloud Anda.
Mengakses Service Health API dan dasbor
Untuk mendapatkan izin yang
diperlukan untuk mengakses Service Health API dan dasbor,
minta administrator untuk memberi Anda
peran IAM Personalized Service Health Viewer (roles/servicehealth.viewer) di project Anda.
Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.
Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.
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 \
--permissions="servicehealth.events.get,servicehealth.events.list,servicehealth.impacts.get,servicehealth.impacts.list,servicehealth.locations.get,servicehealth.locations.list,servicehealth.organizationEvents.get,servicehealth.organizationEvents.list,servicehealth.organizationImpacts.get,servicehealth.organizationImpacts.list,servicehealth.statuses.get,resourcemanager.projects.get,resourcemanager.projects.list"
Mengontrol akses ke detail resource yang terpengaruh (Pratinjau)
Izin servicehealth.impacts.list dan servicehealth.impacts.get
disertakan dalam peran Service Health Viewer yang telah ditetapkan
(roles/servicehealth.viewer) dan peran dasar Viewer, Editor, dan Owner
(roles/viewer, roles/editor, roles/owner).
Jika gangguan layanan memengaruhi resource tertentu dalam project Anda, izin ini memungkinkan akun utama melihat nama resource lengkap (assetName) dan jenis resource (assetType) dari resource yang terpengaruh di seluruh project.
Jika Anda ingin akun utama melihat peristiwa Service Health level project
tanpa melihat nama setiap resource yang terpengaruh dalam project,
buat peran khusus yang menyertakan servicehealth.events.get dan
servicehealth.events.list, tetapi menghilangkan servicehealth.impacts.get dan
servicehealth.impacts.list:
gcloud iam roles create EVENT_ONLY_ROLE_ID --project=PROJECT_ID \
--title="Service Health Event-Only Viewer" \
--description="Grants access to Service Health project events without resource-level impact details" \
--permissions="servicehealth.events.get,servicehealth.events.list,servicehealth.locations.get,servicehealth.locations.list,servicehealth.statuses.get,resourcemanager.projects.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) untuk memungkinkan Anda menautkan 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 khusus 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 konsolGoogle Cloud atau Google Cloud CLI.
Konsol
Di library API dan Layanan, buka Service Health API.
Atau, Anda dapat membuka Library API dan menelusuri "Service Health API".
Pilih project.
Pilih tombol Enable.
gcloud
-
Di konsol Google Cloud , 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 project Google Cloud :
gcloud projects create PROJECT_ID
Pilih project Google Cloud yang Anda buat:
gcloud projects config set project PROJECT_ID
Aktifkan Service Health API di project yang baru saja 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.
Service Health API dan pemberitahuan akan mengenali peristiwa baru beberapa jam setelah pengaktifan API.