推送单元化灰名单

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

1. 接口描述

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

推送单元化灰名单

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

接口更新时间：2026-01-14 22:23:37。

接口只验签名不鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：ReleaseUnitGrayIds
Version	是	否	String	公共参数，本接口取值：2018-03-26
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Name	否	否	String	灰名单名称示例值： gray-list-bralma
Description	否	否	String	版本描述示例值： gray list release
GrayIdVersion	是	否	String	版本号示例值： ["gr-s-ghskgsl", "gr-s-9hsgm2sg"]
GrayIdContent	是	否	Array of String	灰名单内容，客户 id 列表示例值： ["1255002522"]
UpdatedTime	否	否	String	时间戳示例值： 2026-01-01 10:12:10
DataAppId	否	否	String	数据所属 appId 示例值： 1255002522
DataUin	否	否	String	数据所属 uin 示例值： 100004614767
DataSubAccountUin	否	否	String	数据所属 sub uin 示例值： 100004614767

3. 输出参数

参数名称	类型	描述
Result	Bool	推送结果示例值： true
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

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

错误码	描述
MissingParameter.RequiredParameterMissing	%s缺失。
InternalError.ConsulServerError	配置发布失败：配置中心服务器处理失败。
FailedOperation.UnitConfigCreateFailed	单元配置项创建失败
InvalidParameter.BadRequest	[%s]模块接口[%s]请求不正确（400 BAD REQUEST）。。

5. 示例

示例1 推送单元化灰名单

输入示例

{
  "Name": "gray-list-bralma",
  "Description": "gray list release",
  "GrayIdVersion": [
    "gr-s-ghskgsl",
    "gr-s-9hsgm2sg"
  ],
  "GrayIdContent": [
    "1255002522"
  ],
  "UpdatedTime": "2026-01-01 10:12:10"
}

输出示例

{
  "Response": {
    "RequestId": "9d0fffd3-65ae-432a-9d2c-12e32e79d393",
    "Result": true
  }
}