华为云用户手册

响应示例 状态码： 200 查询成功 [ { "createdAt" : "2020-04-17T02:11:03.53183Z", "domainID" : "8b1e81************************633fb", "domainName" : "p*********59", "id" : 45, "namespace" : "test", "override" : true, "remoteNamespace" : "sdsad", "remoteRegionId" : "cn-north-1", "repoName" : "grpc-helloworld", "syncAuto" : true, "updatedAt" : "2020-04-17T02:11:03.531831Z" } ]

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

错误码说明 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 描述 401 SV CS TG.SWR.4010000 鉴权失败，可能因为Token过期，请重新 获取Token 后重试。 500 SVCSTG.SWR.5000001 服务器内部错误：获取应用描述失败。 500 SVCSTG.SWR.5000002 服务器内部错误：获取镜像信息失败。 500 SVCSTG.SWR.5000003 服务器内部错误：获取镜像列表失败。 404 SVCSTG.SWR.4040004 软件包不存在。 500 SVCSTG.SWR.5000005 服务器内部错误：删除失败。 409 SVCSTG.SWR.4090006 镜像已存在。 500 SVCSTG.SWR.5000007 服务器内部错误：获取失败。 500 SVCSTG.SWR.5000008 服务器内部错误：获取列表失败。 404 SVCSTG.SWR.4040009 镜像列表未找到。 404 SVCSTG.SWR.4040010 镜像不存在。 500 SVCSTG.SWR.5000011 服务器内部错误：更新失败。 406 SVCSTG.SWR.4060074 组织不能被删除，还含有镜像。 400 SVCSTG.SWR.4000013 无效的摘要。 400 SVCSTG.SWR.4000014 无效的参数。 400 SVCSTG.SWR.4000015 无效的文件包名称。 400 SVCSTG.SWR.4000016 无效的版本号。 500 SVCSTG.SWR.5000017 服务器内部错误：应用签名功能未开启。 500 SVCSTG.SWR.5000018 服务器内部错误：读取公共密钥失败。 500 SVCSTG.SWR.5000019 服务器内部错误：不能找到本地已储存文件。 500 SVCSTG.SWR.5000020 服务器内部错误：会话锁获取失败。 500 SVCSTG.SWR.5000021 服务器内部错误：同步文件失败。 500 SVCSTG.SWR.5000022 服务器内部错误：同步元文件失败。 406 SVCSTG.SWR.4060012 镜像仓库不能被删除，还含有镜像。 409 SVCSTG.SWR.4090023 系统资源繁忙。 500 SVCSTG.SWR.5000024 服务器内部错误：无法生成sha值。 413 SVCSTG.SWR.4130025 上传的文件太大。 500 SVCSTG.SWR.5000027 服务器内部错误：无法解开打包文件。 400 SVCSTG.SWR.4000028 错误的镜像格式。 400 SVCSTG.SWR.4000029 错误的镜像格式：镜像名不一致。 500 SVCSTG.SWR.5000030 服务器内部错误：无法定位文件指针。 400 SVCSTG.SWR.4000031 无效的ak、sk。 500 SVCSTG.SWR.5000032 服务器内部错误：json转换失败。 500 SVCSTG.SWR.5000033 服务器内部错误：应用文件保存失败。 500 SVCSTG.SWR.5000034 服务器内部错误：应用删除失败。 500 SVCSTG.SWR.5000035 服务器内部错误：应用保存到数据库失败。 500 SVCSTG.SWR.5000036 服务器内部错误：更新应用数据库失败。 500 SVCSTG.SWR.5000037 服务器内部错误：创建签名失败。 500 SVCSTG.SWR.5000038 服务器内部错误：删除签名失败。 400 SVCSTG.SWR.4000039 无效的sessionID。 500 SVCSTG.SWR.5000040 无法更新状态。 500 SVCSTG.SWR.5000041 服务器内部错误：读取session失败。 500 SVCSTG.SWR.5000042 服务器内部错误：回收session失败。 404 SVCSTG.SWR.4040043 session不存在。 500 SVCSTG.SWR.5000044 服务器内部错误：生成session失败。 400 SVCSTG.SWR.4000045 服务器内部错误：绑定session失败。 500 SVCSTG.SWR.5000046 服务器内部错误：创建失败。 400 SVCSTG.SWR.4000047 此版本不支持。 404 SVCSTG.SWR.4040048 镜像版本不存在。 500 SVCSTG.SWR.5000049 服务器内部错误：镜像删除失败。 500 SVCSTG.SWR.5000050 服务器内部错误：摘要生成失败。 500 SVCSTG.SWR.5000051 服务器内部错误：无法获取文件sha列表。 500 SVCSTG.SWR.5000052 服务器内部错误：无法减少镜像引用。 406 SVCSTG.SWR.4060053 无法删除，请先删除软件包。 500 SVCSTG.SWR.5000054 服务器内部错误：保存失败。 400 SVCSTG.SWR.4000055 缺少搜索输入。 400 SVCSTG.SWR.4000056 页面大小信息无效。 500 SVCSTG.SWR.5000057 服务器内部错误：获取组织失败。 404 SVCSTG.SWR.4040058 组织不存在。 500 SVCSTG.SWR.5000059 服务器内部错误：创建组织失败。 409 SVCSTG.SWR.4090060 组织已存在。 500 SVCSTG.SWR.5000061 获取软件实例IP失败。 500 SVCSTG.SWR.5000062 获取软件本地IP失败。 500 SVCSTG.SWR.5000063 获取tag表失败。 400 SVCSTG.SWR.4000064 无效的镜像，镜像描述文件中含有空的“RepoTags”信息。 400 SVCSTG.SWR.4000065 无效的镜像，镜像描述文件里的层文件缺失。 400 SVCSTG.SWR.4000066 无效的镜像，镜像描述文件里的配置文件缺失。 400 SVCSTG.SWR.4000067 您上传的镜像包格式不正确，镜像包中缺少描述文件。 400 SVCSTG.SWR.4000068 无效的镜像，镜像描述文件无法解析。 400 SVCSTG.SWR.4000069 无效的镜像，镜像格式错误或不支持。 507 SVCSTG.SWR.5070070 您的OBS服务未启用或有错误，请先检查您的OBS服务。 500 SVCSTG.SWR.5000071 服务器内部错误：无法获取用户列表。 500 SVCSTG.SWR.5000073 服务器内部错误：恢复失败。 500 SVCSTG.SWR.5000075 服务器内部错误：无法更新组织。 409 SVCSTG.SWR.4090076 组织的权限已存在。 500 SVCSTG.SWR.5000077 服务器内部错误：获取组织权限失败。 404 SVCSTG.SWR.4040078 组织权限不存在。 500 SVCSTG.SWR.5000079 服务器内部错误：更新组织权限失败。 500 SVCSTG.SWR.5000080 服务器内部错误：创建组织权限失败。 500 SVCSTG.SWR.5000081 服务器内部错误：删除组织权限失败。 500 SVCSTG.SWR.5000082 服务器内部错误：解析json文件失败。 404 SVCSTG.SWR.4040083 没有找到请求url。 500 SVCSTG.SWR.5000084 服务器内部错误：获取服务失败。 500 SVCSTG.SWR.5000085 服务器内部错误：创建tag失败。 500 SVCSTG.SWR.5000086 服务器内部错误：更新tag失败。 500 SVCSTG.SWR.5000087 服务器内部错误：获取镜像layer失败。 500 SVCSTG.SWR.5000088 服务器内部错误：uds中删除镜像层失败。 409 SVCSTG.SWR.4090089 权限已经存在。 500 SVCSTG.SWR.5000090 服务器内部错误：获取权限失败。 404 SVCSTG.SWR.4040091 权限不存在。 500 SVCSTG.SWR.5000092 服务器内部错误：更新权限失败。 500 SVCSTG.SWR.5000093 服务器内部错误：创建权限失败。 400 SVCSTG.SWR.4000097 已超出可创建组织数量限额。 400 SVCSTG.SWR.4000098 镜像数目超过上限。 400 SVCSTG.SWR.4000099 镜像版本数目超过上限。 500 SVCSTG.SWR.5000112 服务器内部错误：获取镜像资源失败。 404 SVCSTG.SWR.4040113 镜像资源不存在。 500 SVCSTG.SWR.5000114 服务器内部错误：获取镜像版本失败。 404 SVCSTG.SWR.4040115 镜像版本不存在。 400 SVCSTG.SWR.4001000 Content-Type必须为multipart/form-data类型。 413 SVCSTG.SWR.4131001 请求体太大。 500 SVCSTG.SWR.5001002 服务器内部错误：“External”地址未开启。 400 SVCSTG.SWR.4001003 获取表单文件失败。 400 SVCSTG.SWR.4001004 参数“type”应该为“app”。 400 SVCSTG.SWR.4001005 解析表单失败。 400 SVCSTG.SWR.4001006 元文件格式化无效。 400 SVCSTG.SWR.4001008 组织或名称无效。 400 SVCSTG.SWR.4001009 参数“is_public”应该为“true”或“false”。 400 SVCSTG.SWR.4001010 参数“type”应该为“app”或“image”。 400 SVCSTG.SWR.4001011 参数“type”应该为“app”、“image”或为空。 413 SVCSTG.SWR.4131012 该描述内容长度超过限制。 400 SVCSTG.SWR.4001013 “ak”或“sk”不能为空。 400 SVCSTG.SWR.4001014 必选参数未填。 400 SVCSTG.SWR.4001015 表单文件缺失。 400 SVCSTG.SWR.4001016 必选参数未填，至少要包含“is_public”和“manifests”两个参数。 400 SVCSTG.SWR.4001018 请求体类型不正确。 400 SVCSTG.SWR.4001019 解析表单文件失败。 500 SVCSTG.SWR.5001020 服务器内部错误：读取表单文件失败。 400 SVCSTG.SWR.4001021 版本号不能为空。 400 SVCSTG.SWR.4001022 上传文件类型错误。 400 SVCSTG.SWR.4001023 不支持的文件类型。 400 SVCSTG.SWR.4001024 查询参数失败。 400 SVCSTG.SWR.4001025 查询参数不合法。 500 SVCSTG.SWR.5001026 manifest获取失败。 400 SVCSTG.SWR.4001027 “status”只能为“done”或“error”。 400 SVCSTG.SWR.4001028 组织名称不合法。 400 SVCSTG.SWR.4001029 镜像名称不合法。 400 SVCSTG.SWR.4001030 “package”不合法。 403 SVCSTG.SWR.4031032 服务器运行时的资源，请求太多。 403 SVCSTG.SWR.4031033 请求不可用。 400 SVCSTG.SWR.4001035 过滤无效。 400 SVCSTG.SWR.4001036 参数丢失。 400 SVCSTG.SWR.4001037 注册中心类型不支持。 500 SVCSTG.SWR.5001038 不可行的注册中心。 500 SVCSTG.SWR.5001039 搜索失败。 400 SVCSTG.SWR.4001041 “domain”参数无效。 403 SVCSTG.SWR.4031042 请求数目太多。 403 SVCSTG.SWR.4031043 公证人jwt令牌请求无效。 401 SVCSTG.SWR.4011044 镜像已被其他用户创建，您无权上传该镜像。 400 SVCSTG.SWR.4001045 缺少“SWRServer”参数。 500 SVCSTG.SWR.5001046 服务器内部错误：检查组织失败。 500 SVCSTG.SWR.5001047 服务器内部错误：保存组织失败。 400 SVCSTG.SWR.4001048 获取token失败。 500 SVCSTG.SWR.5001049 服务器内部错误：删除组织失败。 500 SVCSTG.SWR.5001050 服务器内部错误：获取镜像层失败。 404 SVCSTG.SWR.4041051 镜像层不存在。 500 SVCSTG.SWR.5001052 服务器内部错误：镜像层不合法。 500 SVCSTG.SWR.5001053 服务器内部错误：镜像层上传不合法。 500 SVCSTG.SWR.5001054 服务器内部错误：创建镜像路径失败。 500 SVCSTG.SWR.5001055 服务器内部错误：保存镜像层失败。 404 SVCSTG.SWR.4041056 镜像tag不存在。 500 SVCSTG.SWR.5001056 服务器内部错误：获取tag列表失败。 404 SVCSTG.SWR.4041057 tag列表不存在。 500 SVCSTG.SWR.5001058 服务器内部错误：保存镜像失败。 500 SVCSTG.SWR.5001059 服务器内部错误：获取镜像失败。 404 SVCSTG.SWR.4041060 manifest不存在。 404 SVCSTG.SWR.4041061 组织不存在。 500 SVCSTG.SWR.5001062 服务器内部错误：更新组织失败。 500 SVCSTG.SWR.5001063 服务器内部错误：删除镜像层失败。 401 SVCSTG.SWR.4011064 跨帐号错误（例如：使用A帐号的token去访问或操作B帐号下的资源），没有权限。 400 SVCSTG.SWR.4001065 组织权限不合法。 400 SVCSTG.SWR.4001066 权限不合法。 400 SVCSTG.SWR.4001067 用户名不合法。 500 SVCSTG.SWR.5001076 获取服务token失败。 401 SVCSTG.S2I.4019000 鉴权错误：没有发现任何用户token或用户AK/SK信息。 403 SVCSTG.SWR.4039001 您无法申请或操作不属于您的资源。 403 SVCSTG.SWR.4039002 您没有权限执行本次操作。 400 SVCSTG.SWR.4009010 无效的组织。 400 SVCSTG.SWR.4009011 无效的镜像名称。 400 SVCSTG.SWR.4009012 无效的代码源类型。 400 SVCSTG.SWR.4009013 无效的ID。 400 SVCSTG.SWR.4009014 无效的过滤条件。 400 SVCSTG.SWR.4009015 解析构建任务失败。 400 SVCSTG.SWR.4009016 无效的文件路径。 400 SVCSTG.SWR.4009017 无效的代码源所有者。 400 SVCSTG.SWR.4009018 无效的代码源仓库。 400 SVCSTG.SWR.4009019 无效的代码源仓库ID。 400 SVCSTG.SWR.4009020 无效的代码源分支。 400 SVCSTG.SWR.4009021 无效的镜像标签。 400 SVCSTG.SWR.4009022 无效的代码源用户名。 400 SVCSTG.SWR.4009023 无效的commit id。 400 SVCSTG.SWR.4006030 执行本次构建失败。 400 SVCSTG.SWR.4006031 本次构建记录已存在。 404 SVCSTG.SWR.4046032 本次构建记录不存在。 500 SVCSTG.SWR.5006033 从数据库中获取本次构建记录失败。 403 SVCSTG.SWR.4037017 您没有编辑/管理任何组织的权限，请先创建组织或获取组织的编辑/管理权限。 403 SVCSTG.SWR.4037018 您没有权限编辑/管理镜像仓库中的任何镜像，请先创建镜像或获取可编辑的/可管理的镜像。 500 SVCSTG.SWR.5007019 创建镜像失败，镜像个数已达到上限。 403 SVCSTG.SWR.4037020 您暂无权限操作该镜像仓库资源，请提升您对应的组织权限。 400 SVCSTG.SWR.4001091 参数permission错误

