REST Resource: cases

리소스: 케이스

케이스는 지원 케이스의 세부정보가 포함된 객체입니다. 생성된 시간, 우선순위, 분류 등에 대한 필드가 포함됩니다. 이후에 댓글과 첨부파일도 케이스에 추가될 수 있습니다.

케이스는 Google Cloud 조직 또는 프로젝트의 상위 요소입니다.

조직은 숫자로 식별되므로 조직의 상위 케이스 이름은 다음과 같이 표시됩니다.

organizations/123/cases/456

프로젝트에는 ID와 번호의 두 가지 고유 식별자가 있으며 그 형태는 다음과 같습니다.

projects/abc/cases/456
projects/123/cases/456

API를 호출할 때 둘 중 하나를 사용할 수 있습니다. 프로젝트 식별자에 대해 자세히 알아보려면 AIP-2510을 참조하세요.

JSON 표현
{
  "name": string,
  "displayName": string,
  "description": string,
  "classification": {
    object (CaseClassification)
  },
  "timeZone": string,
  "subscriberEmailAddresses": [
    string
  ],
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "creator": {
    object (Actor)
  },
  "contactEmail": string,
  "escalated": boolean,
  "testCase": boolean,
  "languageCode": string,
  "priority": enum (Priority)
}
필드
name

string

케이스의 리소스 이름입니다.

displayName

string

이 케이스에 보고된 문제에 관한 간단한 요약입니다.

description

string

문제에 관한 광범위한 설명입니다.

classification

object (CaseClassification)

이 케이스에 적용되는 문제 분류입니다.

timeZone

string

지원 케이스를 만든 사용자의 시간대입니다. IANA에서 인식하는 형식이어야 합니다(https://www.iana.org/time-zones). API를 통한 추가 유효성 검사는 없습니다.

subscriberEmailAddresses[]

string

이 케이스에 대한 업데이트를 받을 이메일 주소입니다.

state

enum (State)

출력 전용입니다. 지원 케이스의 현재 상태입니다.

createTime

string (Timestamp format)

출력 전용입니다. 이 케이스가 생성된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

updateTime

string (Timestamp format)

출력 전용입니다. 이 케이스가 마지막으로 업데이트된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"입니다.

creator

object (Actor)

케이스를 만든 사용자입니다.

참고: Google 지원팀에서 케이스를 만든 경우 이름과 이메일이 난독화됩니다.

contactEmail

string

케이스 업데이트 알림을 전송할 이메일 주소입니다(사용자가 제공). EUC로 사용자의 이메일 주소를 직접 추론할 수 없는 BYOID 흐름에서만 사용해야 합니다.

escalated

boolean

케이스가 현재 에스컬레이션되었는지 여부입니다.

testCase

boolean

이 케이스가 내부 API 테스트를 위해 생성되었으며 지원팀에서 조치를 취하지 않아야 하는지 여부입니다.

languageCode

string

사용자가 지원을 받을 때 사용하도록 요청한 언어입니다. BCP 47 언어 코드여야 합니다(예: "en", "zh-CN", "zh-TW", "ja", "ko"). 언어를 지정하지 않거나 지원되지 않는 언어를 지정하면 이 필드의 기본값은 영어(en)입니다.

케이스를 만드는 동안 언어를 선택하면 사용 가능한 지원 옵션에 영향을 미칠 수 있습니다. 지원되는 언어 목록과 지원팀 근무 시간은 https://cloud.google.com/support/docs/language-working-hours를 참조하세요.

priority

enum (Priority)

이 케이스의 우선순위입니다.

상태

지원 케이스의 상태입니다.

열거형
STATE_UNSPECIFIED 케이스가 알 수 없는 상태입니다.
NEW 케이스가 생성되었지만 아직 처리할 사람이 할당되지 않았습니다.
IN_PROGRESS_GOOGLE_SUPPORT 현재 Google 지원팀에서 케이스를 처리하고 있습니다.
ACTION_REQUIRED Google에서 응답을 기다리고 있습니다.
SOLUTION_PROVIDED 케이스 해결 방법이 제공되었지만 케이스가 아직 종료되지 않았습니다.
CLOSED 케이스가 해결되었습니다.

우선순위

케이스 우선순위입니다. P0이 가장 시급하고 P4의 우선순위가 가장 낮습니다.

열거형
PRIORITY_UNSPECIFIED 우선순위가 정의되지 않았거나 아직 설정되지 않았습니다.
P0 프로덕션 서비스에 극심한 수준의 영향을 미칩니다. 서비스가 하드 다운되었습니다.
P1 프로덕션 서비스에 중대한 영향을 미칩니다. 현재 서비스를 사용할 수 없습니다.
P2 프로덕션 서비스에 심각한 영향을 미칩니다. 서비스를 사용할 수 있지만 큰 장애가 있습니다.
P3 프로덕션 서비스에 중간 수준의 영향을 미칩니다. 서비스를 사용할 수 있지만 약간의 장애가 있습니다.
P4 일반적인 질문 또는 사소한 문제입니다. 프로덕션 서비스를 완전히 사용할 수 있습니다.

방법

close

케이스를 종료합니다.

create

새 케이스를 만들어 상위 요소와 연결합니다.

escalate

케이스를 에스컬레이션하고 Google Cloud 지원팀 에스컬레이션 관리 프로세스를 시작합니다.

get

케이스를 검색합니다.

list

상위 요소 아래의 모든 케이스를 검색하되, 하위 요소는 검색하지 않습니다.

patch

케이스를 업데이트합니다.
쿼리를 사용하여 케이스를 검색합니다.