欢迎使用API文档，如果您熟悉网络服务协议和一种以上编程语言，推荐您调用API管理您的资源和开发自己的应用程序。
本文档提供了API的描述、语法、参数说明及示例等内容。在调用API之前，请确保已经充分了解相关术语，详细信息请参见下表。
| 术语 | 说明 |
|---|---|
| 云主机 | 运行在云环境上的虚拟机，相当于数据中心的一台物理服务器。用户可以通过选择合适的CPU／内存／操作系统磁盘空间，网络，安全组等配置创建云主机。 |
| 云硬盘 | 为云主机提供块级存储设备，相当于一台物理机的硬盘。云硬盘是独立的资源，其生命周期独立于云主机，可以被挂载到任何云主机上，也可以从云主机卸载，然后挂载到其他云主机。 |
| 镜像 | 操作系统的安装模版，用户可以选择合适的操作系统镜像创建所需要的云主机。 只有云管理员用户具有上传镜像操作权限，其他权限的用户只能使用和查看。但用户可以通过云主机快照创建新的镜像，并在启动云主机时选择”云主机快照”类型来使用新的镜像。 |
| 快照 | 用户可以对云主机和云硬盘创建快照，保存当时状态下的云主机和云硬盘数据作为备份。用户可以基于这个快照创建新的云主机。云硬盘快照保存当时状态下的硬盘数据，并可以基于快照创建新的云硬盘。 |
| 物理节点 | 一个云环境中包含一组物理节点，每个物理节点对应一台物理服务器。物理节点可分为不同的角色，如控制节点、计算节点、存储节点和融合节点等。其中带计算角色的物理节点可以运行云主机。物理节点也可简称为“节点”。 |
| 安全组 | 一系列防火墙规则组成安全组，创建云主机时，用户可以选择合适的安全组来保障云主机的安全。安全组对主机上的所有网卡生效，新增网卡也将应用已有的安全组。 |
| 公网IP | 独立的IP地址资源，用户可以将申请的公网IP绑定到自己的云主机上，之后便可从外部网络通过公网IP来访问云主机提供的服务。 |
| SSH密钥对 | 基于密钥的安全验证登录方法，保证云主机安全。我们推荐使用密钥对登录云主机。 |
| 网络 | 网络与现实世界的交换机／路由器／服务器／连线组成的基础设施网络类似， 创建网络后，用户可以在网络内创建子网，创建云主机时选择网络，组建服务器集群。我们提供的基础网络包含共享网络和外部网络，创建在共享网络上的云主机处于同一个网络内，通过安全组保障云主机访问安全。外部网络主要用于公网IP地址的分配。 用户可以为项目创建内部网络，并在内部网络中创建子网。如同在物理网络上通过交换机将服务器连接到一起的局域网，服务器通过交换机连接到子网中。不同的内部网络之间是完全隔离的，因此不同的网络中可以配置相同的IP地址而不会产生冲突。同一个网络内可以创建多个子网，以适应业务的需求。 |
| 路由器 | 用户创建路由器，为不同的子网提供三层路由，从而让子网内的云主机与其他子网的云主机互联互通。也可以将用户创建的内部网络连接到外部网络，让内部网络的云主机访问Internet。路由器配置网关后，还可以为内网的云主机做端口转发，以节约公网IP地址资源。 |
| 负载均衡 | 用户创建负载均衡，能够将所收到的网络流量分配给若干个提供相同处理功能的虚拟机，并按照特定的算法保证每台虚拟机工作在最优的负载状态，从而达到更高效的使用计算资源的目的。这些虚拟机构成了一个集群，负载均衡会为集群设置一个对外提供服务的地址Virtual IP，外部用户通过Virtual IP实现对集群的访问。Virtual IP可以来自公网IP或者内网IP，分别提供对外和对内访问的负载均衡服务。 |
| 防火墙 | 防火墙提供网络间的访问控制功能，通过防火墙策略中的过滤规则对当前项目中的网络流量进行过滤。防火墙必须与一个防火墙策略相关联，防火墙策略是防火墙规则的集合，防火墙规则支持多种网络协议。 |
| 网络拓扑 | 展示用户当前所在项目的网络结构图。点击各个设备可以展示详细配置。 |
| 告警 | 用户对资源（云主机／云硬盘等）的监控数据设置告警条件，当监控数据达到阈值就会发送告警到通知列表中的邮件。 |
| 部门 | 部门是云平台中用户权限的一个划分层级，用户不能横跨多个部门。 |
| 项目 | 项目是定义资源所有权的基本单元，可理解为租户。所有资源（如云主机等）都要隶属于某个项目中。项目必须隶属于一个部门。项目名称在单个部门中的管理范围内是唯一的，但在整个云平台中可以不唯一。 |
| 用户 | 用户可以被云管理员、部门管理员创建。 用户通过登录后，可以操作云平台提供的各项资源，如云主机／云硬盘等。 |
