In diesem Dokument wird beschrieben, wie Sie den Bericht zu einem Vorfall Google Cloudmithilfe der Service Health API abrufen.
Vorfallberichte sind für Vorfälle verfügbar, die die folgenden Bedingungen erfüllen:
- Der Vorfall hat globale Auswirkungen oder betrifft einen erheblichen Prozentsatz der Kundenprojekte in einer oder mehreren Regionen.
- Mindestens eines Ihrer Produkte ist nicht verfügbar oder stark beeinträchtigt.
Hinweise
- Legen Sie Berechtigungen für den Zugriff auf die Service Health API fest.
- Rufen Sie die Ereignis-ID des Vorfalls ab, für den Sie einen Vorfallbericht prüfen möchten. Sie können eine Liste der geschlossenen Vorfälle abrufen und die ID des Vorfalls ermitteln.
ID für den Vorfallbericht abrufen
So rufen Sie den Vorfallbericht für einen Vorfall ab:
- Details zum Vorfall abrufen
Suchen Sie in der JSON-Antwort nach der folgenden Zeile:
"artifact": "projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID",
Notieren Sie sich die ARTIFACT_ID.
Inhalt des Vorfallberichts abrufen
Mit der Get API können Sie den Inhalt des Vorfallberichts abrufen.
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID ist Ihre Google Cloud-Projekt-ID.
- ARTIFACT_ID: die ID der Fehlermeldung.
HTTP-Methode und URL:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "name": "projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID", "content": { "markdown": "Content of the incident report.", }, "category": "ARTIFACT_CATEGORY_INCIDENT_REPORT", "createTime": "2022-10-18T18:00:05.690761Z", "updateTime": "2022-10-18T17:41:20.112287Z", }
Wenn Sie nicht die Berechtigungen zum Abrufen von Vorfallberichten haben, wird der folgende PERMISSION_DENIED
-Fehler angezeigt.
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.artifacts.get' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID' (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/artifacts/ARTIFACT_ID",
"permission": "servicehealth.artifacts.get"
}
}
]
}
}
Legen Sie die erforderlichen Berechtigungen fest, um den Fehler zu beheben.