查询配置发布信息

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

1. 接口描述

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

查询配置发布信息

默认接口请求频率限制:10000次/秒。

接口更新时间:2025-08-06 23:23:55。

接口只验签名不鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数,本接口取值:DescribeConfigReleases
Version 是 否 String 公共参数,本接口取值:2018-03-26
Region 是 否 String 公共参数,地域信息可通过DescribeRegions接口查看产品支持的地域列表
ConfigId 否 否 String 配置ID,不传入时查询全量
示例值:
ApplicationId 否 否 String 应用ID,不传入时查询全量
示例值:
ConfigName 否 否 String 配置项名称,不传入时查询全量
示例值:
GroupId 否 否 String 部署组ID,不传入时查询全量
示例值:
NamespaceId 否 否 String 命名空间ID,不传入时查询全量
示例值:
ClusterId 否 否 String 集群ID,不传入时查询全量
示例值:
Limit 否 否 Int64 每页条数
示例值:
Offset 否 否 Int64 偏移量
示例值:

3. 输出参数

参数名称 类型 描述
Result TsfPageConfigRelease 分页的配置发布信息
示例值:查看
RequestId String 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码 描述
InvalidParameter.ParamError 参数错误。
UnauthorizedOperation.NoPrivilege 用户无权限访问该接口。。
FailedOperation.TsfPrivilegeError TSF权限模块异常,请联系系统管理员。。
InternalError.UnhandledException [%s]模块未处理异常。。
ResourceNotFound.MicroserviceOffline 目标微服务已离线[%s]。。
UnauthorizedOperation.NoLicense 缺少License。。
FailedOperation.ConfigGroupQueryFailed 部署组查询失败。
FailedOperation.ConfigReleaseQueryFailed 配置项发布信息查询失败。

5. 示例

示例1 查询配置发布信息

输入示例

POST / HTTP/1.1
Host: tsf.api3.fincloud.tencent.com
Content-Type: application/json
X-TC-Action: DescribeConfigReleases
<Common Parameters>

{
  "ConfigName": "app-config",
  "GroupId": "group-aln2284v",
  "NamespaceId": "namespace-vw8oox6v",
  "ClusterId": "cluster-yne99jdy",
  "Limit": 10,
  "Offset": 0,
  "ConfigId": "dcfg-yo82mmra",
  "ApplicationId": "application-a7rwwz4v"
}

输出示例

{
  "Response": {
    "RequestId": "16fa1e0b-d3e8-4b1f-b15f-e1d01966acb7",
    "Result": {
      "Content": [
        {
          "ApplicationId": "application-a7rwwz4v",
          "ClusterId": "cluster-yne99jdy",
          "ClusterName": "cluster-app",
          "ConfigCenters": [
            {
              "ConfigCenterInstanceId": null,
              "ConfigCenterInstanceName": null,
              "ConfigType": "SHARE",
              "CurrentVersion": null,
              "RegionId": null,
              "TargetVersion": null
            }
          ],
          "ConfigId": "dcfg-yo82mmra",
          "ConfigName": "app-config",
          "ConfigReleaseId": "dcfgr-yxd366ov",
          "ConfigVersion": "v3",
          "GroupId": "group-aln2284v",
          "GroupName": "group-provider",
          "NamespaceId": "namespace-vw8oox6v",
          "NamespaceName": "cluster-app_default",
          "ReleaseDesc": "This is desc",
          "ReleaseTime": "2024-12-24 15:57:15"
        }
      ],
      "TotalCount": 1
    }
  }
}