托管开放API文档

API列表

托管主机、站点及安全能力接口在本页说明；CDN 域名配置、缓存刷新和预热接口请参见托管 CDN 开放 API。

POST 购买主机

POST /lve/manage/v1/hosting/buyNow

{
  "name": "香港测试",
  "menu": "hk_hosting1",
  "region": "hk",
  "buyAmount": 1,
  "buyUnit": "M",
  "buyNum": 1,
  "autoRenew": false
}

请求参数 - POST 购买主机

名称	位置	类型	必选	说明
name	body	string	否	托管套餐名称
menu	body	string	是	套餐类型
region	body	string	是	地域，如 `cn-wlcb`、 `hk`
buyAmount	body	integer	是	购买时长
buyUnit	body	string	是	购买时长单位， `Y` 年， `M` 月
buyNum	body	integer	是	购买数量，最大 30
autoRenew	body	boolean	否	是否自动续费

{
  "status": true,
  "code": "200",
  "res": [
    "X69af90dfe4b0cac5287a526d"
  ]
}

返回结果

状态码	状态码含义	说明	数据模型
200	OK	成功	Inline

返回数据结构 - POST 购买主机

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	[string]	true	none	本次直接结算生成的服务编号列表

GET 获取主机列表

GET /lve/manage/v1/hosting/list

请求参数 - GET 获取主机列表

名称	位置	类型	必选	说明
serviceCode	query	string	否	服务编号
remark	query	string	否	备注模糊查询
region	query	string	否	地域过滤

{
  "status": true,
  "code": "200",
  "res": {
    "list": [],
    "total": 0
  }
}

返回数据结构 - GET 获取主机列表

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» list	[object]	true	none	主机列表
»» total	integer	true	none	总数
»»» hostingService	object	false	none	托管服务信息
»»»» agentCode	string	false	none	用户编号
»»»» serviceCode	string	false	none	服务编号
»»»» serviceStatus	string	false	none	服务状态
»»»» machineCode	string	false	none	主机编号
»»»» machineName	string	false	none	主机名称
»»»» machineServiceCode	string	false	none	主机服务编号
»»»» goodsCode	string	false	none	商品编号
»»»» remark	string	false	none	备注
»»»» buyAmount	integer	false	none	购买时长
»»»» buyUnit	string	false	none	购买时长单位
»»»» isYearBill	integer	false	none	是否按年计费，1是
»»»» startTime	string	false	none	开始时间
»»»» endTime	string	false	none	到期时间
»»»» freeTime	integer	false	none	赠送时长，单位月
»»»» activeTimeLimit	string	false	none	开通有效时限
»»»» renewType	string	false	none	续费类型
»»»» renewCycleAmount	integer	false	none	续费周期时长
»»»» renewCycleUnit	string	false	none	续费周期单位
»»»» freeCertIsAvailable	integer	false	none	免费证书是否可用，1可用
»»»» freeCertExpireTime	string	false	none	免费证书到期时间
»»»» createTime	string	false	none	创建时间
»»»» modifyTime	string	false	none	修改时间
»»» region	string	false	none	地域
»»» status	string	false	none	主机状态
»»» instanceCount	integer	false	none	站点实例数
»»» machineTotalSpace	integer	false	none	主机总空间
»»» machineUsedSpace	integer	false	none	主机已用空间
»»» spec	object	false	none	商品规格信息
»»» canUpgrade	integer	false	none	是否可升级，1可升级
»»» upgradeLineOrder	integer	false	none	升级线序号

GET 获取地域选项

GET /lve/manage/v1/hosting/getRegionOptions

请求参数 - GET 获取地域选项

无

返回数据结构 - GET 获取地域选项

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	[object]	true	none	地域选项列表
»» value	string	false	none	地域编码
»» comment	string	false	none	地域名称

GET 获取主机商品配置

GET /lve/manage/v1/hosting/getGoodsSpec

请求参数 - GET 获取主机商品配置

名称	位置	类型	必选	说明
region	query	string	否	地域编码；不传则返回所有地区配置

