创建虚拟私有云

场景描述

本节介绍创建VPC。

通过IAM服务获取到的Token有效期为24小时，需要使用同一个Token鉴权时，可以先将Token缓存，避免频繁调用。

涉及API

使用Token认证方式完成认证鉴权时，需要获取Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。

• IAM获取token的API
• VPC创建的API

参数说明及响应详细信息参考《虚拟私有云API参考》“创建VPC”章节。

具体步骤

1. Token认证，具体操作请参考Token认证。
2. 发送“POST https://VPC的Endpoint/ v1/{project_id}/vpcs”。其中，project_id为项目ID。
3. 在Request Header中增加“X-Auth-Token”。
4. 在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的获取及企业项目特性的详细信息，请参见《企业管理用户指南》。

5. 请求响应成功后，响应参数如下：

   {
    "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": []
        }
   }

6. 请求异常返回值说明请参考错误码。
7. 响应参数中的id即为VPC的id，根据vpc_id和project_id可以查询、更新、删除VPC。

使用限制

• 一个用户只能创建5个虚拟私有云，如果您有更大需求可以提交工单。
• 一个虚拟私有云中最多拥有100条路由。
• 一个路由表里最多拥有100条路由