프로젝트의 활동 관리

이 문서에서는 Service Health API를 사용하여 단일 프로젝트에 영향을 미치는 이벤트를 관리하는 방법을 설명합니다.

시작하기 전에

Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

  1. 이벤트를 관리하려는 프로젝트에 Service Health API를 사용 설정합니다.
  2. 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"
}