1. 镜像预热任务(申请开通)
共绩科技
  • 共绩算力 Open API
    • 资源
      • 获取设备资源列表
      • 获取对象存储加速资源列表
      • 获取共享存储卷资源列表
    • 弹性部署服务任务
      • 任务列表查询接口
      • 任务详情查询接口
      • 任务创建接口
      • 任务修改接口
      • 任务恢复接口
      • 任务暂停接口
      • 任务删除接口
      • 节点数量修改接口
      • 新版任务列表查询接口
      • 新版任务详情查询接口
      • 新版任务创建接口
      • 新版任务修改接口
    • 镜像预热任务(申请开通)
      • 镜像预热任务可用集群列表
        GET
      • 镜像预热任务列表查询接口
        GET
      • 镜像预热任务详情查询接口
        GET
      • 镜像预热任务创建接口
        POST
      • 镜像预热任务更新接口
        POST
      • 镜像预热任务停止接口
        POST
    • Job批处理任务
      • Job任务列表查询接口
      • Job任务详情查询接口
      • Job任务创建接口
      • Job任务停止接口
    • Job批处理任务队列
      • Job任务队列列表查询接口
      • Job任务队列详情查询接口
      • Job任务队列创建接口
      • Job任务队列更新接口
      • Job任务队列停止接口
      • Job任务队列任务组推送接口
      • Job任务队列任务组列表查询接口
      • Job任务队列任务组详情查询接口
      • Job任务队列任务组批量停止接口
    • 弹性部署服务/Job批处理节点
      • 节点列表查询接口
      • 节点日志查询接口
      • 节点事件查询接口
      • 任务节点删除接口
    • 费用
      • 弹性部署/云主机-时间维度计费查询接口
      • 弹性部署/云主机-任务维度计费查询接口
      • 镜像仓库-计费查询接口
      • 对象存储加速-计费查询接口
      • 共享存储卷-计费查询接口
    • 存储
      • 对象存储
        • 查询对象存储可选元数据区域
        • 查询对象存储加速可选区域
        • 查询对象存储列表
        • 按 ID 查询对象存储
        • 查询对象存储容量用量概览
        • 校验对象存储连接
        • 创建对象存储配置
        • 更新对象存储配置
        • 浏览对象存储桶目录
        • 预热导入对象存储数据
        • 浏览对象存储已导入元数据
        • 删除对象存储已导入元数据
        • 激活对象存储
        • 释放对象存储
        • 删除对象存储配置
    • 裸金属
      • 已购列表
        • 已购单机设备列表
        • 已购组网设备列表
        • 设备详情【开机信息】
      • 创建订单
        • 创建订单
        • 已购设备自动续费
        • 已购设备取消自动续费
      • 可购列表
        • 单机设备可购列表
        • 组网设备可购列表
      • 订单列表
        • 订单列表
  1. 镜像预热任务(申请开通)

镜像预热任务创建接口

POST
/api/task/image_preheat/create
当前版本旧版本是否需要加密是否需要加签
v1.0.0-否是

描述#

镜像预热任务#

功能描述#

镜像预热任务用于提前将服务镜像缓存到指定的集群区域或资源节点，以减少后续任务启动时拉取镜像所需的时间。
创建镜像预热任务时支持以下两种预热类型：
仅集群预热：将镜像预热到所选区域的集群级镜像缓存中。该模式按区域执行，不指定具体资源规格、节点数量和调度策略。
节点预热：根据指定的资源规格和节点数量创建预热任务，将镜像预热到对应的资源节点。该模式支持配置跨区调度策略。
接口没有单独的预热类型字段，而是根据 regions 和 resources 判断预热类型。两个字段必须二选一，不能同时传入，也不能同时为空。

创建接口#

POST /api/task/image_preheat/create
加密创建接口：
POST /api/task/image_preheat/encrypt/create
加密接口解密后的业务字段及校验规则与普通创建接口一致。

字段要求#

