检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
权限和授权项 如果您需要对您所拥有的容器镜像服务（SWR）进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用SWR服务的其它功能。
镜像漏洞扫描 操作场景 容器镜像服务为您提供了镜像安全扫描的功能，您只需要一键就可以对您的镜像进行安全扫描。容器镜像服务可扫描镜像仓库中的私有镜像，发现镜像中的漏洞并给出修复建议，帮助您得到一个安全的镜像。 约束与限制 目前仅支持“华北-北京一”区域。 操作步骤 登录容器镜像服务控制台。
共享版及企业版对比 容器镜像服务目前有共享版和企业版。差异如下： 表1 容器镜像服务共享版和容器镜像服务企业版对比表 大类 功能项 共享版 企业版 通用 页面入口 登录华为云控制台，单击服务列表，搜索“容器镜像服务”，单击进入的是共享版容器镜像服务。 在共享版容器镜像服务页面单击
获取共享账号列表 功能介绍 获取共享账号列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repositories/{repository}/access-domains 表1 路径参数 参数
镜像授权管理 操作场景 如果您需要对容器镜像服务进行权限管理，您可以使用统一身份认证服务IAM，设置权限的方法请参见创建用户并授权使用SWR。当您具有SWR Admin或者Tenant Administrator系统权限时，您就拥有了SWR的管理员权限，可以在SWR中为其他IAM
购买仓库 操作场景 使用容器镜像服务企业仓库前，您首先需要购买仓库。企业仓库提供企业级的云原生制品安全托管服务，提供容器镜像等符合OCI规范的云原生制品托管。 仓库支持访问控制，新创建的仓库默认阻断全部访问来源，请参考访问控制开通访问控制，避免无法正常访问仓库。 仓库是按照reg
创建用户并授权使用SWR 如果您需要对您所拥有的容器镜像服务（SWR）进行角色与策略的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以： 根据企业的业务组织，在您的华为云账号中，给企业中不同职能部
是否为公共仓库，可选值为true或false。 category 否 String 仓库类型，可设置为app_server, linux, framework_app, database, lang, other, windows, arm。 description 否 String 镜像仓库的描述信息。 响应参数 无
获取镜像老化规则列表 功能介绍 获取镜像老化规则列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/retentions 表1 路径参数 参数 是否必选 参数类型
域名管理 SWR仓库的域名包含以下两类： 默认域名：默认域名，创建仓库自动生成的域名。 自定义域名：自定义的域名。 其中，自定义域名功能适用场景： 用户欲使用公司统一规划的域名访问服务。 从其他镜像仓库服务迁移至本产品时，可继续使用原有域名，保持业务的连续性。 在 SWR仓库中，
获取镜像仓库下的触发器列表 功能介绍 获取镜像仓库下的触发器列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/triggers 表1 路径参数 参数 是否必选
获取长期有效登录或推拉镜像指令 操作场景 本章节介绍如何获取docker容器引擎长期有效的登录指令以及containerd容器引擎长期推送、拉取镜像指令，长期有效登录指令的有效期为永久。 为保证安全，获取登录指令过程建议在开发环境执行。 用户登录IAM控制台前，请确保已具有IAM
查询组织列表 功能介绍 查询组织列表 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces 表1 Query参数 参数 是否必选 参数类型 描述 namespace 否 String 组织名称。小写字母开头，后面跟小写字母、数
查询所有API版本信息 功能介绍 查询所有API版本信息 接口约束 无 调用方法 请参见如何调用API。 URI GET / 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用：
如何制作容器镜像？ 自己制作容器镜像，主要有两种方法： 制作快照方式获得镜像（偶尔制作的镜像）：在基础镜像上（比如Ubuntu），先登录镜像系统并安装容器引擎软件，然后整体制作快照。 Dockerfile方式构建镜像（经常更新的镜像）：将软件安装的流程写成Dockerfile，使用docker
镜像老化 操作场景 镜像上传后，您可以添加镜像老化规则。容器镜像服务提供了如下两种类型的镜像老化处理规则，规则设置完成后，系统会根据已定义的规则自动执行镜像老化操作。 存活时间：设置该类型的老化规则后，留存时间超过指定时间的老旧镜像将被删除。 版本数目：设置该类型的老化规则后，留存镜像超过指定值时，老旧镜像将被删除。
查询指定API版本信息 功能介绍 查询指定API版本信息 接口约束 无 调用方法 请参见如何调用API。 URI GET /{api_version} 表1 路径参数 参数 是否必选 参数类型 描述 api_version 是 String API版本号。 请求参数 表2 请求Header参数
使用image-migrator迁移镜像至SWR 为保证集群迁移后容器镜像可正常拉取，提升容器部署效率，建议您将自建镜像仓库迁移至华为云容器镜像服务（SWR）。 image-migrator是一个镜像迁移工具，能够自动将基于Docker Registry v2搭建的Docker镜像仓库中的镜像迁移到SWR中。
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个 4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。
VPN/云专线访问 场景描述 该场景下用户本地数据中心或私有网络无法通过公网访问SWR。这种情况下可以通过云专线或VPN连接华为云VPC，通过专线或VPN打通用户本地数据中心到VPC间的网络，使用VPC终端节点访问SWR。 此场景仅适用于通过容器镜像服务上传镜像，当您需要下载镜像
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
