创建全域公网带宽
功能介绍
创建全域公网带宽
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v3/{domain_id}/geip/internet-bandwidths
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
domain_id |
是 |
String |
最小长度：5 最大长度：32 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户的Token，如何获取用户Token请参见获取用户Token |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
internet_bandwidth |
是 |
internet_bandwidth object |
全域公网带宽信息 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
ingress_size |
否 |
Integer |
全域公网带宽大小（入云方向），具体取值范围以购买页面为准 最小值：1 |
|
charge_mode |
是 |
String |
|
|
isp |
是 |
String |
全域公网带宽接入的线路，接入线路信息可通过查询全域弹性公网IP池列表接口查询。 最小长度：1 最大长度：64 |
|
access_site |
是 |
String |
接入点信息，具体接入点信息可通过查询接入点列表接口查询。 最小长度：1 最大长度：64 |
|
size |
是 |
Integer |
全域公网带宽大小（出云方向），具体取值范围以购买页面为准 最小值：1 |
|
name |
否 |
String |
最小长度：1 最大长度：64 |
|
description |
否 |
String |
最小长度：0 最大长度：512 |
|
tags |
否 |
Array of tags objects |
全域公网带宽标签 |
|
enterprise_project_id |
否 |
String |
最小长度：1 最大长度：36 |
|
type |
否 |
String |
全域公网带宽类型 缺省值：standard 最小长度：1 最大长度：64 |
响应参数
状态码： 201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
X-Request-Id |
String |
本次请求编号 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
本次请求的编号 |
|
internet_bandwidth |
CreateInternetBandwidth object |
创建全域公网带宽成功响应体 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
全域公网带宽的ID |
|
name |
String |
最小长度：1 最大长度：64 |
|
ingress_size |
Integer |
全域公网带宽大小（入云方向） |
|
isp |
String |
全域公网带宽接入的线路，接入线路信息可通过查询全域弹性公网IP池列表接口查询。 |
|
access_site |
String |
接入点信息，具体接入点信息可通过查询接入点列表接口查询。 |
|
size |
Integer |
全域公网带宽大小（出云方向） |
|
description |
String |
最小长度：0 最大长度：512 |
|
charge_mode |
String |
|
|
ratio_95peak |
Integer |
增强95保底率 |
|
freezen_info |
String |
冻结原因 |
|
domain_id |
String |
|
|
billing_info |
String |
包周期时有值，订单信息 |
|
status |
String |
状态 |
|
is_pre_paid |
Boolean |
是否包周期 |
|
created_at |
String |
创建时间 |
|
updated_at |
String |
更新时间 |
|
tags |
Array of Tag objects |
全域公网带宽标签 |
|
enterprise_project_id |
String |
|
|
type |
String |
全域公网带宽类型 |
请求示例
创建一个按带宽计费，大小为80的全域公网带宽
POST https://{Endpoint}/v3/{domain_id}/geip/internet-bandwidths
{
"internet_bandwidth" : {
"access_site" : "cn-south-odin",
"charge_mode" : "bandwidth",
"isp" : "BGP",
"size" : 80,
"type" : "standard",
"name" : "test"
}
}响应示例
状态码： 201
CREATED
{
"internet_bandwidth" : {
"enterprise_project_id" : 0,
"name" : "test",
"id" : "cce4b43d-c92c-4845-8065-8c2cdd1a1881",
"isp" : "BGP",
"access_site" : "cn-south-odin",
"size" : 80,
"description" : null,
"charge_mode" : "bandwidth",
"freezen_info" : null,
"domain_id" : "f35feb8670a94a04a08d6628e0d5165b",
"is_pre_paid" : false,
"billing_info" : null,
"status" : "normal",
"ratio_95peak" : 0,
"ingress_size" : 80,
"tags" : [ ],
"type" : "standard"
},
"request_id" : "8bcadb5d-1bf4-42e8-909f-1606ecf781ce"
}状态码
|
状态码 |
描述 |
|---|---|
|
201 |
CREATED |
错误码
请参见错误码。
