Method: cases.list

检索父项下的所有案例，但不检索其子项。

例如，列出某个组织下的案例只会返回由该组织直接上级的案例。如需检索组织及其项目下的案例，请使用 cases.search。

示例：

c网址：

parent="projects/some-project"
curl \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://cloudsupport.googleapis.com/v2/$parent/cases"

Python:

import googleapiclient.discovery

apiVersion = "v2"
supportApiService = googleapiclient.discovery.build(
    serviceName="cloudsupport",
    version=apiVersion,
    discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={apiVersion}",
)

request =
  supportApiService.cases().list(parent="projects/some-project")
print(request.execute())

HTTP 请求

GET https://cloudsupport.googleapis.com/v2/{parent=*/*}/cases

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要在其下列出支持请求的父级的名称。

查询参数

参数
filter

string

用于过滤案例的表达式。

如果它是空字符串，则不会进行任何过滤。否则，端点会返回与过滤器匹配的案例。

表达式使用以下字段，以 AND 分隔并通过 = 指定：

  • state：可以是 OPEN 或 CLOSED。
  • priority：可以是 P0、P1、P2、P3 或 P4。您可以使用 OR 运算符为优先级指定多个值。例如 priority=P1 OR priority=P2。
  • creator.email：支持请求创建者的电子邮件地址。

示例：

  • state=CLOSED
  • state=OPEN AND creator.email="tester@example.com"
  • state=OPEN AND (priority=P0 OR priority=P1)
pageSize

integer

随每个请求提取的最大案例数。默认值为 10。
pageToken

string

标识要返回的结果页面的令牌。如果未指定，则检索第一个页面。

请求正文

请求正文必须为空。

响应正文

case.list 端点的响应消息。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
字段
cases[]

object (Case)

应用所有过滤器后，与父级相关联的支持请求列表。
nextPageToken

string

用于检索下一页结果的令牌。在后续 cases.list 请求的 pageToken 字段中设置此字段。如果未指定，则无需再检索更多结果。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/cloudsupport
  • https://www.googleapis.com/auth/cloud-platform

如需了解详情，请参阅身份验证概览。