In diesem Dokument wird erläutert, wie Sie Personalized Service Health-Ereignisse auflisten, die sich auf Produkte von Google Cloud in Ihrem Projekt oder Ihrer Organisation in Google Cloud auswirken oder ausgewirkt haben. Sie verwenden die Personalized Service Health API.
Hinweis
-
Aktivieren Sie die Service Health API, falls sie noch nicht aktiviert ist:
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollengcloud services enable servicehealth.googleapis.com
-
Prüfen Sie, ob die Abrechnung für Ihr Google Cloud -Projekt aktiviert ist.
- Wenn Sie für diese Anleitung ein vorhandenes Projekt verwenden, prüfen Sie, ob Sie die erforderlichen Berechtigungen haben. Wenn Sie ein neues Projekt erstellt haben, haben Sie bereits die erforderlichen Berechtigungen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Personalized Service Health Viewer (roles/servicehealth.viewer) für das Projekt oder die Organisation zuzuweisen, für die Sie Ereignisse auflisten möchten, um die Berechtigungen zu erhalten, die Sie zum Auflisten von Service Health-Ereignissen benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Verweise
In den API-Referenzen für Events (v1, v1beta), Impacts (v1beta), OrganizationEvents (v1, v1beta) und OrganizationImpacts (v1, v1beta) finden Sie die Methoden, die Sie verwenden können, und die Bedeutung der Felder in der Antwort.
Verwenden Sie beim Festlegen des Produkts oder Standorts die Werte, die Sie unter Google Cloud -Produkte und Standorte finden.
Alle aktiven Vorfälle für ein Projekt auflisten
Sie können alle Google Cloud -Vorfälle für ein bestimmtes Google Cloud -Projekt auflisten.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- API_VERSION: Die zu verwendende API-Version. Verwenden Sie
v1oderv1beta. - PROJECT_ID: die ID des Projekts.
HTTP-Methode und URL:
GET https://servicehealth.googleapis.com/API_VERSION/projects/PROJECT_ID/locations/global/events?filter=state=ACTIVE%20category=INCIDENT&page_size=2&page_token={page_token}Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"events": [
{
"name": "projects/PROJECT_ID/locations/global/events/event-123",
"title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
"description": "The issue with Google Cloud SQL has been resolved for all affected projects. We thank you for your patience while we worked on resolving the issue.",
"category": "INCIDENT",
"detailedCategory": "CONFIRMED_INCIDENT",
"state": "ACTIVE",
"detailedState": "CONFIRMED",
"eventImpacts": [
{
"product": {
"productName": "Google Cloud SQL",
"id": "hV87iK5DcEXKgWU2kDri",
},
"location": {
"locationName": "asia-east2",
}
},
{
"product": {
"productName": "Google Cloud SQL",
"id": "hV87iK5DcEXKgWU2kDri",
},
"location": {
"locationName": "asia-southeast1",
}
}
],
"relevance": "RELATED",
"updateTime": "2022-10-18T17:44:05.690761Z",
"startTime": "2022-10-18T17:41:20.112287Z",
},
{
"name": "projects/PROJECT_ID/locations/global/events/event-567",
"title": "Cloud Firestore may experience errors.",
"description": "Mitigation work is currently underway by our engineering team. The mitigation is expected to complete by 2022-10-07T16:30:00Z.",
"category": "INCIDENT",
"detailedCategory": "CONFIRMED_INCIDENT",
"state": "ACTIVE",
"detailedState": "CONFIRMED",
"eventImpacts": [
{
"product": {
"productName": "Cloud Firestore",
"id": "CETSkT92V21G6A1x28me",
},
"location": {
"locationName": "us-central1-a",
}
}
],
"relevance": "RELATED",
"updateTime": "2022-10-07T15:19:59.409530Z",
"startTime": "2022-10-07T15:10:35.887125Z",
"nextUpdateTime": "2022-10-07T16:30:00Z"
}
],
"nextPageToken": "CgwIw8bDmgYQz4nUlgMQChomcHJvamVjdHMvcHNoLW1hbnVhbC"
}
Wenn Sie nicht die erforderlichen Berechtigungen zum Auflisten von Ereignissen haben, erhalten Sie den Fehler PERMISSION_DENIED.
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.events.list' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global' (or it may not exist).",
"status": "PERMISSION_DENIED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "IAM_PERMISSION_DENIED",
"domain": "servicehealth.googleapis.com",
"metadata": {
"resource": "projects/PROJECT_ID/locations/global",
"permission": "servicehealth.events.list"
}
}
]
}
}
Alle aktiven Vorfälle für eine Organisation auflisten
Sie können alle Google Cloud -Vorfälle auflisten, die sich auf ein Projekt auswirken, für das Personalized Service Health in der jeweiligen Google Cloud -Organisation aktiviert ist.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- API_VERSION: die zu verwendende API-Version. Verwenden Sie
v1oderv1beta. - ORGANIZATION_ID: Ihre Google Cloud-Organisations-ID.
- PROJECT_ID: die Projekt-ID, die für Kontingente und die Abrechnung verwendet wird.
HTTP-Methode und URL:
GET https://servicehealth.googleapis.com/API_VERSION/organizations/ORGANIZATION_ID/locations/global/organizationEvents?filter=state=ACTIVE%20category=INCIDENT&page_size=2&page_token={page_token}Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"organization_events": [
{
"name": "organizations/ORGANIZATION_ID/locations/global/organizationEvents/event-123",
"title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
"description": "The issue with Google Cloud SQL has been resolved for all affected projects. We thank you for your patience while we worked on resolving the issue.",
"category": "INCIDENT",
"detailedCategory": "CONFIRMED_INCIDENT",
"state": "ACTIVE",
"detailedState": "CONFIRMED",
"eventImpacts": [
{
"product": {
"productName": "Google Cloud SQL",
"id": "hV87iK5DcEXKgWU2kDri",
},
"location": {
"locationName": "asia-east2",
}
},
{
"product": {
"productName": "Google Cloud SQL",
"id": "hV87iK5DcEXKgWU2kDri",
},
"location": {
"locationName": "asia-southeast1",
}
}
],
"updateTime": "2022-10-18T17:44:05.690761Z",
"startTime": "2022-10-18T17:41:20.112287Z",
},
{
"name": "organizations/ORGANIZATION_ID/locations/global/organizationEvents/event-567",
"title": "Cloud Firestore may experience errors.",
"description": "Mitigation work is currently underway by our engineering team. The mitigation is expected to complete by 2022-10-07T16:30:00Z.",
"category": "INCIDENT",
"detailedCategory": "CONFIRMED_INCIDENT",
"state": "ACTIVE",
"detailedState": "CONFIRMED",
"eventImpacts": [
{
"product": {
"productName": "Cloud Firestore",
"id": "CETSkT92V21G6A1x28me",
},
"location": {
"locationName": "us-central1-a",
}
}
],
"updateTime": "2022-10-07T15:19:59.409530Z",
"startTime": "2022-10-07T15:10:35.887125Z",
"nextUpdateTime": "2022-10-07T16:30:00Z"
}
],
"nextPageToken": "CgwIw8bDmgYQz4nUlgMQChomcHJvamVjdHMvcHNoLW1hbnVhbC"
}
Informationen zum Abrufen Ihrer ORGANIZATION_ID finden Sie unter Organisationsressourcen-ID abrufen.
Wenn Sie nicht die Berechtigung zum Auflisten von Ereignissen haben, erhalten Sie den Fehler PERMISSION_DENIED.
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.organizationEvents.list' denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global' (or it may not exist).",
"status": "PERMISSION_DENIED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "IAM_PERMISSION_DENIED",
"domain": "servicehealth.googleapis.com",
"metadata": {
"resource": "organizations/<var class="readonly">ORGANIZATION_ID</var>/locations/global",
"permission": "servicehealth.organizationEvents.list"
}
}
]
}
}
Projekte in einer Organisation auflisten, die von einem Ereignis betroffen sein können
Sie können alle Projekte in einer bestimmten Google Cloud Organisation auflisten, die:
- Kann von einem Ereignis betroffen sein (
OrganizationImpact). - Personalized Service Health aktiviert haben.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- API_VERSION: die zu verwendende API-Version. Verwenden Sie
v1oderv1beta. - EVENT_ID: die ID des Ereignisses, das sich auf eine Organisation auswirken kann.
- ORGANIZATION_ID: Ihre Google Cloud-Organisations-ID.
- PROJECT_ID: die Projekt-ID, die für Kontingente und die Abrechnung verwendet wird.
HTTP-Methode und URL:
GET https://servicehealth.googleapis.com/API_VERSION/organizations/ORGANIZATION_ID/locations/global/organizationImpacts?filter=events:organizations%2FORGANIZATION_ID%2Flocations%2Fglobal%2FEVENT_ID&page_size=2&page_token={page_token}Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{
"organization_impacts": [
{
"name": "organizations/ORGANIZATION_ID/locations/global/organizationImpacts/impact-123",
"events": [
"organizations/ORGANIZATION_ID/locations/global/organizationEvents/EVENT_ID",
],
"asset": {
"assetName": "//cloudresourcemanager.googleapis.com/projects/{PROJECT_NUMBER_1}",
"assetType": "cloudresourcemanager.googleapis.com/Project",
},
"updateTime": "2022-10-18T17:44:05.690761Z",
},
{
"name": "organizations/ORGANIZATION_ID/locations/global/organizationImpacts/impact-234",
"events": [
"organizations/ORGANIZATION_ID/locations/global/organizationEvents/EVENT_ID",
],
"asset": {
"assetName": "//cloudresourcemanager.googleapis.com/projects/{PROJECT_NUMBER_2}",
"assetType": "cloudresourcemanager.googleapis.com/Project",
},
"updateTime": "2022-10-18T17:44:05.690761Z",
}
],
"nextPageToken": "CgwIw8bDmgYQz4nUlgMQChomcHJvamVjdHMvcHNoLW1hbnVhbC"
}
Wenn Sie nicht die Berechtigungen zum Auflisten von Ereignissen haben, erhalten Sie den folgenden PERMISSION_DENIED-Fehler.
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.organizationImpacts.list' denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global' (or it may not exist).",
"status": "PERMISSION_DENIED",
"details": [
{
"@type": "type.googleapis.com/google.rpc.ErrorInfo",
"reason": "IAM_PERMISSION_DENIED",
"domain": "servicehealth.googleapis.com",
"metadata": {
"resource": "organizations/ORGANIZATION_ID/locations/global",
"permission": "servicehealth.organizationImpacts.list"
}
}
]
}
}
Betroffene Ressourcen in einem Projekt auflisten
Für unterstützte Google Cloud Produkte können Sie die spezifischen Google Cloud Ressourcen in Ihrem Projekt auflisten, die von einem Service Health-Ereignis betroffen sind.
Damit betroffene Ressourcen aufgelistet werden können, muss die Service Health API (servicehealth.googleapis.com) mindestens 24 Stunden vor Beginn des Ereignisses für das Projekt aktiviert sein und Ihr Hauptkonto muss die Berechtigung servicehealth.impacts.list haben (in roles/servicehealth.viewer enthalten).
REST API (v1beta)
Wenn Sie die betroffenen Ressourcen in einem Projekt auflisten möchten, senden Sie eine Anfrage mit den folgenden Parametern an die Service Health API:
| Parameter | Wert | Beschreibung |
|---|---|---|
parent |
projects/PROJECT_ID/locations/global |
Erforderlich. Projekt-ID oder Projektnummer, für die Sie betroffene Ressourcen auflisten möchten. |
pageSize |
1 bis 100 | Optional. Maximale Anzahl der Auswirkungen, die pro Seite zurückgegeben werden sollen. Wenn nicht angegeben, wird der Wert standardmäßig auf 10 gesetzt. |
pageToken |
String | Optional. Token aus einem vorherigen ListImpactsResponse-Aufruf, um die nächste Ergebnisseite abzurufen. |
filter |
String | Optional. Filterausdruck, um die zurückgegebenen Auswirkungen einzugrenzen. Wenn Sie beispielsweise Ressourcen auflisten möchten, die von einem bestimmten Ereignis betroffen sind, legen Sie filter=events:projects/PROJECT_ID/locations/global/events/EVENT_ID fest. |
Ersetzen Sie folgende Werte in den Anfragedaten:
PROJECT_ID: Ihre Google Cloud-Projekt-ID oder -Projektnummer.
HTTP-Methode und URL:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts
Wenn Sie curl verwenden möchten, rufen Sie den GET-Endpunkt direkt auf:
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts"
gcloud
Führen Sie den folgenden Befehl aus, um die betroffenen Ressourcen in einem Projekt aufzulisten:
gcloud beta service-health impacts list \
--project=PROJECT_ID \
--location=global
Wenn Sie nur die Ressourcen auflisten möchten, die von einem bestimmten Ereignis betroffen sind, übergeben Sie das Flag --filter:
gcloud beta service-health impacts list \
--project=PROJECT_ID \
--location=global \
--filter="events:projects/PROJECT_ID/locations/global/events/EVENT_ID"
Wenn die Anfrage erfolgreich ist, enthält der Antworttext eine Liste von Impact-Objekten, die etwa so aussieht:
{
"impacts": [
{
"name": "projects/my-project/locations/global/impacts/f9a8b7c6-d5e4-4f3a-9b2c-1d0e9f8a7b6c",
"events": [
"projects/my-project/locations/global/events/1234567890abcdef"
],
"asset": {
"assetName": "//cloudsql.googleapis.com/projects/9876543210/instances/prod-orders-db",
"assetType": "sqladmin.googleapis.com/Instance"
},
"description": "Instance experienced elevated connection errors during regional network disruption.",
"createTime": "2026-10-08T14:12:05.120450Z",
"updateTime": "2026-10-08T14:12:05.120450Z"
}
]
}
Beispiele für gängige Filter für betroffene Ressourcen
Sie können den Suchparameter filter (oder --filter in der Google Cloud CLI) übergeben, um die zurückgegebenen Impact-Einträge einzugrenzen:
- Betroffene Ressourcen für ein bestimmtes Ereignis auflisten:
filter=events:projects/PROJECT_ID/locations/global/events/EVENT_ID - Betroffene Ressourcen eines bestimmten Ressourcentyps auflisten (z. B. Cloud SQL-Instanzen):
filter=asset.assetType="sqladmin.googleapis.com/Instance" - Betroffene Ressourcen auflisten, die nach einem bestimmten Zeitstempel aktualisiert wurden:
filter=updateTime>"2026-10-08T00:00:00Z"
Details zu einer betroffenen Ressource abrufen
Sie können einen bestimmten Impact-Eintrag anhand seiner IMPACT_ID abrufen.
REST API (v1beta)
Wenn Sie Details zu einem bestimmten betroffenen Ressourceneintrag abrufen möchten, senden Sie eine Anfrage mit dem folgenden Parameter:
| Parameter | Wert | Beschreibung |
|---|---|---|
name |
projects/PROJECT_ID/locations/global/impacts/IMPACT_ID |
Erforderlich. Vollständiger Ressourcenname des abzurufenden Impact-Eintrags. |
HTTP-Methode und URL:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts/IMPACT_ID
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts/IMPACT_ID"
gcloud
Führen Sie den folgenden Befehl aus, um Details zu einem betroffenen Ressourceneintrag abzurufen:
gcloud beta service-health impacts describe IMPACT_ID \
--project=PROJECT_ID \
--location=global
Wenn die Anfrage erfolgreich ist, enthält der Antworttext ein Impact-Objekt:
{
"name": "projects/my-project/locations/global/impacts/f9a8b7c6-d5e4-4f3a-9b2c-1d0e9f8a7b6c",
"events": [
"projects/my-project/locations/global/events/1234567890abcdef"
],
"asset": {
"assetName": "//cloudsql.googleapis.com/projects/9876543210/instances/prod-orders-db",
"assetType": "sqladmin.googleapis.com/Instance"
},
"description": "Instance experienced elevated connection errors during regional network disruption.",
"createTime": "2026-10-08T14:12:05.120450Z",
"updateTime": "2026-10-08T14:12:05.120450Z"
}
Nächste Schritte
Anleitungen zum Abrufen von Ereignisinformationen nach Projekt oder Organisation mithilfe der Service Health API.