创建集群

最近更新时间: 2026-11-06 00:09:55

1. 接口描述

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

创建集群

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

接口更新时间：2023-06-25 14:41:40。

接口既验签名又鉴权。

2. 输入参数

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

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：CreateCluster
Version	是	否	String	公共参数，本接口取值：2020-05-06
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
Description	否	否	String	集群描述示例值： "My Cluster"
ClusterId	是	否	String	集群 id 示例值： "my_cluster"
StorageMode	否	否	String	存储模式示例值： "mysql"
ReadyOnly	否	否	Bool	是否只读示例值： false
ScheduleParamStr	否	否	String	调度策略示例值： "{}"
Creator	是	否	String	创建者示例值： "admin"
Namespace	是	否	String	命名空间示例值： "default"
Database	否	否	Database	当使用外部数据库时，通过该参数配置外部数据库的连接地址、账号登信息示例值：查看

3. 输出参数

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

4. 错误码

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

错误码	描述
ResourceInsufficient	资源不足。
ResourceNotFound.GroupVpcNotExist	事务分组所在vpc不存在。
FailedOperation.GroupClusterQueryFailed	事务分组-协调器集群关联关系查询失败。
ResourceInUse.GroupInUse	事务分组%s协调器%s正在被使用，不可清理。
UnknownParameter	未知参数错误。
FailedOperation.GroupClusterDeleteFailed	事务分组-协调器集群关联关系删除失败。
InvalidParameterValue.DuplicateGroupName	事务分组名称重复。
MissingParameter.GroupIdRequired	事务分组ID称未填写。
AuthFailure	CAM签名/鉴权错误。
LimitExceeded	超过配额限制。
ResourceInUse	资源被占用。
UnsupportedOperation	操作不支持。
FailedOperation.GroupQueryFailed	事务分组查询失败。
FailedOperation	操作失败。
InternalError	内部错误。

5. 示例

示例1 创建 DTF 集群

输入示例

POST / HTTP/1.1
Host: dtf.api3.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: CreateCluster
<Common Parameters>

{
    "Action": "CreateCluster",
    "AppId": 1,
    "ClientIp": "101.226.143.247",
    "ClusterId": "my-dtf",
    "Creator": "dechen",
    "Description": "",
    "Language": "zh-CN",
    "Namespace": "xxx-infra",
    "OperatorUin": "130000000545",
    "Region": "region1",
    "RequestId": "a4be27d9-a512-f6ab-6f38-498e4688d105",
    "RequestSource": "MC",
    "SubAccountUin": "130000000545",
    "Uin": "909619400",
    "Version": "2020-05-06"
}

输出示例

{
    "Response": {
        "RequestId": "a4be27d9-a512-f6ab-6f38-498e4688d105",
        "Result": true
    }
}