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

创建NAT带宽包

更新时间:2017-11-22 17:48:38

描述

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

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

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

该接口用于在指定的NAT网关上创建NAT带宽包。一个NAT网关最可创建四个NAT带宽包。

本接口仅支持在2017年11月3日23:59之前账户下存在NAT带宽包的用户调用。2017年11月3日23:59之前账户下不存在NAT带宽包的用户请参考绑定弹性公网IP,在NAT网关上绑定弹性公网IP。

请求参数

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

NAT带宽包中的公网IP数量

取值范围:1-50。

Bandwidth Integer 至少指定一个

NAT带宽包的带宽。

取值范围:5-1000。

Zone String

NAT带宽包位于的可用区。

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

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

Name String

NAT带宽包名称。

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

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

Description String

NAT带宽包描述。

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

返回参数

返回参数 类型 描述
BandwidthPackageId String NAT带宽包的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 Missing parameter Bandwidth. 400 未指定带宽值。
QuotaExceeded.BandwidthPackageCountOnNatGateway BandwidthPackage count limit on one NatGateway exceeded. 400 超过了NAT带宽包上限。一个NAT网关最多可创建四个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. }
本文导读目录