中国站

产品

硅云帮助文档中心

搜索文档

热门搜索词:

创建实例

更新时间:2020-05-21 16:47  版本:v1.0
分享到:
我要反馈 
收藏 我的收藏

简要描述:


    创建实例,此接口会自动从用户余额中扣除创建实例所需的费用


请求url:


/vhost-server/api/v1/host/create


请求方式:


POST


请求参数:


字段
类型最大长度参数位置默认必填
描述
productIdstring32RequestBody
产品规格id
hostPassstring
RequestBody
需要加密,加密规则参考通用说明,密码规则:4到14个数字和英文字母组合,数字字母需要同时存在
month
int10RequestBody
购买月份数,一年传12
idempotentstring64RequestBody选填幂等Id,防止创建成功但超时的情况,当传递相同的idempotent时,无论调用多少次,只会创建成功一次,建议传递uuid,和续费,升级操作不隔离



请求示例:


POST /vhost-server/api/v1/host/create HTTP/1.1
Content-Type: application/json
request_id: 2942183558593ffc9d75fb8e16793ff
api_key: 1706006863049654272
signature: c11864d797c86d658a225f9276c08089caa1a463cafc2baf93c30b808e7af4b9
Content-Type: application/json

{
	"productId":"hk-ph1x",
	"hostPass":"7qzmggdAVU9RZzKuEv2Qrw==",
	"month":1,
	"idempotent":"123"
}


返回示例:


data返回虚拟主机实例,实际以真实返回结果为准


{
    "status": 2000,
    "message": "success",
    "data": {
        "userAccount": "z8z87878",
        "productName": "香港普惠一型",
        "resourceId": "hk-node1",
        "resourceName": "香港节点一",
        "hostType": "hk-ph",
        "hostTypeName": "香港普惠型",
        "productId": "hk-ph1x",
        "areaName": "香港一区",
        "areaMark": "hk-1",
        "beginTime": 1589352288000,
        "endTime": 1594622688000,
        "status": "OK",
        "hostName": "cvh-3hdr7uz22s223",
        "latestOrderId": "1706556457795452929",
        "ipList": "192.168.32.2",
        "ipV6": "",
        "cnDomain": "test.cn.name",
        "autoRenew": false,
        "systemInfo": "Linux-PHP版",
        "supportNoReasonRefund": false,
        "refundStatus": "NONE",
        "configuration": "",
        "createTime": 1589352289658,
        "updateTime": 1589356803423,
        "id": "cvh-3hdr7uz22s223"
    }
}


实例数据结构:


字段类型
描述
idstring实例id
userAccount
string用户名
status
string实例状态
ipListstringip
cnDomain
string别名







您对该文档有什么建议?

您对该文档的评分:

本文导航

简要描述:

请求url:

请求方式:

请求参数:

请求示例:

返回示例:

搜索文档