原生容器

产品文档

原生容器

原生容器

简介

原生容器相关接口

版本

v1

API

接口名称 请求方式 功能描述
associateElasticIp POST 容器绑定弹性公网 IP,绑定的是主网卡、主内网IP对应的弹性IP.
一台云主机只能绑定一个弹性公网 IP(主网卡),若主网卡已存在弹性公网IP,会返回错误。
如果是黑名单中的用户,会返回错误。
createContainers POST 创建一台或多台指定配置容器
- 创建容器需要通过实名认证
- 镜像
- 容器的镜像通过镜像名称来确定
- nginx:tag, mysql/mysql-server:tag这样命名的镜像表示docker hub官方镜像
- container-registry/image:tag这样命名的镜像表示私有仓储的镜像
- 私有仓储必须兼容docker registry认证机制,并通过secret来保存机密信息
- hostname规范
- 支持两种方式:以标签方式书写或以完整主机名方式书写
- 标签规范
- 0-9,a-z(不分大小写)和-(减号),其他的都是无效的字符串
- 不能以减号开始,也不能以减号结尾
- 最小1个字符,最大63个字符
- 完整的主机名由一系列标签与点连接组成
- 标签与标签之间使用“.”(点)进行连接
- 不能以“.”(点)开始,也不能以“.”(点)结尾
- 整个主机名(包括标签以及分隔点“.”)最多有63个ASCII字符
- 正则表达式
- `^([a-zA-Z0-9]
createSecret POST 创建一个 secret,用于存放镜像仓库认证信息。
deleteContainer DELETE 容器状态必须为 stopped、running 或 error状态。
按量付费的实例,如不主动删除将一直运行,不再使用的实例,可通过本接口主动停用。
只能支持主动删除按配置计费类型的实例。包年包月过期的容器也可以删除,其它的情况还请发工单系统。计费状态异常的容器无法删除。
deleteSecret DELETE 删除单个 secret
describeContainer GET 查询一台原生容器的详细信息
describeContainers GET 批量查询原生容器的详细信息
此接口支持分页查询,默认每页20条。
describeInstanceTypes GET 查询实例规格信息列表
describeQuota GET 查询资源的配额,支持:原生容器 pod 和 secret.
describeSecret GET 查询单个 secret 详情
describeSecrets GET 查询 secret 列表。

此接口支持分页查询,默认每页20条。
disassociateElasticIp POST 容器解绑公网 IP,解绑的是主网卡、主内网 IP 对应的弹性 IP.
execCreate POST 创建exec
execGetExitCode GET 获取exec退出码
getLogs GET 查询单个容器日志
modifyContainerAttribute PATCH 修改容器的 名称 和 描述。
name 和 description 必须要指定一个
rebuildContainer POST 重置原生容器,对已有原生容器使用新的镜像重置。
原容器 id 不变,不涉及计费变动,暂不支持修改实例类型,不会改变原生容器所在的物理节点,也不支持修改已经使用的系统盘和数据盘以及网络相关参数。
- 镜像
- 容器的镜像通过镜像名称来确定
- nginx:tag 或 mysql/mysql-server:tag 这样命名的镜像表示 docker hub 官方镜像
- container-registry/image:tag 这样命名的镜像表示私有仓储的镜像
- 私有仓储必须兼容 docker registry 认证机制,并通过 secret 来保存机密信息
- 其他
- rebuild 之前容器必须处于关闭状态
- rebuild 完成后,容器仍为关闭状态
resizeTTY POST 调整TTY大小
startContainer POST 启动处于关闭状态的单个容器,处在任务执行中的容器无法启动。
容器实例或其绑定的云盘已欠费时,容器将无法正常启动。
stopContainer POST 停止处于运行状态的单个实例,处于任务执行中的容器无法启动。
更新时间:2019-08-09 17:46:26