创建虚拟私有云
场景描述
本节介绍创建VPC。

通过IAM服务获取到的Token有效期为24小时,需要使用同一个Token鉴权时,可以先将Token缓存,避免频繁调用。
涉及API
使用Token认证方式完成认证鉴权时,需要获取Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。
- IAM获取token的API
- VPC创建的API

参数说明及响应详细信息参考《虚拟私有云API参考》“创建VPC”章节。
具体步骤
- Token认证,具体操作请参考Token认证。
- 发送“POST https://VPC的Endpoint/ v1/{project_id}/vpcs”。其中,project_id为项目ID。
- 在Request Header中增加“X-Auth-Token”。
- 在Request Body中传入参数,样例如下:
POST https://{Endpoint}/v1/{project_id}/vpcs { "vpc": { "name": "vpc", "description": "test", "cidr": "192.168.0.0/16", "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2" } }
- vpc字段说明:
表1 vpc对象 名称
是否必选
参数类型
说明
name
否
String
- 功能说明:虚拟私有云名称
- 取值范围:0-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)
- 约束:如果名称不为空,则同一个租户下的名称不能重复
description
否
String
- 功能说明:虚拟私有云的描述
- 取值范围:0-255个字符,不能包含“<”和“>”。
cidr
否
String
- 功能说明:虚拟私有云下可用子网的范围
- 取值范围:
- 10.0.0.0/8~10.255.255.240/28
- 172.16.0.0/12 ~ 172.31.255.240/28
- 192.168.0.0/16 ~ 192.168.255.240/28
- 不指定cidr时,默认值为空
- 约束:必须是cidr格式,例如:192.168.0.0/16
enterprise_project_id
否
String
- 功能说明:企业项目ID。创建虚拟私有云时,给虚拟私有云绑定企业项目ID。
- 取值范围:最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。“0”表示默认企业项目。
说明:关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理用户指南》。
- vpc字段说明:
- 请求响应成功后,响应参数如下:
{ "vpc": { "id": "99d9d709-8478-4b46-9f3f-2206b1023fd3", "name": "vpc", "description": "test", "cidr": "192.168.0.0/16", "status": "CREATING", "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "routes": [] } }
- 请求异常返回值说明请参考错误码。
- 响应参数中的id即为VPC的id,根据vpc_id和project_id可以查询、更新、删除VPC。
使用限制
- 一个用户只能创建5个虚拟私有云,如果您有更大需求可以提交工单。
- 一个虚拟私有云中最多拥有100条路由。
- 一个路由表里最多拥有100条路由
相关文档
相关产品