返回数据结构 - GET 获取主机商品配置

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	[object]	true	none	商品配置列表
»» region	string	false	none	地域标识
»» hostingSpecList	[object]	false	none	该地区下的托管套餐规格列表
»»» hostingSpec	object	false	none	套餐规格信息
»»»» menu	string	false	none	套餐类型/菜单编码
»»»» menuName	string	false	none	套餐名称
»»»» region	string	false	none	地域
»»»» menuConfig	object	false	none	套餐配置
»»» canUpgrade	integer	false	none	是否可升级，1可升级
»»» upgradeLineOrder	integer	false	none	升级线序号

GET 获取可升级商品配置

GET /lve/manage/v1/hosting/getUpgradeableGoodsSpec

请求参数 - GET 获取可升级商品配置

名称	位置	类型	必选	说明
serviceCode	query	string	是	当前托管服务编号

返回数据结构 - GET 获取可升级商品配置

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	[object]	true	none	可升级套餐规格列表
»» menu	string	false	none	套餐类型/菜单编码
»» menuName	string	false	none	套餐名称
»» region	string	false	none	地域
»» menuConfig	object	false	none	套餐配置

POST 获取购买时长及折扣

POST /lve/manage/v1/hosting/getGoodsPrices

{
  "buyAmount": 1,
  "buyUnit": "M",
  "buyNum": 1,
  "menu": "hk_hosting1",
  "region": "hk"
}

请求参数 - POST 获取购买时长及折扣

名称	位置	类型	必选	说明
buyAmount	body	integer	是	购买时长，最小 1
buyUnit	body	string	是	时长单位， `Y` 年、 `M` 月、 `C` 次
buyNum	body	integer	是	购买数量，最小 1
menu	body	string	是	套餐类型
region	body	string	是	地域

返回数据结构 - POST 获取购买时长及折扣

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	[object]	true	none	可购买时长及折扣列表
»» buyAmount	integer	false	none	可选购买时长
»» buyUnit	string	false	none	可选购买时长单位
»» discount	number	false	none	对应折扣

POST 获取续费时长及折扣

POST /lve/manage/v1/hosting/getRenewPrices

{
  "menu": "hk_hosting1",
  "region": "hk"
}

请求参数 - POST 获取续费时长及折扣

名称	位置	类型	必选	说明
menu	body	string	是	套餐类型
region	body	string	是	地域

返回数据结构 - POST 获取续费时长及折扣

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	[object]	true	none	可续费时长及折扣列表
»» buyAmount	integer	false	none	可选续费时长
»» buyUnit	string	false	none	可选续费时长单位
»» discount	number	false	none	对应折扣

POST 购买价格计算

POST /lve/manage/v1/hosting/calculatePrice

[
  {
    "buyAmount": 1,
    "buyUnit": "M",
    "buyNum": 1,
    "menu": "hk_hosting1",
    "region": "hk"
  }
]

请求参数 - POST 购买价格计算

名称	位置	类型	必选	说明
buyAmount	body	integer	是	购买时长，最小 1
buyUnit	body	string	是	时长单位， `Y` 年、 `M` 月、 `C` 次
buyNum	body	integer	是	购买数量，最大 30
menu	body	string	是	套餐类型
region	body	string	是	地域

返回数据结构 - POST 购买价格计算

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态
» code	string	true	none	返回code
» msg	string	false	none	提示信息
» res	[object]	true	none	价格计算结果列表
»» totalPrice	number	false	none	总价
»» originalPrice	number	false	none	原价
»» buyAmount	integer	false	none	购买时长
»» buyUnit	string	false	none	购买时长单位
»» hostingPrice	number	false	none	托管套餐价格
»» hostingOriginalPrice	number	false	none	托管套餐原价
»» hostingDisCount	number	false	none	托管套餐折扣

POST 主机升级

POST /lve/manage/v1/hosting/upgrade/buyNowByRemainingDays

{
  "serviceCode": "X69af90dfe4b0cac5287a526d",
  "buyAmount": 1,
  "buyUnit": "M",
  "targetMenu": "hk_hosting2",
  "targetRegion": "hk"
}

请求参数 - POST 主机升级

名称	位置	类型	必选	说明
serviceCode	body	string	是	原服务编号
buyAmount	body	integer	否	补差购买时长
buyUnit	body	string	否	购买单位
targetMenu	body	string	是	目标套餐类型
targetRegion	body	string	是	目标地域