错误响应Body体格式说明 当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。 [ { "errorCode": "SVCSTG.SWR.4001048", "errorMessage": "Failed to get Token from Context", "detail": "" } ] 其中，errorCode表示错误码，errorMessage表示错误描述信息，detail表示错误详情。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of UserAuth objects 更新组织权限需要的权限 表4 UserAuth 参数 是否必选 参数类型 描述 user_id 是 String 用户id，需要从IAM服务获取 user_name 是 String 用户名，需要从IAM服务获取 auth 是 Long 用户权限，7表示管理权限，3表示编辑权限，1表示读取权限

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 触发动作，update app_type 是 String 应用类型，deployments、statefulsets application 是 String 应用名 cluster_id 否 String 集群ID（trigger_mode设置为cci时为空) cluster_name 否 String 集群名（trigger_mode设置为cci时为空） cluster_ns 是 String 应用名所在的namespace condition 是 String 触发条件，type为all时为.*,type为tag时为tag名,type为regular时为正则表达式 container 否 String 需更新的container名，默认为所有container enable 是 String 是否生效 name 是 String 触发器名 trigger_mode 否 String 触发器类型，cce、cci，默认为cce trigger_type 是 String 触发条件，all、tag、regular

URI POST /v2/manage/namespaces/{namespace}/repos/{repository}/triggers 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 repository 是 String 镜像仓库名称

