1. 接口描述
本接口(CreateLocalIPTranslationAclRule)用于添加本端 IP 转换 ACL 策略。
接口请求域名:vpc.api.qcloud.com
2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateLocalIPTranslationAclRule。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
vpcId | 是 | String | 系统分配的私有网络 ID,例如 vpc-dfg5445。可调用 查询私有网络列表(DescribeVpcEx)接口查询。 |
directConnectGatewayId | 是 | String | 系统分配的专线网关 ID,例如 dcg-4d545d。可调用 查询专线网关(DescribeDirectConnectGateway)接口查询。 |
originalIP | 是 | String | 原始 IP(VPC 内 IP)。 |
translationIP | 是 | String | 转换后 IP。 |
aclRules.n | 是 | Array | ACL 策略信息。 |
aclRules.n.protocol | 是 | String | 协议:TCP、UDP 或者 ALL。 |
aclRules.n.sourcePort | 是 | String | 访问的源端口,支持xx-xx范围,不填或者填0或者0-0都表示不限端口。 |
aclRules.n.destinationCidr | 是 | String | 访问的目的 IP,支持 IP、IP 段(CIDR 格式),如果不填写指所有 IP。 |
aclRules.n.destinationPort | 是 | String | 访问的目的端口,支持xx-xx范围,不填或者填0或者0-0都表示不限端口。 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
code | Int | 公共错误码,0表示成功,其他值表示失败。详见错误码页面的 公共错误码。 |
message | String | 模块错误信息描述,与接口相关。 |
4. 错误码表
以下错误码表仅列出了该接口的业务逻辑错误码,更多公共错误码详见 VPC 错误码。
错误码 | 描述 |
---|---|
InvalidVpc.NotFound | 无效的 VPC。VPC 资源不存在,请再次核实您输入的资源信息是否正确。可调用 查询私有网络列表(DescribeVpcEx)接口查询。 |
InvalidDirectConnectGateway.NotFound | 无效的专线网关。专线网关资源不存在,请再次核实您输入的资源信息是否正确。可调用 查询专线网关(DescribeDirectConnectGateway)接口查询。 |
InvalidLocalIPTranslation.NotFound | 无效的本端 IP 转换规则。本端 IP 转换规则不存在,请再次核实您输入的资源信息是否正确。 |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=CreateLocalIPTranslationAclRule &<公共请求参数> &vpcId=vpc-dfgg190 &directConnectGatewayId=dcg-ddf14d &originalIP=10.0.0.5 &translationIP=138.0.0.11 &aclRules.n.protocol=tcp &aclRules.n.sourcePort=80 &aclRules.n.destinationCidr=10.0.0.2/18 &aclRules.n.destinationPort=90
输出
{
"code":"0",
"message":""
}