文档首页/ 容器镜像服务 SWR/ API参考（基础版）/ API/ 镜像同步管理/ 获取镜像自动同步任务信息
更新时间：2025-08-05 GMT+08:00
在线调试
CLI示例
查看PDF
分享

获取镜像自动同步任务信息

功能介绍

创建镜像自动同步任务后，可以通过此接口查询该任务的状态，以判断是否同步成功。

接口约束

无

调用方法

请参见如何调用API。

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_job

表1 路径参数

参数

是否必选

参数类型

描述

namespace

是

String

组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。

repository

是

String

镜像仓库名称。小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，小数点、斜杠、下划线、中划线不能直接相连），小写字母或数字结尾，1-128个字符。如果您的镜像名称repository参数中有斜杠，请先替换成$再进行请求。
表2 Query参数

参数

是否必选

参数类型

描述

filter

是

String

应填写 limit::{limit}|offset::{offset}|order::{order} ,其中{limit}为返回条数,{offset}为起始索引,注意：offset和limit参数需要配套使用，且必选。{order}为排序类型（可选），可设置为desc（降序）、asc（升序）

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json

缺省值：application/json

X-Auth-Token

是

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码： 200

表4 响应Header参数

参数

参数类型

描述

Content-Range

String

offset(开始索引)-count(当前页记录条数)/total(总记录条数)
表5 响应Body参数

参数

参数类型

描述

[数组元素]

Array of SyncJob objects

查询成功
表6 SyncJob

参数

参数类型

描述

createdAt

String

创建时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00

domainID

String

租户ID

domainName

String

租户名

id

Integer

ID

namespace

String

组织名

override

Boolean

是否覆盖

remoteNamespace

String

目的组织

remoteRegionId

String

目的region

repoName

String

仓库名

status

String

同步状态,waiting、running、success、failed、timeout、cancel、existed

syncOperatorId

String

操作用户ID

syncOperatorName

String

操作用户名

tag

String

镜像版本

updatedAt

String

updatedAt

请求示例

GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/sync_job

响应示例

状态码： 200

查询成功

[ {
  "createdAt" : "2020-03-12T08:11:36.518144Z",
  "domainID" : "0657**************************f60",
  "domainName" : "h**********4",
  "id" : 1,
  "namespace" : "test",
  "override" : false,
  "remoteNamespace" : "remtens",
  "remoteRegionId" : "region1",
  "repoName" : "testrepo",
  "status" : "success",
  "syncOperatorId" : "065***********************10",
  "syncOperatorName" : "h**********4",
  "tag" : "8",
  "updatedAt" : "2020-03-12T08:11:41.505499Z"
} ]

状态码

状态码

描述

200

查询成功

400

错误的请求

401

鉴权失败

404

组织或镜像仓库或任务不存在

500

内部错误

错误码

请参见错误码。

父主题： 镜像同步管理

相关文档