创建转发规则

最近更新时间: 2026-09-17 00:04:36

1. 接口描述

接口请求域名： vpcdns.api3.fincloud.tencent.cn。

创建转发规则

默认接口请求频率限制：20次/秒。

接口更新时间：2025-06-24 04:56:48。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：CreateForwardRule
Version	是	否	String	公共参数，本接口取值：2019-10-25
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
DomainIdList	是	否	Array of String	私有域ID 示例值： 3
ForwardAddress	是	是	Array of String	转发IP 示例值： ["1.1.1.2:80", "1.2.3.4:80"]
Remark	否	否	String	备注示例值：这是转发规则备注

3. 输出参数

参数名称	类型	描述
RuleIdList	Array of String	转发规则ID 示例值： ["40","41"]
CreatedAt	Datetime	调用时间示例值： 2014-08-03 12:00:00
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameterValue.	参数值错误
InternalError.UndefiendError	错误未定义
InvalidParameter.	参数错误
InvalidParameterValue.RecordNotExist	记录不存在
UnknownParameter.	未知参数
InvalidParameterValue.RecordExist	记录已经存在
InvalidParameterValue.ForwardRuleOverLimit	转发规则超过限制200条

5. 示例

示例1 成功创建转发规则

输入示例

{
  "DomainIdList": [
    "29",
    "75"
  ],
  "ForwardAddress": [
    "1.2.3.1:80",
    "2.38.1.2:80"
  ],
  "Remark": "vpcdnss_test"
}

输出示例

{
  "Response": {
    "RequestId": "6d1755e5-1d86-7a5a-6855-f4d6ab19ceaa",
    "CreatedAt": "2025-06-23 12:56:19",
    "RuleIdList": [
      "47",
      "48"
    ]
  }
}