文档中心>API 中心

查询本端IP转换ACL策略

最近更新时间:2019-12-02 18:30:27

我的收藏

1. 接口描述

本接口(DescribeLocalIPTranslationAclRule)用于查询本端 IP 转换 ACL策略。 接口请求域名:vpc.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,见 公共请求参数 页面。其中,此接口的 Action 字段为 DescribeLocalIPTranslationAclRule。
参数名称
必选
类型
描述
vpcId
String
系统分配的私有网络 ID,例如:vpc-dfg5445
directConnectGatewayId
String
系统分配的专线网关ID,例如:dcg-4d545d
originalIP
String
原始 IP
translationIP
String
转换后 IP
aclRules.n
Array
ACL 策略 ID 数组,例如:aclRules.0=25

3. 输出参数

参数名称
类型
描述
code
int
公共错误码。0表示成功,其他值表示失败。详见错误码页面的 公共错误码
message
String
模块错误信息描述,与接口相关
data.n
Array
ACL 策略信息数组
data.n.aclRuleId
Int
ACL 规则 ID,例如:25
data.n.protocol
String
协议,例如 TCP
data.n.sourcePort
String
访问的源端口,例如:900
data.n.destinationCidr
String
访问的目的 IP,例如:10.0.0.2/16
data.n.destinationPort
String
访问的目的端口,例如:80-90

4. 错误码表

以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码
错误码
描述
InvalidVpc.NotFound
无效的 VPC。VPC 资源不存在,请再次核实您输入的资源信息是否正确。可调用 查询私有网络列表(DescribeVpcEx)接口查询
InvalidDirectConnectGateway.NotFound
无效的专线网关。专线网关资源不存在,请再次核实您输入的资源信息是否正确。可调用 查询专线网关(DescribeDirectConnectGateway)接口查询
InvalidLocalIPTranslation.NotFound
无效的本端 IP 转换规则。本端 IP 转换规则不存在,请再次核实您输入的资源信息是否正确

5. 示例

输入
https://vpc.api.qcloud.com/v2/index.php?Action=DescribeLocalIPTranslationAclRule
&<公共请求参数>
&vpcId=vpc-dfgg190
&directConnectGatewayId=dcg-ddf14d
&originalIP=10.0.0.5
&translationIP=138.0.0.11
输出
{
"code": "0",
"message": "",
"data": [{
"aclRuleId": 67,
"protocol": "TCP",
"sourcePort": "80",
"destinationCidr": "10.0.0.2/18",
"destinationPort": "90"
}]
}