功能介绍
创建虚拟私有云。
请求消息
- 请求参数
表2 请求参数 名称
是否必选
参数类型
说明
vpc
是
Object
表3 vpc对象 名称
是否必选
参数类型
说明
name
否
String
- 功能说明:虚拟私有云名称
- 取值范围:0-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)
- 约束:如果名称不为空,则同一个租户下的名称不能重复
description
否
String
- 功能说明:虚拟私有云的描述
- 取值范围:0-255个字符,不能包含“<”和“>”。
cidr
否
String
- 功能说明:虚拟私有云下可用子网的范围
- 取值范围:
- 10.0.0.0/8~24
- 172.16.0.0/12~24
- 192.168.0.0/16~24
- 不指定cidr时,默认值为空
- 约束:必须是cidr格式,例如:192.168.0.0/16
enterprise_project_id
否
String
- 功能说明:企业项目ID。创建虚拟私有云时,给虚拟私有云绑定企业项目ID。
- 取值范围:最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。“0”表示默认企业项目。
说明:关于企业项目ID的获取及企业项目特性的详细信息,请参见《企业管理用户指南》。
- 请求样例
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" } }
响应消息
- 响应参数
表4 响应参数 名称
参数类型
说明
vpc
Object
表5 vpc对象 名称
参数类型
说明
id
String
uuid形式的一个资源标识。
name
String
- 功能说明:虚拟私有云名称
- 取值范围:0-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)
- 约束:如果名称不为空,则同一个租户下的名称不能重复
description
String
- 功能说明:虚拟私有云描述
- 取值范围:0-255个字符,不能包含“<”和“>”。
cidr
String
- 功能说明:虚拟私有云下可用子网的范围
- 取值范围:
- 10.0.0.0/8~24
- 172.16.0.0/12~24
- 192.168.0.0/16~24
- 不指定cidr时,默认值为空
- 约束:必须是cidr格式,例如:192.168.0.0/16
status
String
- 功能说明:虚拟私有云的状态
- 取值范围:
- CREATING:创建中。
- OK:创建成功。
routes
Array of route objects
- 功能说明:路由信息列表
- 约束:详情参见route对象。
enterprise_project_id
String
- 功能说明:企业项目ID。
- 取值范围:最大长度36字节,带“-”连字符的UUID格式,或者是字符串“0”。“0”表示默认企业项目。
- 响应样例
{ "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": [] } }
状态码
请参见状态码。
错误码
请参见错误码。