获取突发事件报告

本文档介绍了如何使用 Service Health API 获取 Google Cloud事故的事故报告。

突发事件报告适用于符合以下条件的突发事件:

  • 该问题具有全球影响,或正在影响一个或多个区域内大量客户项目。
  • 有一个或多个商品不可用或严重降级。

准备工作

获取突发事件报告的 ID

如需获取突发事件的突发事件报告,请执行以下操作:

  1. 获取突发事件的详细信息
  2. 在 JSON 响应中,查找以下行:

    "artifact": "projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID",
    
  3. 记下 ARTIFACT_ID

获取突发事件报告的内容

您可以使用 Get API 获取突发事件报告的内容。

在使用任何请求数据之前,请先进行以下替换:

  • PROJECT_ID:您的 Google Cloud 项目 ID。
  • ARTIFACT_ID:突发事件报告的 ID。

HTTP 方法和网址:

GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID

如需发送您的请求,请展开以下选项之一:

您应该收到类似以下内容的 JSON 响应:

{
  "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",
}

如果您没有获取突发事件报告的权限,则会收到以下 PERMISSION_DENIED 错误。

{
  "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"
        }
      }
    ]
  }
}

如需修正此错误,请设置所需的权限