{
  "status": true,
  "code": "200",
  "res": [
    "X69af90dfe4b0cac5287a526d"
  ]
}

返回数据结构 - POST 主机升级

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	[string]	true	none	升级结算后的服务编号列表

POST 主机续费

POST /lve/manage/v1/hosting/renew/buyNow

{
  "serviceCode": "X69af90dfe4b0cac5287a526d",
  "buyAmount": 1,
  "buyUnit": "M"
}

请求参数 - POST 主机续费

名称	位置	类型	必选	说明
serviceCode	body	string	是	服务编号
buyAmount	body	integer	是	续费时长
buyUnit	body	string	是	续费时长单位， `Y`/`M`

{
  "status": true,
  "code": "200",
  "res": [
    "X69af90dfe4b0cac5287a526d"
  ]
}

返回数据结构 - POST 主机续费

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	[string]	true	none	续费结算后的服务编号列表

POST 主机批量续费

POST /lve/manage/v1/hosting/renew/batchRenew

[
  {
    "serviceCode": "X69af90dfe4b0cac5287a526d",
    "buyAmount": 1,
    "buyUnit": "M"
  }
]

请求参数 - POST 主机批量续费

名称	位置	类型	必选	说明
serviceCode	body	string	是	服务编号
buyAmount	body	integer	是	续费时长
buyUnit	body	string	是	续费时长单位

{
  "status": true,
  "code": "200",
  "res": [
    "X69af90dfe4b0cac5287a526d",
    "X69af90dfe4b0cac5287a526e"
  ]
}

返回数据结构 - POST 主机批量续费

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	[string]	true	none	批量续费结算后的服务编号列表

GET 导出站点列表

GET /lve/manage/v1/site/export

请求参数 - GET 导出站点列表

名称	位置	类型	必选	说明
serviceCode	query	string	否	服务编号
machineCode	query	string	否	托管主机编号
keyword	query	string	否	关键字

POST 创建站点

POST /lve/manage/v1/site/create

{
  "serviceCode": "X69af90dfe4b0cac5287a526d",
  "sites": [
    {
      "siteName": "demo.com",
      "spaceSize": 1024,
      "expireTime": "2026-12-31 23:59:59",
      "remark": "测试站点"
    }
  ]
}

请求参数 - POST 创建站点

名称	位置	类型	必选	说明
serviceCode	body	string	是	托管套餐服务编号
sites	body	[object]	是	待创建站点列表
» siteName	body	string	是	站点名
» spaceSize	body	integer	否	空间大小
» expireTime	body	string	否	到期时间，格式 `yyyy-MM-dd HH:mm:ss`
» remark	body	string	否	备注

{
  "status": true,
  "code": "200",
  "res": {
    "instanceNames": [
      "app7351891933"
    ]
  }
}

返回数据结构 - POST 创建站点

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» instanceNames	[string]	true	none	创建成功的站点实例名列表

POST 通过Excel创建站点

POST /lve/manage/v1/site/createByExcel

Content-Type: multipart/form-data

请求参数 - POST 通过Excel创建站点

名称	位置	类型	必选	说明
file	formData	file	是	Excel 文件，支持 `.xlsx`/`.xls`
serviceCode	formData	string	是	托管套餐服务编号

返回数据结构 - POST 通过Excel创建站点

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» instanceNames	[string]	true	none	创建成功的站点实例名列表

POST 获取可管理站点列表

POST /hcp/site/v1/list

该接口用于获取当前账号可管理的站点及 instanceCode ，供 CDN、WAF 等站点能力接口使用。独享主机、共享站点和静态站点使用同一个列表入口。

不传请求体或传 {} 时，默认查询第 1 页，每页 20 条。

{
  "pageNum": 1,
  "pageSize": 20,
  "keyword": "app1234567890",
  "siteProductType": "SHARED_SITE"
}

请求参数 - POST 获取可管理站点列表