请求示例 POST https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/triggers { "action" : "update", "app_type" : "deployments", "application" : "adsfa", "cluster_id" : "5b28c12f-dc10-11e9-97b3-0255ac1001b5", "cluster_name" : "test", "cluster_ns" : "default", "condition" : ".*", "container" : "", "enable" : "true", "name" : "test", "trigger_mode" : "cce", "trigger_type" : "all" }

URI POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 repository 是 String 镜像仓库名称

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 remoteRegionId 是 String 目标region ID。 remoteNamespace 是 String 目标组织 syncAuto 否 Boolean 自动同步，默认为false override 否 Boolean 是否覆盖，默认为false

响应示例 状态码： 200 请求成功 [ { "name" : "huawei", "category" : "other", "description" : "", "size" : 115645792, "is_public" : false, "num_images" : 1, "num_download" : 0, "created_at" : "2018-03-21T12:22:37Z", "updated_at" : "2018-03-21T12:22:37Z", "logo" : "", "url" : "", "path" : "swr.cn-north-1.myhuaweicloud.com/namespace/huawei", "internal_path" : "100.125.0.198:20202/namespace/huawei", "domain_name" : "domian", "namespace" : "namespace", "tags" : [ "latest" ], "status" : true } ]

URI GET /v2/manage/shared-repositories 表1 Query参数 参数 是否必选 参数类型 描述 namespace 否 String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 name 否 String 镜像仓库名称 center 否 String self: 我共享的镜像。thirdparty: 他人共享给我的镜像 domain_name 否 String 拥有者账号名称 status 否 String false：共享已过期。true：正常 limit 否 String 返回条数。注意：offset和limit参数需要配套使用。 offset 否 String 起始索引。注意：offset和limit参数需要配套使用。 order_column 否 String 按列排序，可设置为updated_at（按更新时间排序）,name（名称）、tag_count（版本数）、namespace（组织）、domain_name（拥有者）。注意：order_column和order_type参数需要配套使用。 order_type 否 String 排序类型，可设置为desc（降序）、asc（升序）。注意：order_column和order_type参数需要配套使用。 filter 否 String 应填写 center::{center}|name::{name}|limit::{limit}|offset::{offset}|namespace::{namespace}|order_column::{order_column}|order_type::{order_type} ,其中 {center}可选为self: 我共享的镜像。thirdparty: 他人共享给我的镜像，namespace为组织名称，name为镜像仓库名称， {limit}为返回条数,{offset}为起始索引,{order_column}为按列排序，updated_at（按更新时间排序）,name（名称）、tag_count（版本数）、namespace（组织）、domain_name（拥有者）,{order_type}为排序类型，可设置为desc（降序）、asc（升序）

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数 状态码： 200 表3 响应Header参数 参数 参数类型 描述 Content-Range String offset(开始索引)-count(当前页记录条数)/total(总记录条数) 表4 响应Body参数 参数 参数类型 描述 [数组元素] Array of ShowReposResp objects 请求成功 表5 ShowReposResp 参数 参数类型 描述 name String 仓库名称 category String 仓库类型（计划改造，每个镜像会有多个lable标示） description String 仓库描述信息 size Long 仓库大小 is_public Boolean 仓库是否为公共仓库，值为true或false num_images Long 仓库中镜像个数，0 ~ 9223372036854775807 num_download Long 仓库下载次数 created_at String 仓库创建时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00 updated_at String 仓库更新时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00 logo String 仓库logo地址（暂时未用） url String 仓库logo图片的URL，URL格式。（暂时未用） path String 镜像pull路径，格式为 swr.cn-north-1.myhuaweicloud.com/namespace/repository internal_path String 镜像pull路径，格式为 10.125.0.198:20202/namespace/repository domain_name String 租户名 namespace String 租户的组织名称 tags Array of strings 镜像版本列表 status Boolean 查询他人共享镜像：共享是否过期 查询我共享的镜像：默认为false,无意义 total_range Long 总记录条数

