跳转到正文
皓量云擎文档

实例交付流程

从资源候选到任务确认,交付可登录的实例。

查询候选

按目标租户查询镜像、规格、安全组和网络。先确定私有子网或直连授权网络,再读取存储候选;不要让用户任意提交物理主机地址或存储路径。

创建请求使用镜像、规格、网络、安全组和可用区的资源 UUID。系统盘存储独立于镜像副本;系统盘容量可指定,数据盘通过 data_disks 数组动态添加。

创建请求

下面是请求体结构示意,所有占位值需替换为实际授权资源。镜像开启初始化时,密码从服务端安全输入取得,或使用同租户 SSH 密钥。

{
  "name": "lab-demo",
  "hostname": "lab-demo",
  "tenant_id": "<目标租户 UUID>",
  "availability_zone_id": "<可用区 UUID>",
  "image_id": "<镜像 UUID>",
  "flavor_id": "<规格 UUID>",
  "network_mode": "vpc",
  "network_id": "<子网 UUID>",
  "security_group_id": "<安全组 UUID>",
  "system_disk_gib": 40,
  "ssh_key_ids": ["<SSH 公钥 UUID>"],
  "data_disks": [{"storage_id": "<数据盘存储 UUID>", "size_gib": 100, "delete_with_instance": true}]
}

向 POST /api/v1/instances 发送请求并保留任务 UUID 与资源 UUID。响应 data.id 是任务身份,不要当作实例 UUID;资源身份读取 data.resource_id。

验证交付

等待任务成功后再查询实例,检查电源、IP 和初始化结果。需要公网访问的私有网络实例还需完成 EIP 发布及安全组放行。

创建、改配、重装和备份可能已有部分底层变化,失败时查询原任务,不重新创建同名实例作为“重试”。完整参数见实例接口。

配置限速

通过资源限速接口配置实例主网卡、EIP 或云硬盘。每次请求替换该资源的限速设置。需要保留的值应一并提交,省略字段或传 null 会取消对应限制。网卡和 EIP 使用上行、下行的 Kbps 值,云硬盘使用 IOPS 与字节每秒。

实例网卡、EIP 与已挂载云硬盘的响应包含操作任务,轮询任务结果后再核对资源。处于可用状态的未挂载云硬盘直接返回更新后的资源。

本页目录