本文档介绍了如何使用 Service Health API 获取 Google Cloud事故的事故报告。
突发事件报告适用于符合以下条件的突发事件:
- 该问题具有全球影响,或正在影响一个或多个区域内大量客户项目。
- 有一个或多个商品不可用或严重降级。
准备工作
- 设置访问 Service Health API 的权限。
- 获取您要查看突发事件报告的突发事件的事件 ID。您可以获取已关闭的突发事件列表,并查找突发事件的 ID。
获取突发事件报告的 ID
如需获取突发事件的突发事件报告,请执行以下操作:
- 获取突发事件的详细信息。
在 JSON 响应中,查找以下行:
"artifact": "projects/PROJECT_ID/locations/global/artifacts/ARTIFACT_ID",
记下 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"
}
}
]
}
}
如需修正此错误,请设置所需的权限。