1. 接口描述
本接口(CreateLocalIPTranslationNatRule)用于添加专线网关本端 IP 转换。
接口请求域名:vpc.api.qcloud.com
1. 私有网络内原 IP 映射为新 IP,并以新 IP 与专线对端进行网络互访,只有 NAT 类型网关才支持。
2. 原 IP 必须在 VPC 网段内,转换后 IP 不能在 VPC 网段内。
3. 同一个 NAT 网关下的本端IP转换规则原 IP 不能重复,转换后 IP 也不能重复。
2. 输入参数
以下请求参数列表仅列出了接口请求参数,正式调用时需要加上公共请求参数,详情请参见 公共请求参数 页面。其中,此接口的 Action 字段为 CreateLocalIPTranslationNatRule。
参数名称 | 是否必选 | 类型 | 描述 |
vpcId | 是 | String | 系统分配的私有网络 ID,支持升级前的 vpcId,也支持升级后的 unVpcId,例如 vpc-ddg454。 |
directConnectGatewayId | 是 | String | 系统分配的专线网关 ID,例如 dcg-dgd54g。 |
localIPTranslation.n | 是 | Array | 本端IP转换。 |
localIPTranslation.n.originalIP | 是 | String | 原始 IP。 |
localIPTranslation.n.translationIP | 是 | String | 转换后 IP。 |
localIPTranslation.n.description | 否 | String | 备注。 |
3. 输出参数
参数名称 | 类型 | 描述 |
code | Int | |
message | String | 模块错误信息描述,与接口相关。 |
data | Array | 返回信息。 |
data.taskId | Int | |
codeDesc | String | 错误码。 |
4. 错误码表
错误码 | 描述 |
InvalidVpc.NotFound | |
InvalidDirectConnectGateway.NotFound | |
InvalidOriginalIP.NotInVpcCidr | 无效的原始 IP。原始 IP 不在 VPC 网段内。 |
InvalidOriginalIP.Duplicate | 无效的原始 IP。原始 IP 重复,原始 IP 已经在该网关的本端IP专线规则中,原始IP不可重复。 |
InvalidTranslationIP.InVpcCidr | 无效的转换后 IP。转换后 IP 在 VPC 网段内。 |
InvalidTranslationIP.Duplicate | 无效的转换后 IP。 转换后 IP 重复,转换后IP已经在该网关的本端 IP 转换规则中,转换后IP不可重复。 |
LocalIPTranslationLimitExceeded |
5. 示例
输入
https://vpc.api.qcloud.com/v2/index.php?Action=CreateLocalIPTranslationNatRule&<公共请求参数>&vpcId=vpc-csnmo39l&directConnectGatewayId=dcg-mm01ughx&localIPTranslation.0.originalIP=10.100.10.2&localIPTranslation.0.translationIP=10.100.10.2&localIPTranslation.0.description=183.0.0.1
输出
{"code":"0","message":"","data":{"taskId":"17934"},"codeDesc":"Success"}