이 문서에서는 Service Health API를 사용하여 단일 프로젝트에 영향을 미치는 이벤트를 관리하는 방법을 설명합니다.
시작하기 전에
Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.
- 이벤트를 관리하려는 프로젝트에 Service Health API를 사용 설정합니다.
- Service Health API에 액세스할 수 있는 권한을 설정합니다.
참조
사용할 수 있는 메서드와 응답의 필드 의미는 Events API 참조(v1, v1beta)를 확인하세요.
API 응답에서 impact 목록의 각 항목에는 영향을 받는 각 제품 및 위치에 대한 세부적인 중단 state(AFFECTED 또는 RESOLVED), startTime, endTime(해결된 경우)가 포함됩니다.
제품 또는 위치를 설정할 때 Google Cloud 제품 및 위치에서 찾은 값을 사용합니다.
프로젝트의 모든 활성 이슈 나열
빠른 시작을 참고하세요.
사고 세부정보 가져오기
Get API를 사용하여 이벤트에 대한 세부정보를 볼 수 있습니다.
요청 데이터를 사용하기 전에 다음을 바꿉니다.
- API_VERSION: 사용할 API 버전입니다.
v1또는v1beta을 사용합니다. - PROJECT_ID: Google Cloud 프로젝트 ID입니다.
- EVENT_ID: 이벤트 ID입니다.
HTTP 메서드 및 URL:
GET https://servicehealth.googleapis.com/API VERSION/projects/PROJECT_ID/locations/global/events/EVENT_ID
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{
"name": "projects/PROJECT_ID/locations/global/events/EVENT_ID",
"title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
"description": "The issue with Google Cloud SQL has been resolved for all affected projects as of Tuesday, 2022-10-18 11:00 US/Pacific. We thank you for your patience while we worked on resolving the issue.",
"category": "INCIDENT",
"detailedCategory": "CONFIRMED_INCIDENT",
"state": "CLOSED",
"detailedState": "RESOLVED",
"artifacts": [
{
"artifact": "projects/PROJECT_ID/locations/global/artifacts/artifact_id",
"artifactCategory": "ARTIFACT_CATEGORY_INCIDENT_REPORT",
}
],
"eventImpacts": [
{
"product": {
"productName": "Google Cloud SQL",
"id": "hV87iK5DcEXKgWU2kDri",
},
"location": {
"locationName": "us-central1",
}
}
],
"relevance": "RELATED",
"updates": [
{
"updateTime": "2022-10-18T17:41:20.112287Z",
"title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
"description": "We are experiencing an intermittent issue with Google Cloud SQL. Our engineering team continues to investigate the issue.",
"symptom": "None at this time.",
"workaround": "None at this time."
},
{
"updateTime": "2022-10-18T18:00:05.690761Z",
"title": "We are experiencing a connectivity issue affecting Google Cloud SQL in us-east1, australia-southeast2.",
"description": "The issue with Google Cloud SQL has been resolved for all affected projects as of Tuesday, 2022-10-18 11:00 US/Pacific.\n\nWe thank you for your patience while we worked on resolving the issue.",
"symptom": "None at this time.",
"workaround": "None at this time."
}
],
"updateTime": "2022-10-18T18:00:05.690761Z",
"startTime": "2022-10-18T17:41:20.112287Z",
"endTime": "2022-10-18T18:00:05.690761Z",
}
이벤트를 가져올 권한이 없으면 다음 PERMISSION_DENIED 오류가 발생합니다.
{
"error": {
"code": 403,
"message": "Permission 'servicehealth.events.get' denied on resource '//servicehealth.googleapis.com/projects/PROJECT_ID/locations/global/events/EVENT_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/events/EVENT_ID",
"permission": "servicehealth.events.get"
}
}
]
}
}
오류를 해결하려면 필수 권한을 설정하세요.
프로젝트의 영향을 받는 리소스 나열
지원되는 Google Cloud 제품의 경우 Personalized Service Health 이벤트의 영향을 받는 프로젝트의 특정 Google Cloud 리소스를 나열할 수 있습니다.
영향을 받는 리소스를 나열하려면 이벤트가 시작되기 최소 24시간 전에 프로젝트에서 Service Health API(servicehealth.googleapis.com)를 사용 설정해야 하며 주 구성원에게 servicehealth.impacts.list 권한(roles/servicehealth.viewer에 포함)이 있어야 합니다.
REST API (v1beta)
프로젝트에서 영향을 받는 리소스를 나열하려면 다음 매개변수를 사용하여 Service Health API에 요청을 보냅니다.
| 매개변수 | 값 | 설명 |
|---|---|---|
parent |
projects/PROJECT_ID/locations/global |
필수 항목입니다. 영향을 받는 리소스를 나열할 프로젝트 ID 또는 프로젝트 번호입니다. |
pageSize |
1~100 | 선택사항입니다. 페이지당 반환할 최대 영향 수입니다. 지정하지 않으면 기본값은 10입니다. |
pageToken |
문자열 | 선택사항입니다. 결과의 다음 페이지를 검색하기 위한 이전 ListImpactsResponse의 토큰입니다. |
filter |
문자열 | 선택사항입니다. 반환된 영향의 범위를 지정하는 필터 표현식입니다. 예를 들어 특정 이벤트의 영향을 받는 리소스를 나열하려면 filter=events:projects/PROJECT_ID/locations/global/events/EVENT_ID을 설정합니다. |
요청 데이터를 사용하기 전에 다음을 바꿉니다.
PROJECT_ID: Google Cloud 프로젝트 ID 또는 프로젝트 번호입니다.
HTTP 메서드 및 URL:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts
curl을 사용하려면 GET 엔드포인트를 직접 호출합니다.
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts"
gcloud
다음 명령어를 실행하여 프로젝트에서 영향을 받는 리소스를 나열합니다.
gcloud beta service-health impacts list \
--project=PROJECT_ID \
--location=global
특정 이벤트의 영향을 받는 리소스만 나열하려면 --filter 플래그를 전달합니다.
gcloud beta service-health impacts list \
--project=PROJECT_ID \
--location=global \
--filter="events:projects/PROJECT_ID/locations/global/events/EVENT_ID"
요청이 성공하면 응답 본문에 다음과 유사한 Impact 객체 목록이 포함됩니다.
{
"impacts": [
{
"name": "projects/my-project/locations/global/impacts/f9a8b7c6-d5e4-4f3a-9b2c-1d0e9f8a7b6c",
"events": [
"projects/my-project/locations/global/events/1234567890abcdef"
],
"asset": {
"assetName": "//cloudsql.googleapis.com/projects/9876543210/instances/prod-orders-db",
"assetType": "sqladmin.googleapis.com/Instance"
},
"description": "Instance experienced elevated connection errors during regional network disruption.",
"createTime": "2026-10-08T14:12:05.120450Z",
"updateTime": "2026-10-08T14:12:05.120450Z"
}
]
}
영향을 받는 리소스의 일반적인 필터 예시
filter 쿼리 매개변수(또는 Google Cloud CLI의 --filter)를 전달하여 반환된 Impact 레코드를 좁힐 수 있습니다.
- 특정 이벤트의 영향을 받는 리소스 나열:
filter=events:projects/PROJECT_ID/locations/global/events/EVENT_ID - 특정 리소스 유형의 영향을 받는 리소스 나열(예: Cloud SQL 인스턴스):
filter=asset.assetType="sqladmin.googleapis.com/Instance" - 특정 타임스탬프 이후에 업데이트된 영향을 받는 리소스 나열:
filter=updateTime>"2026-10-08T00:00:00Z"
영향을 받는 리소스에 대한 세부정보 가져오기
IMPACT_ID를 사용하여 특정 Impact 레코드를 가져올 수 있습니다.
REST API (v1beta)
영향을 받는 특정 리소스 레코드에 대한 세부정보를 가져오려면 다음 매개변수를 사용하여 요청을 전송합니다.
| 매개변수 | 값 | 설명 |
|---|---|---|
name |
projects/PROJECT_ID/locations/global/impacts/IMPACT_ID |
필수 항목입니다. 검색할 Impact 레코드의 전체 리소스 이름입니다. |
HTTP 메서드 및 URL:
GET https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts/IMPACT_ID
curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ "https://servicehealth.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/impacts/IMPACT_ID"
gcloud
다음 명령어를 실행하여 영향을 받은 리소스 레코드에 대한 세부정보를 가져옵니다.
gcloud beta service-health impacts describe IMPACT_ID \
--project=PROJECT_ID \
--location=global
요청이 성공하면 응답 본문에 Impact 객체가 포함됩니다.
{
"name": "projects/my-project/locations/global/impacts/f9a8b7c6-d5e4-4f3a-9b2c-1d0e9f8a7b6c",
"events": [
"projects/my-project/locations/global/events/1234567890abcdef"
],
"asset": {
"assetName": "//cloudsql.googleapis.com/projects/9876543210/instances/prod-orders-db",
"assetType": "sqladmin.googleapis.com/Instance"
},
"description": "Instance experienced elevated connection errors during regional network disruption.",
"createTime": "2026-10-08T14:12:05.120450Z",
"updateTime": "2026-10-08T14:12:05.120450Z"
}