查询单元列表

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

1. 接口描述

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

查询单元列表

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

接口更新时间：2026-01-14 20:41:07。

接口只验签名不鉴权。

2. 输入参数

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

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

3. 输出参数

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

4. 错误码

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

错误码	描述
FailedOperation.NoneUnitArchRule	未找到单元化架构规则，请先推送
FailedOperation.UnitConfigQueryFailed	单元配置项查询失败
InternalError.InternalError	tsf-dcfg内部错误
InternalError.UnhandledException	[%s]模块未处理异常。。

5. 示例

示例1 查询单元列表

输入示例

{
    "BusinessSystemId": "bs-opy5pa4q",
    "ZoneId": "50010001"
}

输出示例

{
  "Response": {
    "RequestId": "9d0fffd3-65ae-432a-9d2c-12e32e79d393",
    "Result": {
      "UnitId": "s005",
      "UnitName": "s005",
      "ZoneId": "50010001",
      "ZoneName": "ap-sz-region-jcctest-ops-1",
      "UnitEnvType": "Prod",
      "UnitType": "Global"
    }
  }
}