接口说明
每条 DNAT 条目由五部分组成,包括 ExternalIp、ExternalPort、IpProtocol、InternalIp 和 InternalPort。添加 DNAT 条目后,NAT 网关会将ExternalIp:ExternalPort上收到的指定协议的报文转发给InternalIp:InternalPort,并将回复消息原路返回。
调用本接口添加 DNAT 条目时,请注意:
-
CreateForwardEntry 接口属于异步接口,即系统会先返回一个 DNAT 条目 ID,但该 DNAT 条目并未添加完成,系统后台的添加任务仍在进行。您可以调用 DescribeForwardTableEntries 查询 DNAT 条目的状态:
-
当 DNAT 条目处于 Pending 状态时,表示 DNAT 条目正在添加中,在该状态下,您只能执行查询操作,不能执行其他操作。
-
当 DNAT 条目处于 Available 状态时,表示 DNAT 条目添加完成。
-
-
所有 DNAT 条目的 ExternalIp、ExternalPort 和 IpProtocol 三个字段组成的组合必须互不重复,即不允许将同一个源 IP、同一个端口、同一个协议的消息转发到多个目标 ECS 实例。
-
所有 DNAT 条目的 InternalIp、InternalPort 和 IpProtocol 三个字段组成的组合也必须互不重复。
-
所有 DNAT 条目的 ExternalIp 和 InternalIp 两个字段的 IP 地址不能相同,如果业务需要两个 IP 地址相同, 请联系商务经理。
-
一个 DNAT 表最多可添加 100 条 DNAT 条目。
-
DNAT 条目中配置了 IP 映射方式的 IP(公网 NAT 网关使用的 EIP 或 VPC NAT 网关使用的 NAT IP 地址)不能再被其他 DNAT 条目或 SNAT 条目使用。
流控信息
请求参数
字段名称 | 字段详情 |
---|---|
RegionIdstring | NAT 网关所在的地域 ID。展开详情 示例值:cn-hangzhou参考取值来源: DescribeRegions |
ForwardTableIdstring | DNAT 列表的 ID。 示例值:ftb-bp1mbjubq34hlcqpa****参考取值来源: DescribeForwardTableEntries |
ExternalIpstring |
示例值:116.28.XX.XX |
ExternalPortstring |
示例值:8080 |
InternalIpstring |
示例值:192.168.XX.XX |
InternalPortstring |
示例值:80 |
IpProtocolstring | 协议类型,取值: 展开详情 示例值:TCP |
ForwardEntryNamestring | DNAT 规则的名称。展开详情 示例值:ForwardEntry-1参考取值来源: DescribeForwardTableEntries |
ClientTokenstring | 客户端 Token,用于保证请求的幂等性。展开详情 示例值:0c593ea1-3bea-11e9-b96b-88e9fe6**** |
PortBreakboolean | 是否开启端口突破,取值:展开详情 示例值:false |
DryRunboolean | 是否只预检此次请求,取值:展开详情 示例值:false |
返回参数
字段名称 | 字段详情 |
---|---|
ForwardEntryIdstring | DNAT 条目的 ID。 示例值:fwd-119smw5tkasdf**** |
RequestIdstring | 请求 ID。 示例值:A4AEE536-A97A-40EB-9EBE-53A6948A6928 |
返回示例
错误码
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2024-12-03 | |||
2024-10-23 | |||
2024-01-18 | |||
2023-06-14 | |||
2023-03-30 | |||
2023-03-01 | |||
2022-12-02 | |||
2022-11-07 |