创建IP地址族
所有文档
menu

私有网络 VPC

创建IP地址族

产品详情自助选购


描述

该接口用于创建IP地址族。

请求结构

POST /v{version}/ipGroup?clientToken={clientToken} HTTP/1.1   
Host: bcc.bj.baidubce.com      
Authorization: authorization string
{
    "name":{name},
    "ipVersion":{ipVersion},
    "ipSetIds":{ipSetIds},
    "description":{description}
}

请求头域

除公共头域外,无其它特殊头域。

请求参数

参数名称 类型 是否必需 参数位置 描述
version String URL参数 API版本号,目前取值为1
name String RequestBody参数 IP地址族的名称,限制:大小写字母、数字、中文以及-_/.特殊字符,必须以字母或者中文开头,长度1-65
ipVersion String RequestBody参数 ipVersion,取值IPv4或IPv6
ipSetIds List<String> Request Body参数 关联的IP地址组ID,其ipVersion需与本次创建的IP地址族一致,单次最多指定5个
description String RequestBody参数 IP地址族描述,长度不超过255
clientToken String Query参数 幂等性Token,是一个长度不超过64位的ASCII字符串,详见ClientToken幂等性支持

返回头域

除公共头域,无其它特殊头域。

返回参数

参数名称 类型 描述
ipGroupId String IP地址族的ID

请求示例

POST /v1/ipGroup?clientToken=cecad37a-5a1e-4135-a1bc-b1a105d12dec HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
    "name":"ipGroup_test",
    "ipVersion":"IPv4",
    "ipSetIds": ["ips-q52nhx0fqqmk"],
    "description":"desc"
}

返回示例

HTTP/1.1 200 OK
x-bce-request-id: 7e789a40-adac-414a-8bd4-916d6be61112
Date: Mon, 02 Apr 2019 08:14:25 GMT
Content-Type: application/json;charset=UTF-8
Server: BWS
{
  "ipGroupId":"ipg-pcpvtee8kd6b"
}
上一篇
查询指定的IP地址组
下一篇
IP地址族添加IP地址组