简介

最近更新时间:2018-11-08 21:17:35

容器实例服务 API 升级到 3.0 版本,全新的 API 接口文档更加规范和全面,统一的参数风格和公共错误码,统一的 SDK/CLI 版本与 API 文档严格一致,给您带来简单快捷的使用体验;支持全地域就近接入让您更快连接腾讯云产品。

欢迎使用容器实例服务(Container Instance Service,CIS)。

容器实例服务(Container Instance Service,CIS)为用户提供弹性的计算资源。用户可以使用本文档介绍的 API,并参照相应的示例,对容器实例进行相关操作:如创建、销毁、查看时间、查看日志等。

请确保在使用这些接口前,已充分了解了 CIS 概述

注意:

本模块下的容器实例服务接口,均为 API 3.0 接口。

术语表

本文档涉及的一些常用术语如下:

术语 中文 说明
Region 地域 表示资源所在的地域,每个地域包含一个或多个可用区
Zone 可用区 指腾讯云在同一 地域 内电力和网络互相独立的物理数据中心。目标是能够保证可用区之间故障相互隔离,不出现故障扩散,使得用户的业务持续在线服务
InstanceName 容器实例名 容器实例名称,由小写字母、数字和 - 组成,由小写字母开头,小写字母或数字结尾,且长度不超过 63 个字符
VpcId 私有网络 ID 私有网络 是自定义的逻辑隔离网络空间
SubnetId 私有网络子网 ID 子网 是 VPC 内的 IP 地址块,私有网络中的所有云资源都必须部署在子网内
Image 容器镜像 启动容器依赖的 docker 镜像,镜像包含了容器主进程和运行时的一切依赖
RestartPolicy 重启策略 never:容器实例退出时不会自动重启; on-failure: 当容器实例以非0状态码退出时重启;always:不管容器实例退出状态码是什么始终重启
State 实例状态 Pending:创建中;Running:运行中;Successed:运行成功,已结束;Failed:运行失败,已结束;Unknown:状态异常
State 容器状态 Waiting:创建中;Running:运行中;Terminated:已结束,需要根据 ExitCode 判断结束原因

API 快速入门

这里针对几个典型的使用场景对 CIS API 的使用方式进行说明:

通过使用 创建容器实例 API,提供可用区 ID、镜像 ID、所需配置等一些必要的信息,即可立刻创建一个按量计费的实例。

在不使用此实例时使用 删除容器实例 API 销毁它。删除实例后,将不再收费。

使用限制

API 创建的机器遵循 CIS 购买限制 文档所描述的数量限制,和官网所创建的容器实例共用配额。

更具体的限制请参考对应 API 接口文档或产品文档。