lightnode
cn
  • cn
  • en
  1. 主机
lightnode
cn
  • cn
  • en
  • API概览
  • API调用说明
  • 主机
    • 创建
      POST
    • 释放
      POST
    • 关机
      POST
    • 开机
      POST
    • 重启
      POST
    • 修改密码
      POST
    • 主机详情
      GET
    • 重装
      POST
  • 安全组
    • 安全组查询
      GET
  • 镜像
    • 镜像查询
      GET
  • 异步任务
    • 查询异步任务
      GET
  • 密钥对
    • 密钥对查询
      GET
  1. 主机

创建

POST
https://openapi.lightnode.com/instance/create

接口介绍#

创建一台或多台云服务器。#

创建云服务器的接口在验证用户口令,并且账号状态正常的情况下,可以直接部署机器。#

本接口为异步接口,当前创建云服务器请求下发成功后会返回异步任务asyncTaskUUID,此时创建云服务器并没有立即完成,需要通过调用查询异步任务接口去查询processResult状态,当调用查询异步任务接口processResult状态为SUCCESS时代表云服务器创建成功。#

弹性云服务器的登录鉴权方式包括两种:密钥对、密码。指使用密钥对作为弹性云服务器的鉴权方式。#

接口调用方法:使用sshKeyUUID字段,指定弹性云服务器登录时使用的密钥文件,sshKeyUUID字段的使用方法。#

密码指使用设置初始密码方式作为弹性云服务器的鉴权方式,此时,您可以通过用户名密码方式登录弹性云服务器,Linux操作系统时为root用户的初始密码,Windows操作系统时为Administrator用户的初始密码。#

密码规则:#

长度8-30位
包含[A-z], [a-z], [0-9]
必须包含以下特殊字符之一:()`~!@#$*-+={}[]:;,.?/

主机名称需符合:#

最大长度64字符
只包含大小写字母、数字和连字符(-)中的字符

注意,允许使用的packageCode请联系官方获取。#

Request

Header Params

Body Params application/json

Example
{
    "packageConfig": {
        "packageCode": "test",
        "regionCode": "cn-dev-2",
        "zoneCode": "cn-dev-2-a",
        "instanceName": "20250624153241944021",
        "imageResourceUUID": "img-bv00006yzubh",
        "sshKeyUUID": null,
        "firewallUUID": "fw-7100007a1u1s",
        "password": "Pass4422@"
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.lightnode.com/instance/create' \
--header 'x-open-token: test-token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "packageConfig": {
        "packageCode": "test",
        "regionCode": "cn-dev-2",
        "zoneCode": "cn-dev-2-a",
        "instanceName": "20250624153241944021",
        "imageResourceUUID": "img-bv00006yzubh",
        "sshKeyUUID": null,
        "firewallUUID": "fw-7100007a1u1s",
        "password": "Pass4422@"
    }
}'

Responses

🟢202成功
application/json
Body

Examples
{
    "asyncTaskInfo": {
        "asyncTaskUUID": "cm00007dyzds",
        "ecsResourceUUID": "ecs-lg00007dyz7g"
    },
    "httpStatus": 202,
    "rowCount": 0
}
Modified at 2025-09-23 08:45:05
Previous
API调用说明
Next
释放
Built with