REST Resource: cases

资源：Case

支持请求是包含支持请求详细信息的对象。它包含有关创建时间、优先级、分类等的字段。支持请求中还可以包含评论和附件，这些信息会随时间而增加。

支持请求以 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)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
updateTime

string (Timestamp format)

仅限输出。此支持请求的上次更新时间。

采用 RFC3339 世界协调时间 (UTC)（即“祖鲁时”）格式的时间戳，采用纳秒级精度，最多包含九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
creator

object (Actor)

创建支持请求的用户。

注意：如果支持请求是由 Google 支持团队创建的，则名称和电子邮件地址会进行混淆处理。
contactEmail

string

用户提供的电子邮件地址，用于发送案例更新通知。这只应在 BYOID 流程中使用，在这种情况下，我们无法直接从用户的 EUC 中推断出其电子邮件地址。
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

 更新支持请求。
使用查询搜索支持请求。