名称	位置	类型	必选	说明
pageNum	body	integer	否	页码，范围 1-10000，默认 1
pageSize	body	integer	否	每页条数，范围 1-100，默认 20
keyword	body	string	否	站点名模糊匹配，或 instanceCode 精确匹配；最多 128 个字符
siteProductType	body	string	否	站点类型： `EXCLUSIVE_HOST`、 `SHARED_SITE`、 `STATIC_SITE`

{
  "status": true,
  "code": "200",
  "res": {
    "total": 1,
    "elements": [
      {
        "instanceCode": "0123456789abcdef0123456789abcdef",
        "instanceName": "app1234567890",
        "instanceStatus": "RUNNING",
        "siteProductType": "SHARED_SITE"
      }
    ],
    "page": 1,
    "size": 20
  }
}

返回数据结构 - POST 获取可管理站点列表

状态码 200

名称	类型	必选	说明
» status	boolean	true	请求状态， `true` 成功、 `false` 失败
» code	string	true	业务状态码
» msg	string	false	提示信息
» res	object	true	分页结果
»» total	integer	true	总记录数
»» elements	[object]	true	当前页站点列表
»»» instanceCode	string	true	站点实例编码，调用 CDN、WAF 等接口时使用
»»» instanceName	string	true	站点实例名
»»» instanceStatus	string	false	站点状态
»»» siteProductType	string	true	站点类型
»» page	integer	true	当前页码
»» size	integer	true	每页条数

该接口仅返回当前账号直接归属、服务状态正常且未删除的站点。它用于跨功能的资源发现，不表示站点已经开通 CDN 或 WAF；取得 instanceCode 后，应调用相应功能的域名列表确认可用资源。CDN 后续调用参见托管 CDN 开放 API。

下面的 /lve/manage/v1/site/list 是原有独享托管站点详情接口，返回站点配置等更多信息。需要为 CDN、WAF 等功能获取统一站点编码时，建议使用本节接口。

POST 获取站点列表（独享托管详情）

POST /lve/manage/v1/site/list

{
  "serviceCode": "X69af90dfe4b0cac5287a526d",
  "keyword": "demo",
  "pageNum": 1,
  "pageSize": 10
}

请求参数 - POST 获取站点列表（独享托管详情）

名称	位置	类型	必选	说明
serviceCode	body	string	否	服务编号
keyword	body	string	否	关键字
pageNum	body	integer	否	页码，默认 1
pageSize	body	integer	否	每页大小，默认 10

返回数据结构 - POST 获取站点列表（独享托管详情）

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	分页结果
»» total	integer	false	none	总记录数
»» pageNum	integer	false	none	当前页码
»» pageSize	integer	false	none	每页条数
»» list	[object]	false	none	站点列表
»»» id	integer	false	none	主键ID
»»» instanceCode	string	false	none	实例编码
»»» instanceName	string	false	none	实例名
»»» siteName	string	false	none	站点名
»»» remark	string	false	none	备注
»»» instanceType	string	false	none	实例类型
»»» instanceStatus	string	false	none	实例状态编码
»»» instanceStatusDesc	string	false	none	实例状态描述
»»» virtualMachineCode	string	false	none	所属托管主机编码
»»» createTime	string	false	none	创建时间
»»» expireTime	string	false	none	到期时间
»»» modifyTime	string	false	none	修改时间
»»» vhostInfo	object	false	none	站点配置信息
»»»» instanceName	string	false	none	实例名称
»»»» cname	string	false	none	站点 CNAME
»»»» mainDomain	string	false	none	主域名
»»»» spaceQuota	integer	false	none	空间配额
»»»» maxBandwidth	integer	false	none	最大带宽
»»»» maxConnections	integer	false	none	最大连接数
»»»» domainLimit	integer	false	none	域名数量限制
»»»» domains	[string]	false	none	绑定域名集合
»»»» httpsDomains	[string]	false	none	HTTPS 域名集合
»»»» ftpSwitch	string	false	none	FTP 开关
»»»» httpSwitch	string	false	none	HTTP 开关
»»»» phpSwitch	string	false	none	PHP 开关
»»»» phpVersion	string	false	none	PHP 版本
»»»» language	string	false	none	运行语言
»»»» languageVersion	string	false	none	语言版本
»»»» indexPath	string	false	none	默认首页
»»»» errorPage	string	false	none	404 错误页
»»»» mainSitePath	string	false	none	站点根目录
»»»» customSshAddress	string	false	none	自定义 SSH/SFTP 地址
»»»» sftpOnlySwitch	string	false	none	是否仅开启 SFTP
»»»» createTime	string	false	none	配置创建时间
»»»» modifyTime	string	false	none	配置修改时间
»»»» expireTime	string	false	none	站点到期时间
»»»» remark	string	false	none	备注

