检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
基本概念 镜像（Image） 容器镜像是一个模板，是容器应用打包的标准格式，在部署容器化应用时可以指定镜像，镜像可以来自于镜像中心或者用户的私有Registry。例如一个容器镜像可以包含一个完整的Ubuntu操作系统环境，里面仅安装了用户需要的应用程序及其依赖文件。容器镜像用于创
页面上传镜像 操作场景 本章节介绍如何通过页面上传镜像。从页面上传镜像，是指直接通过控制台页面将镜像上传到容器镜像服务的镜像仓库。 约束与限制 每次最多上传10个文件，单个文件大小（含解压后）不得超过2G。 仅支持上传1.11.2（包含）到24.0.9（包含）版本Docker容器引擎客户端制作的镜像压缩包。
查询组织权限 功能介绍 查询组织权限 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/access 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。
查询共享镜像列表 功能介绍 查询共享镜像列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/shared-repositories 表1 Query参数 参数 是否必选 参数类型 描述 namespace 否 String 组织名称。小写字
查询镜像tag列表 功能介绍 查询镜像tag列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/tags 表1 路径参数 参数 是否必选 参数类型 描述 namespace
获取镜像自动同步任务信息 功能介绍 创建镜像自动同步任务后，可以通过此接口查询该任务的状态，以判断是否同步成功。 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_job
查询镜像权限 功能介绍 查询镜像权限 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/access 表1 路径参数 参数 是否必选 参数类型 描述 namespace
创建共享账号 功能介绍 创建共享账号。镜像上传后，您可以共享私有镜像给其他账号，并授予下载该镜像的权限。 接口约束 无 调用方法 请参见如何调用API。 URI POST /v2/manage/namespaces/{namespace}/repositories/{reposi
上传镜像 入门指引 容器镜像服务是一种支持容器镜像全生命周期管理的服务，提供简单易用、安全可靠的镜像管理功能，帮助用户快速部署容器化服务。本文档以一个2048应用为例，帮助您学习如何安装容器引擎并构建镜像，以及如何使用容器引擎客户端上传镜像到容器镜像仓库。 上传镜像到容器镜像仓库
创建镜像自动同步任务 功能介绍 创建镜像自动同步任务，帮助您把最新推送的镜像自动同步到其他区域镜像仓库内。 镜像自动同步帮助您把最新推送的镜像自动同步到其他区域镜像仓库内，后期镜像有更新时，目标仓库的镜像也会自动更新，但已有的镜像不会自动同步。已有镜像的同步需要手动操作，详情请参见手动同步镜像。
获取镜像自动同步任务列表 功能介绍 获取为当前镜像仓库所创建的所有自动同步任务。 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/sync_repo 表1 路径参数
查询服务特性开关信息 功能介绍 查询服务特性开关信息 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/projects/{project_id}/feature-gates 表1 路径参数 参数 是否必选 参数类型 描述 project_id
添加镜像授权 场景描述 本章节指导用户通过API为镜像添加授权。API的调用方法请参见如何调用API。 涉及接口 本示例场景涉及如下接口调用： 创建镜像权限 查询镜像权限 终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点
查询镜像仓库列表 功能介绍 查询镜像仓库列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/repos 表1 Query参数 参数 是否必选 参数类型 描述 namespace 否 String 组织名称。小写字母开头，后面跟小写字母、数字
查询所有API版本信息 功能介绍 查询所有API版本信息 接口约束 无 调用方法 请参见如何调用API。 URI GET / 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用：
手动同步镜像 功能介绍 对于镜像仓库已有的镜像，如果想在其他区域使用，需要手动触发镜像同步。 判断是否同步成功的方法如下：响应状态码为200，无报错信息，表示同步成功。通过SWR管理控制台或调用查询镜像仓库概要信息接口，在目标区域的目标组织下，若存在所同步的镜像版本表示同步成功。
获取镜像老化记录 功能介绍 获取镜像老化记录 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions/histories 表1 路径参数 参数 是否必选
容器镜像迁移 方案概述 使用docker命令迁移镜像至SWR 使用image-syncer迁移镜像至SWR 使用image-migrator迁移镜像至SWR 跨云Harbor同步镜像至华为云SWR
状态码 正常 返回值 说明 200 OK GET和PUT操作正常返回。 201 Created POST操作正常返回。 202 Accepted 请求已被接受。 204 No Content DELETE操作正常返回。 异常 返回值 说明 400 Bad Request 服务器未能处理请求。
共享版及企业版对比 容器镜像服务目前有共享版和企业版。差异如下： 表1 容器镜像服务共享版和容器镜像服务企业版对比表 大类 功能项 共享版 企业版 通用 页面入口 登录华为云控制台，单击服务列表，搜索“容器镜像服务”，单击进入的是共享版容器镜像服务。 在共享版容器镜像服务页面单击
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
