本文說明如何設定權限及啟用存取權,以便:
- 使用 Service Health 資訊主頁查看服務健康狀態事件。
- 使用 Service Health API 擷取服務健康狀態資訊。
- 設定專案相關快訊。
事前準備
存取 Service Health API 和資訊主頁
Personalized Service Health 提供預先定義的 servicehealth.viewer 角色,可用於授予專案成員存取權。使用這個角色,即可存取 Service Health API 和資訊主頁。
| 角色名稱 | 說明 | Personalized Service Health 權限 |
roles/servicehealth.viewer Personalized Service Health 檢視者 |
具備 Service Health 事件的唯讀存取權。 | servicehealth.location.list
|
您可以直接透過 gcloud CLI 使用角色和權限,設定適當的存取控管機制。舉例來說,您可以使用下列指令直接授予角色:
gcloud projects add-iam-policy-binding PROJECT_ID \
--member {USER|GROUP|SERVICE_ACCOUNT} \
--role roles/servicehealth.viewer
您可以使用下列指令,查看指定專案的身分與存取權管理 (IAM) 政策:
gcloud projects get-iam-policy PROJECT_ID
或者,您也可以直接將權限新增至現有角色:
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
在專案中使用 API 和服務
- 為專案啟用 Service Health API。
- 授予服務使用情形消費者角色 (
roles/serviceusage.serviceUsageConsumer)。
存取記錄檔及設定記錄檔快訊
請執行下列步驟:
- 為專案啟用 Service Health API。
- 取得記錄型快訊的權限。
如果不想授予 Monitoring NotificationChannel 編輯者角色 (roles/monitoring.notificationChannelEditor),可以改為授予 Monitoring NotificationChannel 檢視者角色 (roles/monitoring.notificationChannelViewer),以便將通知管道連結至警告政策。
如要進一步瞭解如何授予角色,請參閱「管理存取權」。
為單一專案啟用 Service Health API
必須啟用 Service Health API,才能設定警告及提取 Service Health 資訊。您可以透過Google Cloud 控制台或 Google Cloud CLI 啟用 API。
控制台
在「API 和服務」程式庫中,前往「Service Health API」。
或者,您也可以前往 API 程式庫,搜尋「Service Health API」。
選取專案。
選取「啟用」按鈕。
gcloud
-
在 Google Cloud 控制台中啟用 Cloud Shell。
請確認您已安裝最新版本的 Google Cloud CLI。在 Cloud Shell 中執行下列指令:
gcloud components update
建立或選取新專案
PROJECT_ID。建立 Google Cloud 專案:
gcloud projects create PROJECT_ID
選取您建立的 Google Cloud 專案:
gcloud projects config set project PROJECT_ID
在剛建立的專案中啟用 Service Health API。
gcloud services enable servicehealth.googleapis.com \ --project PROJECT_ID
指令碼
您可以使用指令碼,為組織或資料夾中的專案啟用 Service Health API。
如需背景資訊,請參閱「在專案中啟用 API Google Cloud 」。
啟用 API 後,Service Health API 和快訊會在幾小時內辨識新事件。