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

功能介绍

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

接口约束

无

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
swr:repo:getSyncRepoJobInfo
Read
repo *
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
swr:repo:getSyncRepoJobInfo	Read	repo *	-	-	-

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"
} ]