全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
专有网络 VPC

创建共享带宽包

更新时间:2017-11-13 17:33:07

描述

在指定的NAT网关上创建共享带宽包。一个NAT网关最可创建四个共享带宽包。

NAT网关上的公网IP和带宽,被封装为共享带宽包。一个共享带宽包包含:

  • 一份共享带宽
  • 一组公网IP

一个共享带宽包中的所有IP共享这份带宽。NAT网关与共享带宽包的计费说明,参考计费说明

只有NAT老用户支持指定该参数。

请求参数

请求参数 类型 是否必须 描述
Action String 系统规定参数,取值:CreateBandwidthPackage
RegionId String NAT网关的所属地域。
NatGatewayId String 创建共享带宽包的NAT网关ID。
IpCount Integer 至少指定一个

共享带宽包中的公网IP数量

取值范围:1-50。

Bandwidth Integer 至少指定一个

共享带宽包的带宽。

取值范围:5-1000。

Zone String

共享带宽包位于的可用区。

不指定该参数时,系统将随机分配一个可用区。

注意:共享带宽包上的IP与后端ECS不处于同一个可用区,并不影响其连通性;但是位于相同可用区时,可减小延迟。

Name String

共享带宽包名称。

名称在2-128个字符之间,必须以英文字母或中文开头,不能以 http:// 和 https:// 开头,可包含数字,“.”,“_”或“-”。

如果没有指定该参数,默认使用网关ID。

Description String

共享带宽包描述。

描述在2-256个字符之间,不能以 http:// 和 https:// 开头。

返回参数

返回参数 类型 描述
BandwidthPackageId String 共享带宽包的ID。

错误码

错误代码 错误信息 HTTP状态码 说明
InvalidRegionId.NotFound The specified RegionId is not found in our record. 404 指定的地域不存在。
InvalidZoneId.NotFound Specified value of ZoneId is not supported. 404 指定的可用区不存在。
InvalidNatGatewayId.NotFound Specified value of NatGatewayId is not found in our record. 404 指定的NAT网关不存在。
MissingParameter.IpCount Missing parameter IpCount. 400 未指定公网IP数量。
MissingParameter. Bandwidth(n需要给出具体值) Missing parameter Bandwidth. 400 未指定带宽值。
QuotaExceeded.BandwidthPackageCountOnNatGateway BandwidthPackage count limit on one NatGateway exceeded. 400 超过了共享带宽包上限。一个NAT网关最多可创建四个共享带宽包。
InvalidParameter.Name.Malformed The specified Name is not valid. 400 指定的名称不合法。
InvalidParameter.Description.Malformed The specified Description is not valid. 400 指定的描述不合法。

示例

请求示例

  1. https://vpc.aliyuncs.com/?SignatureVersion=1.0&NatGatewayId=ngw-7mwb327j1&Format=json&TimeStamp=2016-07-19T17%3A08%3A27Z&RegionId=cn-shanghai&Bandwidth=5&AccessKeyId=jZgi0oyrQ6ihgKp9&SignatureMethod=HMAC-SHA1&Version=2016-04-28&Signature=DIqV3jVRDoISfSPsjgYtEcHKLyM%3D&Action=CreateBandwidthPackage&SignatureNonce=690270e8-4dd3-11e6-93ce-2cf0ee28adf2&ZoneId=cn-shanghai-a&IpCount=1

返回示例

JSON 格式

  1. {
  2. "BandwidthPackageId": "bwp-s6lmotmkk",
  3. "RequestId": "54ED4074-3F89-4F11-B166-837DD3E20FE3"
  4. }
本文导读目录