调用CreateSnatEntry接口在SNAT列表中添加SNAT条目。

每个SNAT条目由SourceVSwitchId(交换机)和SnatIp(公网IP)组成。添加SNAT条目后,交换机下的ECS实例将通过SnatIp访问公网。

调用本接口添加DNAT条目时,请注意:

  • SNAT条目中的指定的交换机必须在NAT网关所属的VPC内。
  • 每个交换机只能属于一个SNAT条目。
  • 如果交换机中存在HAVIP实例,则无法添加SNAT条目。
  • SNAT条目中的公网IP(SnatIp)需满足以下条件:
    • 对于2017年11月3日之前账户下存在NAT带宽包的用户,SnatIp必须是该NAT网关的NAT带宽包中的公网IP地址。
    • 对于2017年11月3日之前账户下不存在NAT带宽包的用户,SnatIp必须是绑定了该NAT网关的弹性公网IP。
    • 一个公网IP不能同时用于DNAT条目和SNAT条目。

调试

前往【API Explorer】在线调试,API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力,能显著降低使用云 API 的难度,强烈推荐使用。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateSnatEntry

要执行的操作。

取值: CreateSnatEntry

RegionId String cn-hangzhou

NAT网关所在的地域。

您可以通过调用DescribeRegions接口获取地域ID。

SnatIp String 47.XXX.XXX.98

公网IP地址。多个IP之间逗号隔开。

SnatTableId String stb-bp190wu8io1vgevxxxxxx

SNAT表ID。

SourceCIDR String 10.1.1.0/24

指定交换机的网段。比如10.0.0.1/24。

说明 此参数和 SourceVSwtichId参数互斥,不能同时出现。如果指定了 SourceVSwitchId,则不能指定 SourceCIDR参数。如果指定了 SourceCIDR参数,则不能指定 SourceVSwitchId参数。
SourceVSwitchId String vsw-bp1nhx2s9ui5omnw9XXXX

需要公网访问的交换机的ID。

返回参数

名称 类型 示例值 描述
SnatEntryId String snat-kmd6nv8fy

SNAT条目ID。

RequestId String 69B31D6E-9F34-4A5A-8DBC-230A3918E828

请求ID。

示例

请求示例


https://vpc.aliyuncs.com/?Action=CreateSnatEntry
&RegionId=cn-hangzhou
&SnatIp=47.XXX.XXX.98
&SnatTableId=stb-bp190wu8io1vgevxxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<?xml version="1.0" encoding="UTF-8" ?>
<CreateSnatEntryResponse>
    <RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
    <SnatEntryId>snat-119smw5tk</ForwardEntryId>
</CreateSnatEntryResponse>

JSON 格式

{
	"RequestId":"2315DEB7-5E92-423A-91F7-4C1EC9AD97C3",
	"SnatEntryId":"snat-119smw5tk"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的 RegionId 不存在,请您检查此产品在该地域是否可用。
404 InvalidSnatTableId.NotFound Specified SNAT table does not exist. 指定的 SNAT 表不存在,请您检查输入参数是否正确。
400 Forbidden.SourceVSwitchId.IncludeHaVip There is some HaVips under specified VSwitch 该交换机下有关联的HAVIP。
400 InvalidSnatIp.Malformed The specified SnatIp is not a valid IP address. 该公网IP不合法。
400 SNAT_IP_POOL_COUNT_TOO_MANY The Snat pool ip too many. SNAT IP池的IP达到配额。
400 Forbidden.SnatEntryCountLimited SNAT entry in the specified SNAT table reach it?s limit. SNAT条目数量已达到配额。
404 InvalidVSwitchId.NotFound The specified virtual switch does not exists. 该交换机不存在,请您检查输入的交换机是否正确。
400 INVALID_PARAMETER The parameter invalid. 参数不合法。
400 Forbidden.SourceVSwitchId.Duplicated The specified SourceCIDRis duplicated. 该交换机已配置了 SNAT 规则,请您不要重复设置。
400 Forbidden.IpUsedInForwardTable The specified SnatIp already used in forward table 该公网IP已经被DNAT使用,请更换其他公网IP地址或将当前公网IP的DNAT规则删除。
400 Forbindden The specified Instance already bind eip 该实例已经绑定了 EIP,请将 ECS 实例与 EIP 解绑后再添加该端口转发规则。

查看本产品错误码