创建TBDS用户

最近更新时间: 2026-09-17 00:05:48

1. 接口描述

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

该接口用于创建一个TBDS用户，TBDS用户是维护Cam用户（及控制台登录用户）与Ldap用户（为资源管控的ldap组件用户）之间的关系。并统一在TBDS页面上进行维护与操作。创建支持两种方式，从cam中导入和直接创建，直接创建将会同时创建一个同名的Cam用户

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

接口更新时间：2025-07-02 04:33:57。

接口既验签名又鉴权。

2. 输入参数

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

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：CreateUser
Version 是 否 String 公共参数，本接口取值：2019-01-03
Region 是 否 String 公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
IsNew 是 否 Int64 是否新建，1 新建 0 导入
示例值： 1
Users 是 否 Array of UserRequest 用户信息
示例值：查看
LoginToken 否 否 String 登录密码，导入时无需填写，新建时必须填写
示例值： login123456
ClusterToken 是 否 String 用户的集群密码(Ldap密码)
示例值： Cluster@123456
ExpireTime 否 否 String 设置Keytab过期时间，单位为月，计算规则为当前时间加上传入的月数。并且最终时间不能超过2099-12-31 00:00:00.
示例值： 2024-12-01 10:00:00

3. 输出参数

参数名称 类型 描述
Data Array of UserResponse 创建后的用户信息列表
注意：此字段可能返回 null，表示取不到有效值。
示例值：查看
ErrorList Array of ErrorListResponse 创建失败的用户信息和失败原因
示例值：查看
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见公共错误码。

5. 示例

示例1 创建用户

输入示例

POST / HTTP/1.1
Host: tbdsnew.api3.{conf.main_domain}
Content-Type: application/json
X-TC-Action: CreateUser
<公共请求参数>

{
  "IsNew": 1,
  "Users": [
    {
      "Name": "newuser",
      "Remark": "新用户",
      "CamUin": 100012345679,
      "Phone": "13800138001",
      "Email": "newuser@example.com"
    }
  ],
  "LoginToken": "login123456",
  "ClusterToken": "Cluster@123456",
  "ExpireTime": "2024-12-01 10:00:00"
}

输出示例

{
    "Response": {
        "Data": [
            {
                "Id": 3002,
                "Name": "newuser",
                "Remark": "新用户",
                "CreateTime": "2023-12-01 11:00:00",
                "CamUin": 100012345679,
                "Phone": "13800138001",
                "Email": "newuser@example.com"
            }
        ],
        "RequestId": "req-123456815"
    }
}