检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
概述 欢迎使用容器镜像服务（Software Repository for Container，SWR）。容器镜像服务是一种支持镜像全生命周期管理的服务，提供简单易用、安全可靠的镜像管理功能，帮助您快速部署容器化服务。 您可以使用本文档提供API对容器镜像服务进行相关操作，如创建、
添加镜像授权 场景描述 本章节指导用户通过API为镜像添加授权。API的调用方法请参见如何调用API。 涉及接口 本示例场景涉及如下接口调用： 创建镜像权限 查询镜像权限 终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同
创建用户并授权使用SWR 如果您需要对您所拥有的容器镜像服务（SWR）进行角色与策略的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），通过IAM，您可以： 根据企业的业务组织，在您的华为云账号中，给企业中不同职能部门的员工创建
命名空间 操作场景 命名空间用于管理多个具有关联属性的镜像，不直接存储容器镜像，可对应企业内部的一个产品项目或部门。 仓库创建成功后，默认会创建一个名为“library”的公有命名空间。 创建命名空间 登录容器镜像服务控制台，单击左侧菜单栏的“企业版”，在“仓库管理”页面单击您的仓库名称进入仓库
API调用异常 调用SWR的API的url里如果带镜像名称，并且镜像名称带/时，将/替换成$调用。 例如有个名为a/b的镜像属于c组织： 调用查看镜像信息接口时需要把：GET /v2/manage/namespaces/c/repos/a/b 替换为：GET /v2/manage/
删除组织 功能介绍 删除组织 接口约束 无 调用方法 请参见如何调用API。 URI DELETE /v2/manage/namespaces/{namespace} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母
组织管理 操作场景 组织用于隔离镜像仓库，每个组织可对应一个公司或部门，将其拥有的镜像集中在该组织下。在不同的组织下，可以有同名的镜像。同一IAM用户可属于不同的组织，如图1所示。 SWR支持为账户下IAM用户分配相应的访问权限（读取、编辑、管理），具体请参见镜像授权管理。 图1
创建组织 功能介绍 创建组织 接口约束 无 调用方法 请参见如何调用API。 URI POST /v2/manage/namespaces 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式），下方类型可任选其一使用
约束与限制 您能创建的容器镜像服务组织数量与配额有关系，如表1所示。 表1 配额 资源类型 配额 组织数量 5 如果您需要扩大配额，请参见“如何申请扩大配额”。 更详细的限制请参见具体API的说明。 父主题： 使用前必读
如何制作镜像包？ 使用docker save命令可将容器镜像制作成tar或tar.gz镜像包，具体命令格式如下： docker save [OPTIONS] IMAGE [IMAGE...] OPTIONS说明：--output、-o，表示导出到文件。 示例： $ docker save
镜像老化 操作场景 镜像上传后，您可以添加镜像老化规则。容器镜像服务提供了如下两种类型的镜像老化处理规则，规则设置完成后，系统会根据已定义的规则自动执行镜像老化操作。 存活时间：设置该类型的老化规则后，留存时间超过指定时间的老旧镜像将被删除。 版本数目：设置该类型的老化规则后，留存镜像超过指定值时
获取配额信息 功能介绍 获取配额信息 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/projects/{project_id}/quotas 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID 请求参数
获取租户总览信息 功能介绍 获取租户总览信息 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/overview 请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 消息体的类型（格式
创建镜像仓库 场景描述 本章节指导用户通过API创建和删除镜像仓库。API的调用方法请参见如何调用API。 涉及接口 本示例场景涉及如下接口调用： 创建组织 查询组织列表 创建镜像仓库 查询镜像仓库概要信息 终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址
创建镜像老化规则 场景描述 本章节指导用户通过API创建镜像添加老化规则。API的调用方法请参见如何调用API。 涉及接口 本示例场景涉及如下接口调用： 创建镜像老化规则 删除镜像老化规则 终端节点（Endpoint） 终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同
为什么创建组织失败？ 问题现象：创建组织失败，页面提示该组织已经存在，但在“组织管理”页面没有查询到该组织。 解决办法：组织名称全局唯一，即当前区域下，组织名称唯一。 创建组织时如果提示组织已存在，可能该组织名称已被其他用户使用，请重新设置一个组织名称。 父主题： 通用类
获取组织详情 功能介绍 获取组织详情 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace} 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头，后面跟小写字母
查询组织权限 功能介绍 查询组织权限 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/access 表1 路径参数 参数 是否必选 参数类型 描述 namespace 是 String 组织名称。小写字母开头
查询镜像权限 功能介绍 查询镜像权限 接口约束 无 调用方法 请参见如何调用API。 URI GET /v2/manage/namespaces/{namespace}/repos/{repository}/access 表1 路径参数 参数 是否必选 参数类型 描述 namespace
购买仓库 操作场景 使用容器镜像服务企业仓库前，您首先需要购买仓库。企业仓库提供企业级的云原生制品安全托管服务，提供容器镜像等符合OCI规范的云原生制品托管。 仓库支持访问控制，新创建的仓库默认阻断全部访问来源，请参考访问控制开通访问控制，避免无法正常访问仓库。 仓库是按照region
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
