本文說明如何設定權限及啟用存取權,以便:
- 使用 Service Health 資訊主頁查看 Personalized Service Health 事件。
- 使用 Service Health API 提取 Service Health 資訊。
- 設定專案相關快訊。
事前準備
存取 Service Health API 和資訊主頁
如要取得存取 Service Health API 和資訊主頁所需的權限,請要求管理員授予您專案的Personalized Service Health Viewer (roles/servicehealth.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
您可以直接透過 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 \
--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"
控管受影響資源詳細資料的存取權 (預先發布版)
servicehealth.impacts.list 和 servicehealth.impacts.get 權限包含在預先定義的 Service Health 檢視者角色 (roles/servicehealth.viewer) 和基本檢視者、編輯者和擁有者角色 (roles/viewer、roles/editor、roles/owner) 中。
當服務中斷影響專案中的特定資源時,主體可透過這些權限,查看專案中受影響資源的完整資源名稱 (assetName) 和資源類型 (assetType)。
如要讓主體查看專案層級的 Service Health 事件,但不顯示專案中受影響的個別資源名稱,請建立自訂角色,其中包含 servicehealth.events.get 和 servicehealth.events.list,但省略 servicehealth.impacts.get 和 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"
在專案中使用 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 資訊,必須啟用 Service Health API。您可以透過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 後,Service Health API 和快訊會在幾小時內辨識新事件。