字段类型仅集群预热节点预热说明
task_namestring必填必填任务名称，不能为空。
resourcesResourceMark[] | null必须为 null 或不传必填节点预热资源列表，至少包含一项。
regionsImagePreheatRegionDto[] | null必填必须为 null 或不传集群预热区域列表，至少包含一个有效区域。
scheduler_strategyTaskSchedulerStrategy | null必须为 null 或不传可选节点预热的调度策略。
pointsinteger | null必须为 null 或不传必填节点数量，必须大于等于 1。
servicesImagePreheatServiceDto[]必填必填待预热的服务镜像列表，至少包含一项。
节点预热：resources[].mark 需通过资源列表接口 GET /api/deployment/resource/search?task_type=ImagePreHeat 获取，不能自行构造；同时必须传 points。
仅集群预热：regions 需通过区域列表接口 GET /api/task/image_preheat/get_regions 获取；无需传 resources、scheduler_strategy 和 points。
加签详见：加签流程

请求参数

Header 参数

Body 参数application/json必填

示例
{
    "task_name": "镜像预热任务",
    "scheduler_strategy": {
        "mode": "Unrestricted"
    },
    "points": 2,
    "services": [
        {
            "service_name": "d1779468791353-35628",
            "service_image": "harbor.sxxxe.cn/public-hub/dailyhot:1.0",
            "repository_account": null,
            "is_update_repository": null
        }
    ],
    "create_time": null,
    "resources": [
        {
            "mark": "J19Cg02JMM7pVim3XPCik/U6sbaBl/dYKodWFvzjPWWGJInsPwDdSxdy9/JlWA4GfzNWzeJB/tuGhCNTWLu4QY8g8FizMIgdNVGZh8Tp8XOEbxyOnOH7pHbI7WIUdbCUx1Wo8rderOCHwBwAq/QkIQAAU7hOXN4TgAK1tggieTos7TE9on7i2i"
        },
        {
            "mark": "J19Cg02JMM7pVim3XPCik/U6vLaBl/dYKodWFvzjPWWGJInsPwDdSxdy9/JlWA4GfzNWzeJB/tuGiSNTWLu4QY8g8FizMIg3a51r+dNVGZh8Tp8XOEbxyOrKGLhZHlg4Esc7duvMDmQPgRm6aH4cHRIt1f3G6zhb1SUj+0tzZr/5UPLBduBg"
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://openapi.suanli.cn/api/task/image_preheat/create' \
--header 'token;' \
--header 'timestamp: {{$date.millisecondsTimestamp}}' \
--header 'version: 1.0.0' \
--header 'sign_str;' \
--header 'Content-Type: application/json' \
--data '{
    "task_name": "镜像预热任务",
    "scheduler_strategy": {
        "mode": "Unrestricted"
    },
    "points": 2,
    "services": [
        {
            "service_name": "d1779468791353-35628",
            "service_image": "harbor.sxxxe.cn/public-hub/dailyhot:1.0",
            "repository_account": null,
            "is_update_repository": null
        }
    ],
    "create_time": null,
    "resources": [
        {
            "mark": "J19Cg02JMM7pVim3XPCik/U6sbaBl/dYKodWFvzjPWWGJInsPwDdSxdy9/JlWA4GfzNWzeJB/tuGhCNTWLu4QY8g8FizMIgdNVGZh8Tp8XOEbxyOnOH7pHbI7WIUdbCUx1Wo8rderOCHwBwAq/QkIQAAU7hOXN4TgAK1tggieTos7TE9on7i2i"
        },
        {
            "mark": "J19Cg02JMM7pVim3XPCik/U6vLaBl/dYKodWFvzjPWWGJInsPwDdSxdy9/JlWA4GfzNWzeJB/tuGiSNTWLu4QY8g8FizMIg3a51r+dNVGZh8Tp8XOEbxyOrKGLhZHlg4Esc7duvMDmQPgRm6aH4cHRIt1f3G6zhb1SUj+0tzZr/5UPLBduBg"
        }
    ]
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": "0000",
    "message": "success",
    "data": {
        "task_id": 38116
    }
}
上一页
镜像预热任务详情查询接口
下一页
镜像预热任务更新接口
Built with