阅读271 返回首页    go 阿里云 go 技术社区[云栖]

创建共享带宽包__NAT网关相关接口_API参考_专有网络 VPC-阿里云

NAT网关上的公网IP和共享带宽，被封装为共享带宽包。一个共享带宽包对象，包含如下资源：

  1. 一份共享带宽
  2. 一些公网 IP

一个共享带宽包中的所有IP共享这份带宽。

描述

在指定的NAT Gateway上创建新的共享带宽包。

一个NAT网关上，最多可以同时存在四个共享带宽包。

费用与价格：

NAT网关与共享带宽包的收费模式与价格介绍，见购买指导-价格总览；

请求参数

名称 类型 是否必须 描述
Action String 是 系统规定参数，取值：CreateBandwidthPackage
RegionId String 是 创建的NAT Gateway 所在的地域
NatGatewayId String 是 在哪个NAT Gateway上创建共享带宽包
IpCount Integer 至少指定一个 带宽包中的公网IP个数
取值范围：1-50
Bandwidth Integer 至少指定一个 带宽包的带宽值
取值范围：5-1000
Zone String 否 带宽包位于的可用区
不指定该参数时，系统将随机选择可用区进行分配。
共享带宽包上的IP与后端ECS不处于同一个可用区时，并不影响其连通性；但是位于共可用区时可以获得更为极致的Latancy表现。
Name String 否 实例的显示名称，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，“.”，“_”或“-”。
实例名称会显示在控制台。
如果没有指定该参数，默认值为实例的 InstanceId
不能以 https:// 和 https:// 开头。
Description String 否 自定义描述[[2, 256] 个字符，实例描述会显示在控制台。不填则为空，默认为空。不能以 https:// 和 https:// 开头

返回参数

名称 类型 描述
BandwidthPackageId String 共享带宽包的ID

错误码

错误代码 描述 Http 状态码 语义
InvalidRegionId.NotFound The specified RegionId is not found in our record. 404 指定的Region Id 不存在
InvalidZoneId.NotFound Specified value of ZoneId is not supported. 404 指定的ZoneId不存在
InvalidNatGatewayId.NotFound Specified value of NatGatewayId is not found in our record. 404 指定的NatGatewayId不存在
MissingParameter.IpCount Missing parameter IpCount. 400 未指定IpCount
MissingParameter. Bandwidth(n需要给出具体值) Missing parameter Bandwidth. 400 未指定Bandwidth
QuotaExceeded.BandwidthPackageCountOnNatGateway BandwidthPackage count limit on one NatGateway exceeded. 400 超过了NatGateway上的共享带宽包容量上限
InvalidParameter.Name.Malformed The specified Name is not valid. 400 指定的Name不合法
InvalidParameter.Description.Malformed The specified Description is not valid. 400 指定的Description不合法

示例

请求示例

  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. }

XML格式

暂略；~

最后更新：2016-11-23 16:04:15

  上一篇：go 修改NAT网关属性__NAT网关相关接口_API参考_专有网络 VPC-阿里云
  下一篇：go 修改共享带宽包属性__NAT网关相关接口_API参考_专有网络 VPC-阿里云