- 地域
- 容器组
- 容器
- 镜像缓存
- 数据缓存
- 虚拟节点
- 监控
- 运维操作
- 标签
- 其他接口
接口说明
注意事项
- 创建镜像缓存涉及资源计费。建议您提前了解相关计费信息。更多信息,请参见镜像缓存计费。
- 创建镜像缓存前,您需要评估待缓存镜像的总大小,如果镜像总大小超过设置的缓存大小,将会创建失败。
- 创建镜像缓存时,系统将自动创建一个 ECI 实例和一块 ESSD PL1 类型的云盘用于中转创建镜像缓存。创建过程中请勿删除 ECI 实例和云盘,否则镜像缓存将创建失败。
- 创建镜像缓存将生成对应的快照。请勿删除快照,否则镜像缓存将会失效。
- 如果使用 SDK,则对应版本为:Java 1.0.10 以上,Python 1.0.7 以上。
使用建议
- 对于使用自定义域名的 ACR 企业版镜像,需要指定 ACR 实例(设置 AcrRegistryInfo 相关参数)来配置免密。设置 AcrRegistryInfo 相关参数时,必须设置 AcrRegistryInfo.N.InstanceId。
- 如果该镜像缓存将用于批量创建多个(超过 1000 个)ECI 实例,建议您设置 StandardCopyCount 和 FlashCopyCount 实现快照多副本功能。快照多副本按增量数据收费,由于本次创建的多个快照副本数据均一致,因此使用快照多副本功能不会增加额外费用。
请求参数
字段名称 | 字段详情 |
---|---|
RegionIdstring | 地域 ID。 示例值:cn-hangzhou参考取值来源: DescribeRegions |
ZoneIdstring | 可用区。 示例值:cn-hangzhou-g |
SecurityGroupIdstring | 安全组 ID。 示例值:sg-uf66jeqopgqa9hdn****参考取值来源: DescribeContainerGroups |
VSwitchIdstring | 交换机 ID。支持指定多个交换机 ID(单次最多 10 个),各交换机 ID 之间可以用半角逗号(,)进行分割,例如 示例值:vsw-uf6h3rbwbm90urjwa**** |
ImageCacheNamestring | 镜像缓存名称。 示例值:testcache参考取值来源: DescribeImageCaches |
EipInstanceIdstring | 弹性公网 IP。如果需要拉取公网镜像,需要确保 ECI 实例能够访问公网,您可以配置 EIP 或者 NAT 网关实现公网访问。 示例值:eip-2zedsm5mfl3uhdj2d**** |
ResourceGroupIdstring | 资源组 ID。 示例值:rg-aekzh43v*****参考取值来源: DescribeContainerGroups |
ClientTokenstring | 保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。只支持 ASCII 字符,且不能超过 64 个字符。更多信息,请参见如何保证幂等性。 示例值:123e4567-xxx-xxx-xxxx-42665544xxxx |
ImageCacheSizeinteger<int32> | 镜像缓存的大小。默认为 20 GiB。 示例值:20 |
RetentionDaysinteger<int32> | 镜像缓存保留时间,过期将会被清理,默认永不过期。展开详情 示例值:7 |
AutoMatchImageCacheboolean | 是否开启镜像缓存复用。开启后,新创建的镜像缓存可以复用已有镜像缓存的镜像层,加快镜像缓存的制作速度。取值范围:展开详情 示例值:true |
ImageRegistryCredentialarray<object> | 镜像仓库信息。 子级条数 <= 11 |
Imagearray<string> | 用于制作镜像缓存的容器镜像。 示例值:registry-vpc.cn-hangzhou.aliyuncs.com/eci_open/nginx:1.15.10-perl子级条数 <= 101 |
Tagarray<object> | 镜像缓存标签信息,最多 20 个。 子级条数 <= 21 |
Flashboolean | 是否开启极速镜像缓存功能,开启后,可以加速镜像缓存创建。取值范围:展开详情 示例值:true |
AcrRegistryInfoarray<object> | ACR 实例信息。更多信息,请参见免密拉取 ACR 镜像。 子级条数 <= 21 |
Annotationsstring | 注解。该参数暂不对外使用。 示例值:hide |
PlainHttpRegistrystring | 自建镜像仓库地址。使用 HTTP 协议的自建镜像仓库中的镜像创建镜像缓存时,需配置该参数,使得 ECI 使用 HTTP 协议拉取镜像,避免因协议不同而导致镜像拉取失败。 示例值:"harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80" |
InsecureRegistrystring | 自建镜像仓库地址。展开详情 示例值:"harbor***.pre.com,192.168.XX.XX:5000,reg***.test.com:80" |
StandardCopyCountinteger<int32> | 标准快照副本数。默认情况下,一个镜像缓存对应一个快照。如果该镜像缓存将用于批量创建多个 ECI 实例,建议您配置该参数实现快照多副本。推荐每 1000 个 ECI 实例增加一个快照副本。展开详情 示例值:7 |
FlashCopyCountinteger<int32> | 本地快照副本数。默认情况下,一个镜像缓存对应一个快照。如果该镜像缓存将用于批量创建多个 ECI 实例,建议您配置该参数实现快照多副本。推荐每 1000 个 ECI 实例增加一个快照副本。展开详情 示例值:7 |
EliminationStrategystring | 镜像缓存的淘汰策略。默认为空,表示一直保留。展开详情 示例值:LRU |
OsTypestring | 容器镜像的操作系统。取值范围:展开详情 示例值:Linux |
返回参数
字段名称 | 字段详情 |
---|---|
RequestIdstring | 请求 ID,唯一标识。 示例值:0E234675-3465-4CC3-9D0F-9A864BC391DD |
ImageCacheIdstring | 镜像缓存 ID。 示例值:imc-2zebxkiifuyzzlhl**** |
ContainerGroupIdstring | 用于中转创建镜像缓存的 ECI 实例 ID。 示例值:eci-2zebxkiifuyzzlhl**** |