POST 获取站点列表（全量）

POST /lve/manage/v1/site/listAll

{
  "serviceCode": "X69af90dfe4b0cac5287a526d",
  "machineCode": "vm-001",
  "keyword": "demo"
}

请求参数 - POST 获取站点列表（全量）

名称	位置	类型	必选	说明
serviceCode	body	string	否	服务编号
machineCode	body	string	否	托管主机编号
keyword	body	string	否	关键字

返回数据结构 - POST 获取站点列表（全量）

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	[object]	true	none	站点列表
»» id	integer	false	none	主键ID
»» instanceCode	string	false	none	实例编码
»» instanceName	string	false	none	实例名
»» siteName	string	false	none	站点名
»» remark	string	false	none	备注
»» instanceType	string	false	none	实例类型
»» instanceStatus	string	false	none	实例状态编码
»» instanceStatusDesc	string	false	none	实例状态描述
»» virtualMachineCode	string	false	none	所属托管主机编码
»» createTime	string	false	none	创建时间
»» expireTime	string	false	none	到期时间
»» modifyTime	string	false	none	修改时间
»» vhostInfo	object	false	none	站点配置信息
»»» instanceName	string	false	none	实例名称
»»» cname	string	false	none	站点 CNAME
»»» mainDomain	string	false	none	主域名
»»» spaceQuota	integer	false	none	空间配额
»»» maxBandwidth	integer	false	none	最大带宽
»»» maxConnections	integer	false	none	最大连接数
»»» domainLimit	integer	false	none	域名数量限制
»»» domains	[string]	false	none	绑定域名集合
»»» httpsDomains	[string]	false	none	HTTPS 域名集合
»»» ftpSwitch	string	false	none	FTP 开关
»»» httpSwitch	string	false	none	HTTP 开关
»»» phpSwitch	string	false	none	PHP 开关
»»» phpVersion	string	false	none	PHP 版本
»»» language	string	false	none	运行语言
»»» languageVersion	string	false	none	语言版本
»»» indexPath	string	false	none	默认首页
»»» errorPage	string	false	none	404 错误页
»»» mainSitePath	string	false	none	站点根目录
»»» customSshAddress	string	false	none	自定义 SSH/SFTP 地址
»»» sftpOnlySwitch	string	false	none	是否仅开启 SFTP
»»» createTime	string	false	none	配置创建时间
»»» modifyTime	string	false	none	配置修改时间
»»» expireTime	string	false	none	站点到期时间
»»» remark	string	false	none	备注

POST 获取WAF拦截记录

POST /lve/manage/v1/security/wafAttackDetailListInfo

{
  "domainCode": "waf-domain-001",
  "beginTime": 1713283200,
  "endTime": 1713369600,
  "actionType": ["BLOCK"],
  "attackType": ["SQLI"],
  "riskRank": ["high"],
  "srcIp": "1.1.1.1",
  "wafMode": "ACTIVE"
}

请求参数 - POST 获取WAF拦截记录

名称	位置	类型	必选	说明
domainCode	body	string	是	WAF 域名编号
beginTime	body	integer	否	开始时间，Unix 时间戳
endTime	body	integer	否	结束时间，Unix 时间戳
actionType	body	[string]	否	动作类型
attackType	body	[string]	否	攻击类型
riskRank	body	[string]	否	风险等级
srcIp	body	string	否	来源 IP
wafMode	body	string	否	WAF 模式

