Skip to main content
POST
重新运行 Scraper Studio 作业
从已有的 Bright Data Scraper Studio 作业启动新的运行。不发送请求体时,将从头重新运行整个作业;发送 failed_only: 1 时,仅重新运行失败的步骤。 请求成功后会启动一个新作业并返回其 collection_id。原作业保持不变。
只有数据尚未过期的作业才能重新运行。调用该端点前,请在列出 Scraper Studio 作业或 IDE 作业数据 API 中查看作业的 expired 时间戳。如果数据已过期,重新运行将失败,您必须使用原始输入触发新作业。Scraper Studio 保留批量采集结果 16 天,保留实时结果 7 天。请参见 Scraper Studio 规格说明。

重新运行行为

请求

不发送请求体即可重新运行全部内容:
添加 failed_only: 1 可仅重试失败的步骤:

响应

在 IDE 作业数据 API 和接收批量数据中,将返回的 collection_id 用作 job_id。它标识的是新的重新运行作业,而非原作业。

如何查找作业 ID

使用作业列表端点查找您要重新运行的作业 ID:
将返回的 id 值用作 job_id 路径参数。完整参数列表请参见列出 Scraper Studio 作业。

何时使用该端点

  • 修复选择器或解析器后,重试批量作业中失败的输入,无需重新采集已成功的输入
  • 按计划重新采集完整作业,以刷新会随时间变化的数据
  • 在目标网站发生故障并导致大量 blocked 或 detect_block 错误后重新运行

相关

授权

Authorization
string
header
必填

在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。

认证方法:

  1. 从 Bright Data 账户设置获取您的 API Key: https://brightdata.com/cp/setting/users
  2. 在请求的 Authorization 头中包含 API Key
  3. 格式: Authorization: Bearer YOUR_API_KEY

示例:

了解如何获取 Bright Data API Key: https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key?

路径参数

job_id
string
必填

要重新运行的作业 ID

请求体

application/json

省略请求体以重新运行整个作业。发送 failed_only: 1 仅重新运行失败的步骤。

failed_only
number

设置为 1 仅重新运行失败的步骤。省略则重新运行整个作业。

示例:

1

响应

重新运行作业已启动

collection_id
string

新的重新运行作业的 ID

start_eta
string<date-time>

重新运行作业的预计开始时间