文档中心>API 中心

添加本端目的IP端口转换

最近更新时间:2019-12-02 17:03:51

我的收藏

1. 接口描述

本接口(CreateLocalDestinationIPPortTranslationNatRule)用于添加专线网关本端目的 IP 端口转换。 接口请求域名:vpc.api.qcloud.com
1. 专线对端主动访问私有网络,需访问映射后的 IP 端口与私有网络内原始 IP 的端口进行通信,回包不受影响。只有 NAT 类型专线网关支持。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateLocalDestinationIPPortTranslationNatRule。
参数名称
是否必选
类型
描述
vpcId
String
私用网络 ID 或者统一 ID,建议使用统一 ID。
directConnectGatewayId
String
专线网关 ID。
localDestinationIPPortTranslation.n
Array
本端目的 IP 端口转换规则数组。
localDestinationIPPortTranslation.n.originalIP
String
原始 IP。
localDestinationIPPortTranslation.n.originalPort
String
原始 Port。
localDestinationIPPortTranslation.n.translationIP
String
转换后 IP。
localDestinationIPPortTranslation.n.translationPort
String
转换后 Port。
localDestinationIPPortTranslation.n.proto
String
协议。
localDestinationIPPortTranslation.n.description
String
备注。

3. 输出参数

参数名称
类型
描述
code
Int
公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码
message
String
模块错误信息描述,与接口相关。
codeDesc
String
错误码
data
Array
返回信息

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码
错误码
描述
InvalidVpc.NotFound
无效的 VPC,VPC 资源不存在,请再次核实您输入的资源信息是否正确。可调用 查询私有网络列表(DescribeVpcEx)接口查询。
InvalidDirectConnectGateway.NotFound
无效的专线网关,专线网关资源不存在,请再次核实您输入的资源信息是否正确。可调用 查询专线网关(DescribeDirectConnectGateway)接口查询。
InvalidOriginalIP.NotInVpcCidr
无效的原始 IP,原始 IP 不在 VPC 网段内。
InvalidTranslationIP.InVpcCidr
无效的转换后 IP, 转换后 IP 在 VPC 网段内。
InvalidTranslationIP.Duplicate
无效的转换后 IP, 转换后 IP 重复,转换后 IP 已经在该网关的本端 IP 专线规则中,转换后 IP 不可重复。
LocalDestinationIPPortTranslationLimitExceeded
您添加的本端目的 IP 端口转换规则已达上限,如果需要更多资源,请联系客服申请。更多 VPC 资源限制信息详见 VPC 使用限制

5. 示例

输入
https://vpc.api.qcloud.com/v2/index.php?Action=CreateLocalDestinationIPPortTranslationNatRule
&<公共请求参数>
&vpcId=vpc-csnmo39l
&directConnectGatewayId=dcg-mm01ughx
&localDestinationIPPortTranslation.0.originalIP=10.100.10.3
&localDestinationIPPortTranslation.0.originalPort=80
&localDestinationIPPortTranslation.0.translationIP=183.0.0.1
&localDestinationIPPortTranslation.0.translationPort=90
&localDestinationIPPortTranslation.0.proto=tcp
&localDestinationIPPortTranslation.0.description=183.0.0.1
输出
{
"code":"0",
"message":"",
"codeDesc":"Success",
"data":[

]
}