返回数据结构 - POST 获取WAF拦截记录

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	WAF 攻击详情结果
»» DetailList	[object]	false	none	攻击明细列表
»» TotalCount	integer	false	none	总记录数
»»» TimeStamp	integer	false	none	时间戳
»»» Count	integer	false	none	该时间点攻击次数
»»» Client	string	false	none	源 IP
»»» DestIp	string	false	none	目标 IP
»»» ClientIPInfo	object	false	none	源 IP 地理信息
»»»» CountryName	string	false	none	国家
»»»» RegionName	string	false	none	地区/省份
»»»» CityName	string	false	none	城市
»»»» Latitude	string	false	none	纬度
»»»» Longitude	string	false	none	经度
»»»» Timezone	string	false	none	时区
»»»» OwnerDomain	string	false	none	所属域

POST 获取恶意文件列表

POST /lve/manage/v1/security/riskScan/list

{
  "instanceCode": "app7351891933",
  "machineCode": "vm-001",
  "status": "UNPROCESSED",
  "startDate": "2026-04-01",
  "endDate": "2026-04-17",
  "current": 1,
  "size": 10
}

请求参数 - POST 获取恶意文件列表

名称	位置	类型	必选	说明
instanceCode	body	string	否	站点实例编码
machineCode	body	string	否	托管主机编号
status	body	string	否	扫描状态： `UNPROCESSED`、 `DELETED`、 `WHITE_RESTORE`
startDate	body	string	否	开始日期，格式 `yyyy-MM-dd`
endDate	body	string	否	结束日期，格式 `yyyy-MM-dd`
current	body	integer	否	当前页，默认 1
size	body	integer	否	每页大小，默认 10，最大 100

返回数据结构 - POST 获取恶意文件列表

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	分页结果
»» current	integer	false	none	当前页
»» size	integer	false	none	每页大小
»» total	integer	false	none	总记录数
»» records	[object]	false	none	恶意文件记录列表
»»» id	integer	false	none	主键ID
»»» scanCode	string	false	none	扫描编号
»»» agentCode	string	false	none	用户编号
»»» fileName	string	false	none	文件名
»»» isolationFileName	string	false	none	隔离区文件名
»»» instanceCode	string	false	none	实例编号
»»» machineCode	string	false	none	托管主机编号
»»» instanceName	string	false	none	实例名称
»»» machineName	string	false	none	托管主机名称
»»» riskType	string	false	none	风险类型
»»» status	string	false	none	状态编码
»»» statusDesc	string	false	none	状态描述
»»» createTime	string	false	none	创建时间
»»» modifyTime	string	false	none	修改时间

POST 创建网站搬家任务

POST /lve/manage/v1/siteMove/create

{
  "tasks": [
    {
      "instanceCode": "app7351891933",
      "remark": "站点搬家",
      "ftpInfo": {
        "ftpServer": "1.1.1.1",
        "port": 21,
        "ftpUser": "root",
        "ftpPass": "123456",
        "srcPath": "/www/wwwroot/demo",
        "targetPath": "/www/wwwroot/demo"
      }
    }
  ]
}

请求参数 - POST 创建网站搬家任务

名称	位置	类型	必选	说明
tasks	body	[object]	是	搬家任务列表，最大 20 条
» instanceCode	body	string	否	站点实例编码，与 `instanceName` 二选一
» instanceName	body	string	否	站点实例名，与 `instanceCode` 二选一
» remark	body	string	否	备注
» ftpInfo	body	object	是	FTP 信息
»» ftpServer	body	string	是	FTP 服务器地址
»» port	body	integer	否	端口
»» ftpUser	body	string	是	FTP 用户名
»» ftpPass	body	string	是	FTP 密码
»» srcPath	body	string	否	源路径
»» targetPath	body	string	否	目标路径，不能包含 `..`
»» ignoreName	body	[string]	否	忽略文件名列表

{
  "status": true,
  "code": "200",
  "msg": "创建站点搬家任务成功",
  "res": {
    "taskCodes": [
      "sm202604170001"
    ],
    "total": 1
  }
}

返回数据结构 - POST 创建网站搬家任务

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» taskCodes	[string]	true	none	创建成功的搬家任务编号列表
»» total	integer	true	none	创建成功任务数

POST 通过Excel创建网站搬家任务

POST /lve/manage/v1/siteMove/createByExcel

Content-Type: multipart/form-data

请求参数 - POST 通过Excel创建网站搬家任务

