本文档介绍了在 Personalized Service Health 出现中断时应采取的措施。
Personalized Service Health 可能会部分或完全受到突发事件的影响。您可以通过 Status API 资源和 Google CloudService Health 信息中心查看 Service Health 的突发事件、处理问题和性能问题。
使用 Status API
Service Health API 的 Status API 资源可告知您特定 Service Health 功能是否存在问题。
准备工作
如需开始使用 Status API,请执行以下操作:
- 为您将用于访问此状态的项目或组织启用 Service Health API。
-
Make sure that billing is enabled for your Google Cloud project.
- 设置访问 Service Health API 的权限。
在您的项目或组织中配置 Identity and Access Management (IAM) 权限,以使用 Status API。
如需为项目配置权限,请运行以下命令:
gcloud projects add-iam-policy-binding PROJECT_ID \ --member {USER|GROUP|SERVICE_ACCOUNT} \ --role roles/servicehealth.viewer
如需为组织配置权限,请运行以下命令:
gcloud organizations add-iam-policy-binding ORGANIZATION_ID \ --member {USER|GROUP|SERVICE_ACCOUNT} \ --role roles/servicehealth.viewer
如需获取 ORGANIZATION_ID,请参阅获取组织资源 ID。
组织中所有项目都会继承为该组织授予的 IAM 政策。借助这些政策,您可以访问整个组织中的组织和项目事件 API。
参考
如需了解您可以使用的方法以及响应中字段的含义,请参阅 Status API 参考文档。
设置产品或位置时,请使用Google Cloud 产品和位置中列出的值。
使用项目 ID 获取服务运行状况
如需使用项目 ID 获取服务运行状况的状态,请使用以下请求:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/status
如果状态值为 OK
,则请求会产生以下响应:
{
"state": "OK",
}
此状态表示使用项目 ID 访问的功能(例如事件或影响)在内部没有出现问题。
如果状态值为 ISSUES_DETECTED
,请求会产生以下响应:
{
"state": "ISSUES_DETECTED",
"issues": [
{
"message": "We are experiencing problems creating new events",
"details": {
"API": "events"
}
},
{
"message": "We are experiencing problems creating new impacts",
"details": {
"API": "impacts"
}
}
]
}
ISSUES_DETECTED
状态还会返回一组问题,表明使用项目 ID 访问的功能可能不准确。
如果您没有获取状态的权限,则会收到 PERMISSION_DENIED
错误。
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.statuses.get' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global/status' (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/status",
"permission": "servicehealth.statuses.get"
}
}
]
}
}
使用组织 ID 获取服务运行状况
如需获取状态,请使用以下请求:
GET https://servicehealth.googleapis.com/v1beta/organizations/ORGANIZATION_ID/locations/global/status
如果服务运行状况正常,状态应会返回以下响应:
{
"state": "OK",
}
如果服务运行状况存在可能会影响其准确性或功能的问题,则状态应生成状态为 ISSUES_DETECTED
的响应:
{
"state": "ISSUES_DETECTED",
"issues": [
{
"message": "We are experiencing problems creating new organization level events",
"details": {
"API": "organizationEvents"
}
},
{
"message": "We are experiencing problems creating new organization level impacts",
"details": {
"API": "organizationImpacts"
}
}
]
}
如果您没有获取状态的权限,则会收到 PERMISSION_DENIED
错误。
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.statuses.get denied on resource '//servicehealth.googleapis.com/organizations/ORGANIZATION_ID/locations/global/status' (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/status",
"permission": "servicehealth.statuses.get"
}
}
]
}
}
查看 Google Cloud 服务健康状况
Google Cloud 服务运行状况会告知您 Personalized Service Health 是否存在问题。您还可以使用 RSS Feed 来使用这些数据。
如需详细了解 Google Cloud 服务运行状况,请参阅突发事件和 Google Cloud 服务运行状况。