手动同步镜像
功能介绍
对于镜像仓库已有的镜像,如果想在其他区域使用,需要手动触发镜像同步。
判断是否同步成功的方法如下:
- 响应状态码为200,无报错信息,表示同步成功。
- 通过SWR管理控制台或调用查询镜像仓库概要信息接口,在目标区域的目标组织下,若存在所同步的镜像版本表示同步成功。
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_images
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
namespace |
是 |
String |
组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。 |
repository |
是 |
String |
镜像仓库名称 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
Content-Type |
是 |
String |
消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json 缺省值:application/json |
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
imageTag |
是 |
Array of strings |
版本列表 |
override |
否 |
Boolean |
是否覆盖,默认为false |
remoteNamespace |
是 |
String |
目标组织 |
remoteRegionId |
是 |
String |
目标region ID。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
[数组元素] |
Array of strings |
成功 |
状态码: default
参数 |
参数类型 |
描述 |
---|---|---|
[数组元素] |
Array of strings |
失败的版本 |
请求示例
POST https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/sync_images { "imageTag" : [ "V1" ], "override" : true, "remoteNamespace" : "sdsad", "remoteRegionId" : "cn-north-208" }
响应示例
无
状态码
状态码 |
描述 |
---|---|
200 |
成功 |
400 |
错误的请求 |
401 |
鉴权失败 |
404 |
组织或镜像仓库不存在 |
500 |
内部错误 |
default |
失败的版本 |
错误码
请参见错误码。