名称	位置	类型	必选	说明
file	formData	file	是	Excel 文件，支持 `.xlsx`/`.xls`

返回数据结构 - POST 通过Excel创建网站搬家任务

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	返回参数
»» taskCodes	[string]	true	none	创建成功的搬家任务编号列表
»» total	integer	true	none	创建成功任务数

POST 获取搬家任务列表

POST /lve/manage/v1/siteMove/list//

{
  "taskCode": "sm202604170001"
}

请求参数 - POST 获取搬家任务列表

名称	位置	类型	必选	说明
pageIndex	path	integer	是	页码
pageSize	path	integer	是	每页大小
remark	query	string	否	备注模糊查询
taskCode	body	string	否	任务编号过滤

返回数据结构 - POST 获取搬家任务列表

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	object	true	none	分页结果
»» total	integer	false	none	总记录数
»» page	integer	false	none	总页数
»» size	integer	false	none	每页大小
»» current	integer	false	none	当前页
»» elements	[object]	false	none	搬家任务列表
»»» taskCode	string	false	none	任务编号
»»» taskName	string	false	none	任务名称
»»» instanceCode	string	false	none	目标站点实例编码
»»» instanceName	string	false	none	目标实例名称
»»» targetHost	string	false	none	目标主机
»»» siteName	string	false	none	目标站点域名/站点名
»»» sourceFtpAddress	string	false	none	源FTP地址
»»» sourceFtpPort	integer	false	none	源FTP端口
»»» sourceFtpUser	string	false	none	源FTP用户名
»»» ftpDownloadDir	string	false	none	FTP下载目录
»»» storagePath	string	false	none	目标存放路径
»»» status	string	false	none	任务状态
»»» remark	string	false	none	备注
»»» cloneInfo	object	false	none	搬家进度信息
»»»» copiedBytes	integer	false	none	已复制字节数
»»»» copiedFolders	integer	false	none	已复制目录数
»»»» copiedFiles	integer	false	none	已复制文件数
»»»» status	string	false	none	克隆任务状态
»»»» info	string	false	none	任务说明
»»»» failed	[string]	false	none	失败文件列表
»»»» processing	string	false	none	当前处理进度描述
»»»» startTime	string	false	none	开始时间
»»»» modifyTime	string	false	none	最近更新时间
»»»» bucketName	string	false	none	临时存储桶名称
»»»» objectName	string	false	none	对象存储文件名

POST 重置站点SSH/SFTP密码

POST /lve/manage/v1/panel/resetSitePassword

{
  "instanceCode": "app7351891933",
  "password": "NewPassword123!"
}

请求参数 - POST 重置站点SSH/SFTP密码

名称	位置	类型	必选	说明
instanceCode	body	string	是	站点实例编码
password	body	string	是	新密码明文，建议使用 12 位强密码，至少包含 1 个字母、1 个数字、1 个特殊字符；允许字符为字母、数字 `2-9` 和特殊字符 `@$!%*?&#.` ，不包含易混淆字符 `I`、 `O`、 `l`、 `0`、 `1`

{
  "status": true,
  "code": "200",
  "res": true
}

返回数据结构 - POST 重置站点SSH/SFTP密码

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	boolean	true	none	重置结果， `true` 表示成功

POST 更新站点控制面板密码

POST /lve/manage/v1/panel/resetLoginPassword

{
  "instanceCode": "app7351891933",
  "password": "NewPassword123!"
}

请求参数 - POST 更新站点控制面板密码

名称	位置	类型	必选	说明
instanceCode	body	string	是	站点实例编码
password	body	string	是	新的控制面板登录密码，长度 8-20 位，只能包含字母、数字以及 `@$!%*?&#.` ，且至少包含其中两种类型；不能与登录名相同

{
  "status": true,
  "code": "200",
  "res": true
}

返回数据结构 - POST 更新站点控制面板密码

状态码 200

名称	类型	必选	约束	说明
» status	boolean	true	none	请求状态 true成功 false失败
» code	string	true	none	返回code 200成功 400失败
» msg	string	false	none	提示信息
» res	boolean	true	none	更新结果， `true` 表示成功

Last modified: 20 September 2026