调用CreateNatGateway接口创建增强型NAT网关。
API描述
在调用本接口创建NAT网关时,请注意:
- 首次创建增强型NAT网关时,系统会自动创建一个名称为AliyunServiceRoleForNatgw的服务关联角色,并且为该角色添加名称为AliyunServiceRolePolicyForNatgw的权限策略,授予NAT网关拥有访问其他云资源的权限。更多信息,请参见服务关联角色。
- CreateNatGateway接口属于异步接口,即系统会先返回一个NAT网关实例ID,但该NAT网关实例并未创建完成,系统后台的创建任务仍在进行。您可以调用DescribeNatGateways查询NAT网关的状态:
- 当NAT网关处于Creating状态时,表示NAT网关正在创建中,在该状态下,您只能执行查询操作,不能执行其他操作。
-
当NAT网关处于Available状态时,表示NAT网关创建完成。说明 NAT网关创建一般需要1~3分钟,请您耐心等待。
- NAT网关创建后,系统会在VPC的路由表中自动添加一条目标网段为0.0.0.0/0,下一跳为NAT网关的路由条目,用于将流量路由到NAT网关。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateNatGateway |
要执行的操作,取值:CreateNatGateway。 |
RegionId | String | 是 | cn-hangzhou |
NAT网关所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
VpcId | String | 是 | vpc-bp1di7uewzmtvfuq8**** |
需要创建NAT网关的VPC的ID。 |
VSwitchId | String | 是 | vsw-bp1e3se98n9fq8hle**** |
NAT网关所属的交换机的ID。 创建增强型NAT网关时,您必须指定NAT网关所属的交换机,系统会为增强型NAT网关分配一个交换机内的空闲私网IP地址。
您可以通过ListEnhanhcedNatGatewayAvailableZones接口查询增强型NAT网关的资源可用区,通过DescribeVSwitches接口查询交换机中的可用IP数。 |
NatType | String | 是 | Enhanced |
NAT网关的类型,取值:Enhanced,增强型NAT网关。增强型NAT网关详情,请参见增强型NAT网关发布公告。 |
Name | String | 否 | fortest |
NAT网关的名称。 名称长度为2~128个字符之间,必须以英文字母或中文开头,不能以 如果没有指定该参数,默认使用网关ID作为名称。 |
Description | String | 否 | testnat |
NAT网关的描述。 描述长度为2~256个字符之间,不能以 |
ClientToken | String | 否 | shefffxxddjehfh123 |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。 |
Spec | String | 否 | Small |
NAT网关的规格,取值:
|
InstanceChargeType | String | 否 | PostPaid |
NAT网关的付费模式,取值: PostPaid(默认值):按量付费。 PrePaid:包年包月。 |
PricingCycle | String | 否 | Month |
包年包月的计费周期,取值: Month(默认值):按月付费。 Year:按年付费。 当InstanceChargeType参数的值为PrePaid时,该参数必选;当InstanceChargeType参数的值为PostPaid时,该参数可不填。 |
Duration | String | 否 | 1 |
购买时长。 当PricingCycle取值Month时,Period取值范围为1~9。 当PricingCycle取值Year时,Period取值范围为1~3。 如果InstanceChargeType参数的值为PrePaid时,该参数必选。 |
AutoPay | Boolean | 否 | false |
是否自动付费,取值: false:不开启自动付费,生成订单后需要到订单中心完成支付。 true:开启自动付费,自动支付订单。 当InstanceChargeType参数的值为PrePaid时,该参数必选;当InstanceChargeType参数的值为PostPaid时,该参数不填。 |
InternetChargeType | String | 否 | PayBySpec |
NAT网关的计费类型,取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NatGatewayId | String | ngw-112za33e4**** |
创建的NAT网关的实例ID。 |
ForwardTableIds | List | ftb-11tc6xgmv**** |
DNAT列表。 |
RequestId | String | 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3 |
请求ID。 |
SnatTableIds | List | stb-SnatTableIds**** |
SNAT列表。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=CreateNatGateway
&RegionId=cn-hangzhou
&VpcId= vpc-bp1di7uewzmtvfuq8****
&<公共请求参数>
正常返回示例
XML
格式
<CreateNatGatewayResponse>
<RequestId>5AF873FB-6669-4AD5-A4DA-478D535C8F0D</RequestId>
<SnatTableIds>
<SnatTableId>stb-bp1evej8rk6ww1djl****</SnatTableId>
</SnatTableIds>
<ForwardTableIds>
<ForwardTableId>ftb-bp1d09hosgndxs154****</ForwardTableId>
</ForwardTableIds>
<NatGatewayId>ngw-bp1m842e0dz1t5cos****</NatGatewayId>
</CreateNatGatewayResponse>
JSON
格式
{
"RequestId": "5AF873FB-6669-4AD5-A4DA-478D535C8F0D",
"SnatTableIds": {
"SnatTableId": [
"stb-bp1evej8rk6ww1djl****"
]
},
"ForwardTableIds": {
"ForwardTableId": [
"ftb-bp1d09hosgndxs154****"
]
},
"NatGatewayId": "ngw-bp1m842e0dz1t5cos****"
}
在文档使用中是否遇到以下问题
更多建议
匿名提交