响应参数 状态码： 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

响应示例 状态码： 200 查询成功 [ { "createdAt" : "2020-03-12T08:11:36.518144Z", "domainID" : "0657**************************f60", "domainName" : "h**********4", "id" : 1, "namespace" : "test", "override" : false, "remoteNamespace" : "remtens", "remoteRegionId" : "cn-north-1", "repoName" : "testrepo", "status" : "success", "syncOperatorId" : "065***********************10", "syncOperatorName" : "h**********4", "tag" : "8", "updatedAt" : "2020-03-12T08:11:41.505499Z" } ]

URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_job 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 repository 是 String 镜像仓库名称 表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的值）。

URI POST /v2/manage/namespaces/{namespace}/repos/{repository}/sync_images 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 repository 是 String 镜像仓库名称

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 imageTag 是 Array of strings 版本列表 override 否 Boolean 是否覆盖，默认为false remoteNamespace 是 String 目标组织 remoteRegionId 是 String 目标region ID。

请求示例 POST https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/sync_images { "imageTag" : [ "V1" ], "override" : true, "remoteNamespace" : "sdsad", "remoteRegionId" : "cn-north-208" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 namespaces Array of ShowNamespace objects 组织列表 表4 ShowNamespace 参数 参数类型 描述 id Integer id name String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 creator_name String IAM用户名 auth Integer 用户权限。7表示管理权限，3表示编辑权限，1表示读取权限。

URI GET /v2/manage/namespaces 表1 Query参数 参数 是否必选 参数类型 描述 namespace 否 String 组织名称。小写字母开头，后面跟小写字母、数字、点、下划线或中划线（其中下划线最多允许连续两个，中划线允许连续多个，点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 filter 否 String 应填写namespace::{namespace}|mode::{mode}。其中{namespace}是组织名称，{mode}如果不设置，查看有权限的组织列表；设置为visible，查看可见的组织列表（部分组织：仓库有权限，组织没有权限）。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 repository 是 String 镜像仓库名称 retention_id 是 Integer 镜像老化规则id

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应示例 状态码： 200 查询成功 { "algorithm" : "or", "id" : 222, "rules" : [ { "params" : { "days" : "30" }, "tag_selectors" : [ { "kind" : "label", "pattern" : "v5" }, { "kind" : "label", "pattern" : "1.0.1" }, { "kind" : "regexp", "pattern" : "^123$" } ], "template" : "date_rule" } ], "scope" : "" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 algorithm String 回收规则匹配策略，or id Integer ID rules Array of Rule objects 镜像老化规则 scope String 保留字段 表4 Rule 参数 参数类型 描述 template String 回收类型，date_rule、tag_rule params Object template是date_rule时，设置params为{"days": "xxx"} template是tag_rule时，设置params为{"num": "xxx"} tag_selectors Array of TagSelector objects 例外镜像 表5 TagSelector 参数 参数类型 描述 kind String 匹配规则，label、regexp pattern String kind是label时，设置为镜像版本,kind是regexp时，设置为正则表达式

请求示例 PATCH https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}/retentions/{retention_id} { "algorithm" : "or", "rules" : [ { "params" : { "days" : "30" }, "tag_selectors" : [ { "kind" : "label", "pattern" : "v5" }, { "kind" : "label", "pattern" : "1.0.1" }, { "kind" : "regexp", "pattern" : "^123$" } ], "template" : "date_rule" } ] }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json 缺省值：application/json X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 algorithm 是 String 老化规则匹配策略，固定为"or" rules 是 Array of Rule objects 镜像老化规则 表4 Rule 参数 是否必选 参数类型 描述 template 是 String 回收类型，date_rule、tag_rule params 是 Object template是date_rule时，设置params为{"days": "xxx"} template是tag_rule时，设置params为{"num": "xxx"} tag_selectors 是 Array of TagSelector objects 例外镜像 表5 TagSelector 参数 是否必选 参数类型 描述 kind 是 String 匹配规则，label、regexp pattern 是 String kind是label时，设置为镜像版本,kind是regexp时，设置为正则表达式