Method: cases.search

使用查询搜索支持请求。

示例:

c网址:

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

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().search(
    parent="projects/some-project", query="state=OPEN"
)
print(request.execute())

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

要在其中搜索案例的父资源的名称。

查询参数

参数
query

string

用于过滤案例的表达式。

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

  • organization:格式为 organizations/<organizationId> 的组织名称。
  • project:格式为 projects/<projectId> 的项目名称。
  • state:可以是 OPENCLOSED
  • priority:可以是 P0P1P2P3P4。您可以使用 OR 运算符为优先级指定多个值。例如 priority=P1 OR priority=P2
  • creator.email:支持请求创建者的电子邮件地址。

您必须指定 organizationproject

如需在 displayNamedescription 和注释中搜索,请使用不含关键字或运算符的全局限制。例如 "my search"

如需仅搜索在特定日期之后更新的案例,请使用 updateTime 并限定该特定日期、时间和时区(采用 ISO 日期时间格式)。例如 updateTime>"2020-01-01T00:00:00-05:00"updateTime 仅支持大于运算符 (>)。

示例:

  • organization="organizations/123456789"
  • project="projects/my-project-id"
  • project="projects/123456789"
  • organization="organizations/123456789" AND state=CLOSED
  • project="projects/my-project-id" AND creator.email="tester@example.com"
  • project="projects/my-project-id" AND (priority=P0 OR priority=P1)
pageSize

integer

随每个请求提取的最大案例数。默认页面大小为 10。

pageToken

string

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

请求正文

请求正文必须为空。

响应正文

case.search 端点的响应消息。

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

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

object (Case)

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

nextPageToken

string

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

授权范围

需要以下 OAuth 范围之一:

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

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