1. 接口描述
接口请求域名: vpcdns.api3.fincloud.tencent.cn。
修改转发规则
默认接口请求频率限制:20次/秒。
接口更新时间:2025-06-24 04:59:40。
接口只验签名不鉴权。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。
| 参数名称 | 必选 | 允许NULL | 类型 | 描述 |
|---|---|---|---|---|
| Action | 是 | 否 | String | 公共参数,本接口取值:ModifyForwardRule |
| Version | 是 | 否 | String | 公共参数,本接口取值:2019-10-25 |
| Region | 是 | 否 | String | 公共参数,地域信息本接口不需要传递此参数。 |
| RuleId | 是 | 否 | String | 转发规则ID 示例值: 20 |
| ForwardAddress | 是 | 是 | Array of String | 转发规则ID 示例值: ["1.1.1.2:80", "1.2.3.4:80"] |
| Remark | 否 | 是 | String | 备注 示例值: 这是备注 |
3. 输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| RuleId | String | 转发规则ID 示例值: 12 |
| ForwardAddress | Array of String | 转发地址IP 示例值: ["1.1.1.2:80", "1.2.3.4:80"] |
| Remark | String | 备注 示例值: 这是备注 |
| CreatedAt | Datetime | 请求响应时间 示例值: 2014-08-03 12:00:0 |
| RequestId | String | 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。 |
4. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码。
| 错误码 | 描述 |
|---|---|
| InvalidParameterValue. | 参数值错误 |
| InternalError.UndefiendError | 错误未定义 |
| InvalidParameter. | 参数错误 |
| InvalidParameterValue.RecordNotExist | 记录不存在 |
5. 示例
示例1 修改转发规则成功
输入示例
{
"ForwardAddress": [
"1.12.3.1:80",
"2.38.12.2:80"
],
"Remark": "vpcdnss_test",
"RuleId": "48"
}
输出示例
{
"Response": {
"RequestId": "60b257aa-e268-64d8-5397-67b309e5fc67",
"CreatedAt": "2025-06-23 12:59:15",
"RuleId": "48",
"ForwardAddress": [
"1.12.3.1:80",
"2.38.12.2:80"
],
"Remark": "vpcdnss_test"
}
}