更新时间:2022-01-25 GMT+08:00

创建VPC

功能介绍

创建虚拟私有云。

URI

POST /v1/{project_id}/vpcs

参数说明请参见表1
表1 参数说明

名称

是否必选

说明

project_id

项目ID,获取项目ID请参见获取项目ID

请求消息

  • 请求参数
    表2 请求参数

    名称

    是否必选

    参数类型

    说明

    vpc

    Object

    vpc对象

    表3 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
  • 请求样例
    POST https://{Endpoint}/v1/{project_id}/vpcs
    
    {
        "vpc": {
            "name": "vpc",
            "description": "test",
            "cidr": "192.168.0.0/16"
          
        }
    }

响应消息

  • 响应参数
    表4 响应参数

    名称

    参数类型

    说明

    vpc

    Object

    vpc对象

    表5 vpc对象

    名称

    参数类型

    说明

    id

    String

    uuid形式的一个资源标识。

    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

    status

    String

    • 功能说明:虚拟私有云的状态
    • 取值范围:
      • CREATING:创建中。
      • OK:创建成功。
  • 响应样例
    {
     "vpc": 
         {
         "id": "99d9d709-8478-4b46-9f3f-2206b1023fd3",
         "name": "vpc",
         "description": "test",
         "cidr": "192.168.0.0/16",
         "status": "CREATING",
         
         }
    }

状态码

请参见状态码

错误码

请参见错误码