根据业务系统 id 获取单元

最近更新时间: 2026-10-11 00:12:05

1. 接口描述

接口请求域名： tsf.api3.fincloud.tencent.com。

根据业务系统 id 获取单元

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

接口更新时间：2026-03-13 14:55:59。

接口只验签名不鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：DescribeUnitsByBusinessSystemIds
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
BusinessSystemIds	是	否	Array of String	业务系统id列表示例值： bs-opy5pa4q

3. 输出参数

参数名称	类型	描述
Result	Array of DeploymentUnit	业务系统列表示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码	描述
InvalidParameterValue.InvalidParameter	参数 %s 取值错误。
MissingParameter.RequiredParameterMissing	%s缺失。

5. 示例

示例1 根据业务系统 id 获取单元

输入示例

{
  "SearchWord": "payment"
}

输出示例

{
  "Response": {
    "RequestId": "12345678-1234-1234-1234-123456789012",
    "Result": {
      "TotalCount": 2,
      "Content": [
        {
          "UnitRouteConfigId": "config-001",
          "UnitRuleId": "unit-rule-12345", 
          "RouteName": "route_TUle",
          "RouteType": "header",
          "RouteKey": "x-unit-flag",
          "RouteValue": "unit-a",
          "Priority": 100,
          "Status": "enabled",
          "CreateTime": "2024-01-15 10:30:00",
          "UpdateTime": "2024-01-15 15:45:00",
          "Description": "Unit route "
        },
        {
          "UnitRouteConfigId": "config-002", 
          "UnitRuleId": "unit-rule-12345",
          "RouteName": "backup_route",
          "RouteType": "cookie",
          "RouteKey": "unit_id", 
          "RouteValue": "unit-b",
          "Priority": 90,
          "Status": "enabled",
          "CreateTime": "2024-01-15 11:00:00",
          "UpdateTime": "2024-01-15 16:20:00", 
          "Description": "unit route B"
        }
      ]
    }
  }
}