1. 接口描述
本接口(CreateLocalDestinationIPPortTranslationNatRule)用于添加专线网关本端目的 IP 端口转换。
接口请求域名:vpc.api.qcloud.com
- 专线对端主动访问私有网络,需访问映射后的 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":[
]
}