查询对端IP转换

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

1. 接口描述

本接口(DescribePeerIPTranslationNatRule)用于查询专线网关对端IP转换 接口请求域名:vpc.api.qcloud.com

本接口用于查询指定专线网关的对端IP转换规则。

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见公共请求参数页面。其中,此接口的Action字段为DescribePeerIPTranslationNatRule。

参数名称 必选 类型 描述
vpcId String 系统分配的私有网络ID,例如:vpc-dfg5445。
directConnectGatewayId String 系统分配的专线网关ID,例如:dcg-4d545d。
originalIP String 原始IP。
translationIP String 转换后IP。
description String 备注,支持模糊搜索。
offset Int 初始行的偏移量,默认为0。
limit Int 每页行数,默认为20。

3. 输出参数

参数名称 类型 描述
code Int 公共错误码。0表示成功,其他值表示失败。详见错误码页面的公共错误码
message String 模块错误信息描述,与接口相关。
data.n Array 本端IP转换规则信息组。
data.n.originalIP String 原始IP。
data.n.translationIP String 转换后IP。
data.n.description String 备注。

4. 错误码表

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

错误码 描述
InvalidVpc.NotFound 无效的VPC,VPC资源不存在。请再次核实您输入的资源信息是否正确。可调用 DescribeVpcEx 接口查询。
InvalidDirectConnectGateway.NotFound 无效的专线网关,专线网关资源不存在。请再次核实您输入的资源信息是否正确。可调用 DescribeDirectConnectGateway 接口查询。
InvalidPeerIPTranslation.NotFound 无效的对端IP转换规则,对端IP转换规则不存在。请再次核实您输入的资源信息是否正确。可调用 DescribePeerIPTranslationNatRule 接口查询。
InvalidOriginalIP.Duplicate 无效的原始IP, 原始IP重复。原始IP已经在该网关的本端IP专线规则中,原始IP不可重复。

5. 示例

输入

https://vpc.api.qcloud.com/v2/index.php?Action=DescribePeerIPTranslationNatRule
&<公共请求参数>
&vpcId=vpc-dfgg190
&directConnectGatewayId=dcg-ddf14d

输出

{
    "code":"0",
    "message":"",
    "data": [
        {
            "originalIP": "10.0.0.1",
            "translationIP": "138.0.0.1",
            "description": "备注1"
        }
    ]
}