创建子网
创建子网
1. 描述
创建子网
2. 请求地址
请求地址的格式如下：
https://<区域服务地址>/v1/subnet/create
3. 请求参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| projectId | String | 是 | 所属项目ID |
| name | String | 是 | 子网名称 |
| vpcId | String | 是 | vpcId或vpcSn两者必须指定一个 |
| vpcSn | String | 是 | vpcId或vpcSn两者必须指定一个 |
| azSn | String | 是 | 所属az |
| cidr | String | 是 | 取值范围: 所选vpc的cidr范围内，并且和该vpc下其它子网不重叠，位数限制为16-28 |
| gateway | String | 否 | 网关 |
| dnsServer1 | String | 否 | DNS1 |
| dnsServer2 | String | 否 | DNS2 |
4. 请求示例
以创建华东一区某VPC下名字为"test"的子网为例：
4.1. 请求地址
POST https://cn-east-1.api.yovole.com/v1/subnet/create HTTP/1.1
x-ycs-timestamp: 2019-06-19T14: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":"8a83a0906b692378016b6d5ec5f40250",
"name":"测试子网",
"vpcId": "acc230b7-d36f-11e8-88a8-fa16387445212",
"azSn": "CN-EAST-1-A",
"cidr": "172.20.4.0/22",
"gateway": "172.20.4.1",
"dnsServer1": "8.8.8.8",
"dnsServer2": "114.114.114.114"
}
5. 返回结果
5.1. 返回正确结果示例
{
"requestId": "5baa5046-7758-49fd-b617-2c4ace1be375",
"success": true,
"code": 200,
"message": null,
"model": null
}
5.2. 返回错误结果示例
{
"requestId": "19c0e7ff-5554-4e90-b3a5-3aab644a8e30",
"success": false,
"code": 401,
"message": "client enabled is false",
"errorCode": "InvalidUserAccount"
}
6. 错误码
可以通过错误返回结果中的code、errorCode和message字段了解错误分类和具体的错误原因。
该接口没有特殊错误码，错误码信息和简单的错误分析方法可以参考公共错误码。