Method: providers.tasks.search

已废弃：请改用 taskTrackingInfo.get。

HTTP 请求

GET https://fleetengine.googleapis.com/v1/{parent=providers/*}/tasks:search

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。必须采用 providers/{provider} 格式。提供方必须是 Google Cloud 项目 ID。例如 sample-cloud-project。

查询参数

参数
header

object (DeliveryRequestHeader)

可选。标准 Delivery API 请求标头。
trackingId

string

必需。正在请求的相关任务集的标识符。跟踪 ID 受到以下限制的约束：

  • 必须是有效的 Unicode 字符串。
  • 长度上限为 64 个字符。
  • 根据 Unicode 标准化形式 C 进行了标准化处理。
  • 不得包含以下任何 ASCII 字符：“/”“:”“?”“,”或“#”。
pageSize

integer

可选。要返回的最大任务数。服务返回的值可能小于此值。如果您未指定此值，则服务器会确定要返回的结果数。
pageToken

string

可选。从之前的 tasks.search 调用接收的页面令牌。您必须提供此值才能检索后续页面。

进行分页时，提供给 tasks.search 的所有其他参数必须与提供页面令牌的调用匹配。

请求正文

请求正文必须为空。

响应正文

tasks.search 响应。它包含符合 SearchTasksRequest 中搜索条件的一组任务。

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

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

object (Task)

所请求 trackingId 的 Tasks 集。成功的响应也可以为空。空响应表示没有任务与提供的 trackingId 相关联。
nextPageToken

string

在 SearchTasksRequest 中传递此令牌以继续列出结果。如果已返回所有结果，则此字段要么为空字符串，要么不会显示在响应中。