文档首页 > > 开发指南> 常见操作> 子网> 创建子网

创建子网

分享
更新时间: 2019/07/11 17:45

场景描述

本节介绍创建子网。

说明:

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

涉及API

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

  • IAM获取token的API
  • subnet创建的API
说明:

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

具体步骤

  1. Token认证,具体操作请参考Token认证
  2. 发送“POST https://VPC的Endpoint/ v1/{project_id}/subnets”。其中,project_id为项目ID。
  3. 在Request Header中增加“X-Auth-Token”。
  4. 在Request Body中传入参数,样例如下:
    POST https://{Endpoint}/v1/{project_id}/subnets
    
    {
        "subnet": {
            "name": "subnet",
            "description": "",
            "cidr": "192.168.20.0/24",
            "gateway_ip": "192.168.20.1",
            "dhcp_enable": true,
            "primary_dns": "114.xx.xx.114",
            "secondary_dns": "114.xx.xx.115",
            "dnsList": [
                "114.xx.xx.114",
                "114.xx.xx.115"
            ],
            "availability_zone": "aa-bb-cc",//假设可用区标识为aa-bb-cc
            "vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85"
        }
    }
    • subnet字段说明:
      表1 创建子网

      名称

      是否必选

      参数类型

      说明

      name

      String

      • 取值范围:1-64,支持数字、字母、中文、_(下划线)、-(中划线)
      • 功能说明:子网名称

      cidr

      String

      • 取值范围:必须在vpc对应cidr范围内
      • 功能说明:子网的网段
      • 约束:必须是cidr格式。掩码长度不能大于28。

      gateway_ip

      String

      • 取值范围:子网网段中的IP地址
      • 功能说明:子网的网关
      • 约束:必须是ip格式

      dhcp_enable

      Boolean

      • 取值范围:true(开启),false(关闭)
      • 功能说明:子网是否开启dhcp功能
      • 约束:不填时默认为true

      primary_dns

      String

      • 功能说明:子网dns服务器地址1
      • 约束:ip格式

      secondary_dns

      String

      • 功能说明:子网dns服务器地址2
      • 约束:ip格式

      dnsList

      List

      • 功能说明:子网dns服务器地址的集合;如果想使用两个以上dns服务器,请使用该字段
      • 约束:是子网dns服务器地址1跟子网dns服务器地址2的合集的父集

      availability_zone

      String

      • 功能说明:子网所在的可用分区标识
      • 约束:系统存在的可用分区标识
      • 请参考地区和终端节点

      vpc_id

      String

      功能说明:子网所在VPC标识

  5. 请求响应成功后,响应参数如下:
    {
        "subnet": {
            "id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
            "name": "subnet",
            "description": "",
            "cidr": "192.168.20.0/24",
            "dnsList": [
                "114.xx.xx.114",
                "1114.xx.xx.115"
            ],
            "status": "UNKNOWN",
            "vpc_id": "3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85",
            "gateway_ip": "192.168.20.1",
            "dhcp_enable": true,
            "primary_dns": "114.xx.xx.114",
            "secondary_dns": "114.xx.xx.115",
            "availability_zone": "aa-bb-cc",//假设可用区标识为aa-bb-cc。
            "neutron_network_id": "4779ab1c-7c1a-44b1-a02e-93dfc361b32d",
            "neutron_subnet_id": "213cb9d-3122-2ac1-1a29-91ffc1231a12"
        }
    }
  6. 请求异常返回值说明请参考错误码
  7. 响应参数中的id即为subnet的id,根据subnet_id和project_id可以查询、更新、删除subnet详情。
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区