示例一：创建云服务器所需要的vpc和子网-九游平台

操作场景

本章节指导用户通过调用api来创建云服务器所需要的vpc和子网。

前提条件

您需要规划vpc所在的区域信息，并根据区域确定调用api的endpoint，详细信息请参见。

当您使用token认证方式完成认证鉴权时，需要获取用户token并在调用接口时增加“x-auth-token”到业务接口请求消息头中。token认证，具体操作请参考。

操作步骤

1. 创建vpc。
   1. 发送“post https://vpc的endpoint/v1/{project_id}/vpcs”，project_id为项目id。
   2. 在request header中增加“x-auth-token”。
   3. 在request body中传入参数如下，其中cidr字段需要提前进行网络规划。

      {
          "vpc": {
              "name": "vpc", //虚拟私有云名称
              "cidr": "192.168.0.0/16" //虚拟私有云下可用子网的范围
          }
      }

   4. 查看请求响应结果。
      • 请求成功时，响应参数如下，id就是vpc_id。

        {
            "vpc": {
                "id": "b6684a27-b049-407d-90b4-c9551f2390e1",
                "name": "vpc",
                "cidr": "192.168.0.0/16",
                "status": "creating",
                "routes": []
            }
        }

      • 请求异常时，错误码请参见错误码。

2. 查询vpc详情。
   1. 发送“get https://vpc的endpoint/v1/{project_id}/vpcs/{vpc_id}”，project_id为项目id。
   2. 在request header中增加“x-auth-token”。
   3. 查看请求响应结果。
      • 请求成功时，响应参数如下，id就是vpc_id。

        {
            "vpc": {
                "id": "b6684a27-b049-407d-90b4-c9551f2390e1",
                "name": "vpc",
                "description": "",
                "cidr": "192.168.0.0/16",
                "status": "ok",
                "enterprise_project_id": "0" ,
                "routes": []
            }
        }

      • 请求异常时，错误码请参见错误码。
3. 指定vpc创建子网。
   1. 发送“post https://vpc的endpoint/v1/{project_id}/subnets”，project_id为项目id。
   2. 在request header中增加“x-auth-token”。
   3. 在request body中传入参数如下，其中dnslist参数参见华为云提供的内网dns地址是多少？，availability_zone参数可通过获取。

   4. {
      	"subnet": {
      		"name": "subnet",
      		"description": "",
      		"cidr": "192.168.0.0/24",
      		"gateway_ip": "192.168.0.1",
      		"dhcp_enable": true,
      		"dnslist": ["114.xx.xx.114", "114.xx.xx.115"],
      		"availability_zone": "aa-bb-cc",
      		"vpc_id": "b6684a27-b049-407d-90b4-c9551f2390e1"
      	}
      }

   5. 查看请求响应结果。
      • 请求成功时，响应参数如下：

        {
        	"subnet": {
        		"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
        		"name": "subnet",
        		"description": "",
        		"cidr": "192.168.0.0/24",
        		"dnslist": ["114.xx.xx.114", "1114.xx.xx.115"],
        		"status": "unknown",
        		"vpc_id": "b6684a27-b049-407d-90b4-c9551f2390e1",
        		"gateway_ip": "192.168.0.1",
        		"dhcp_enable": true,
        		"primary_dns": "114.xx.xx.114",
        		"secondary_dns": "114.xx.xx.115",
        		"availability_zone": "aa-bb-cc",
        		"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
        		"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
        		"extra_dhcp_opts": []
        	}
        }

      • 请求异常时，错误码请参见错误码。

4. 查询子网详情。
   1. 发送“get https://vpc的endpoint/v1/{project_id}/subnets/{subnet_id}”，project_id为项目id。
   2. 在request header中增加“x-auth-token”。
   3. 查看请求响应结果。

      {
      	"subnet": {
      		"id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
      		"name": "subnet",
      		"description": "",
      		"cidr": "192.168.20.0/24",
      		"dnslist": ["114.xx.xx.114", "114.xx.xx.115"],
      		"status": "active",
      		"vpc_id": "b6684a27-b049-407d-90b4-c9551f2390e1",
      		"gateway_ip": "192.168.20.1",
      		"ipv6_enable": false,
      		"dhcp_enable": true,
      		"primary_dns": "114.xx.xx.114",
      		"secondary_dns": "114.xx.xx.115",
      		"availability_zone": "aa-bb-cc",
      		"neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
      		"neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12",
      		"extra_dhcp_opts": []
      	}
      }