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