이 문서에서는 맞춤 서비스 상태에 중단이 발생한 경우 취해야 할 조치를 설명합니다.
Personalized Service Health는 이슈의 영향을 부분적으로 또는 완전히 받을 수 있습니다. Status API 리소스와 Service Health 대시보드를 통해 Service Health의 이슈, 처리 문제, 성능 문제를 확인할 수 있습니다. Google Cloud
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에 액세스할 수 있는 권한을 설정합니다.
Status API를 사용하도록 프로젝트 또는 조직에서 Identity and Access Management (IAM) 권한을 구성합니다.
프로젝트의 권한을 구성하려면 다음 명령어를 실행합니다.
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.viewerORGANIZATION_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 Service Health는 Personalized Service Health에 문제가 있는지 알려줍니다. RSS 피드를 사용하여 데이터를 소비할 수도 있습니다.
Google Cloud 서비스 상태에 관한 자세한 내용은 이슈 및 Google Cloud 서비스 상태를 참고하세요.