创建边界安全云服务器
创建边界安全云服务器
1. 描述
创建边界安全云服务器
2. 请求地址
请求地址的格式如下：
https://<区域服务地址>/v1/ess/create
3. 请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| projectId | String | 是 | 所属项目ID |
| name | String | 是 | 主机名称 |
| feeType | String | 是 | 计费类型(按需计费:FEE_TYPE_NEED,包年包月:FEE_TYPE_MONTH_YEAR) |
| subnetId | String | 是 | 子网ID |
| securityGroupId | String | 是 | 安全组ID |
| imageId | String | 是 | 镜像ID |
| flavorId | String | 是 | FlavorID |
| sysDiskType | String | 是 | 系统盘类型(SSD,HDD) |
| sysDiskCapacity | int | 是 | 系统盘大小(GB)，系统盘大小的配置介于100到5000之间，且必须为10的整数倍 |
| cycleCount | int | 否 | 计费类型是包年包月时必填，购买月数(1,2,3,4,5,6,7,8,9,12,24,36)个月 |
4. 请求示例
以创建华东一区某子网下名字为"test"的计费类型为按需计费的边界安全云服务器为例：
4.1. 请求地址
POST https://cn-east-1.api.yovole.com/v1/ess/create HTTP/1.1
x-ycs-timestamp: 2022-10-10T14:26:26Z
x-ycs-requestid: 2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9
x-ycs-security-authorization: Authorization: YCS1-HMAC-SHA1 Credential=08e206fb-7b41-45b7-8076-8d43e8aeea89,SignedHeaders=content-type;x-ycs-requestid;x-ycs-timestamp,Signature=2RFjU7C9gICCrQfpAIfAJHqRRlQ=
4.2. 接口请求参数
{
"projectId":"8a83a0966a681da5016a874df50b10ce",
"name":"test",
"feeType":"FEE_TYPE_NEED",
"subnetId":"98e6bf98-3283-4bed-80c8-2132a510aebb",
"securityGroupId":"eb667f7f-a0d4-4cc5-908a-e4175c683030",
"imageId":"SANGFOR-1",
"flavorId":"ess.c1.small",
"sysDiskType":"HDD",
"sysDiskCapacity": 200
}
5. 返回结果示例
5.1. 返回正确结果示例
{
"requestId": "2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9",
"success": true,
"code": 200,
"message": null,
"model": null
}
5.2. 返回错误结果示例
{
"requestId": "2a49cfa2-925b-11e9-bb3a-6c96cfdcd6b9",
"success": false,
"code": 400,
"message": "Required attribute 'projectId' not specified",
"errorCode": "Invalid argument"
}
6. 错误码
可以通过错误返回结果中的code、errorCode和message字段了解错误分类和具体的错误原因。
该接口没有特殊错误码，错误码信息和简单的错误分析方法可以参考公共错误码。