Vorfallberichte abrufen

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

ID für den Vorfallbericht abrufen

So rufen Sie den Vorfallbericht für einen Vorfall ab:

  1. Details zum Vorfall abrufen
  2. Suchen Sie in der JSON-Antwort nach der folgenden Zeile:

    "artifact": "projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID",
    
  3. 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.