租户端 网络 私有网络（VPC） 历史版本（V2接口） 添加本端目的IP端口转换

添加本端目的IP端口转换

最近更新时间: 2024-10-17 17:10:00

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. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码，更多公共错误码详见公共错误码。

错误码 描述
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":[

    ]
}