跳转到主要内容
API Explorer|API Explorer
平台运维相关接口/平台综合
POSTPlatform起始版本 1.0同步需要认证

执行批量

执行批次操作多个资源类型。

调试可用性

在线调试

使用当前认证信息和示例参数提交 Mock 请求。

请求参数

请求体字段

  • requestObject必填

    请求。

    • resourceTypeString

      资源类型。

      示例： platform

    • actionString

      动作名称。

      示例： delete

    • itemsList

      条目列表。

      示例： (nested array)

      • idString

        资源ID。

        示例： item-001

      • paramsLinkedHashMap

        附加参数键值对。

        示例： (nested object)

    • dryRunBoolean

      是否仅模拟执行而不实际应用变更。

      示例： false

    • failFastBoolean

      快速失败。

      示例： false

响应状态

200 OK

该 API 成功时返回以下响应结构。

  • resourceTypeString

    资源类型。

    示例： platform

  • actionString

    动作名称。

    示例： delete

  • totalCountInteger

    总数量。

    示例： 10

  • successCountInteger

    成功数量。

    示例： 9

  • failureCountInteger

    失败数量。

    示例： 1

  • dryRunBoolean

    是否仅模拟执行而不实际应用变更。

    示例： false

  • resultsList

    结果列表。

    示例： (nested array)

    • idString

      资源ID。

      示例： item-001

    • successBoolean

      操作是否成功。true 表示成功，false 表示失败。

      示例： true

    • httpStatusInteger

      HTTP状态。

      示例： 200

    • errorString

      错误码。操作成功时为 null，失败时返回具体错误信息。

      示例： resource not found

    • dryRunEstimateString

      预估影响描述干运行模式。

      示例： Would delete 1 platform

  • processedAtString

    已处理时间。

    示例： 2026-01-15T08:00:00Z

请求地址

POST/api/v1/batch

/api/v1/batch

操作 ID

ExecuteBatch

永久链接

请求示例

curl -X POST '{host}/api/v1/batch' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"request":{"resourceType":"platform","action":"delete","items":"(nested array)","dryRun":false,"failFast":false}}'

响应示例

200
{
  "resourceType": "platform",
  "action": "delete",
  "totalCount": 10,
  "successCount": 9,
  "failureCount": 1,
  "dryRun": false,
  "results": [
    {}
  ],
  "processedAt": "example"
}

变更历史

此 API 暂无变更历史记录。

查看全部变更历史