创建集群

最近更新时间: 2026-09-17 00:01:37

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	集群描述示例值：
ClusterId	是	否	String	集群 id 示例值：
StorageMode	否	否	String	存储模式示例值：
ReadyOnly	否	否	Bool	是否只读示例值：
ScheduleParamStr	否	否	String	调度策略示例值：
Creator	是	否	String	创建者示例值：
Namespace	是	否	String	命名空间示例值：
Database	否	否	Database	当使用外部数据库时，通过该参数配置外部数据库的连接地址、账号登信息示例值：查看

3. 输出参数

参数名称	类型	描述
Result	Bool	是否成功示例值：
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 示例21

输入示例

POST / HTTP/1.1
Host: dtf.yunapi3.fincloud.tencent.cn
Content-Type: application/json
X-TC-Action: CreateCluster
<公共请求参数>

{
    "Action": "CreateCluster",
    "AppId": 1,
    "ClientIp": "10.25.0.9",
    "ClusterId": "test",
    "Creator": "test",
    "Database": {
        "Address": "192.168.51.69:3306",
        "Password": "lCle7XXs0rsVXSr2NOCV/qvYrBs5OJJCpU+evx59Z5u+WWKAanOs+A/prfA097VFMlVVwMYFjsA29IFo6tePNWcb19EuZpZv44AeUiI21ZnBcot192jWxWnInEWU26ZQOx3mj0OYpSYt3tF8fhwEy4TabdRa3xI8x3ugn0LHtYDXBMSXzQd7TEXso1zzNUNtm7duEb5jvC9rTwT8D5cf2M6/WKkqEEx8Zg4GuvxkLFi3YLn/TGScwv3PPZAITFo/hwcxMXIj1e55Ejydn3v31zWzI49Oaf99HXtop+zzfzJfa3ezoLVH4O+aKcrq5V3M2mQNTnk4L6/95nBl3Il2+g==",
        "User": "auOBhpSIUKYY64/6PbJ2ym9rlI5UBZvMU7s5YvFevXzqQgLmzlj1qY9+UnTo1shFu31tTbustjBBvA/W2OiGRnfWtrOR+hIdI/aistAl88Vzk1QBuSul2jrwKa2Ll9z1gs8vN0Tcy09ebLPOpOv0Kn501cIChiq0fKZ6cRx/zBjEzbeMk2cKwP22zWYEniIgyNNuwHrsFx028jxFu+N2UQCC5WHfCxbdqM4Ta34WiR2HS26XrgU3wZlsioscqleKfnQbbPR7qjg6Giko5+y+M1XLKCH1/t0grXr4lwx+SYIcyEl+CxYlE4mY0fta03mgetVqvqZf/5aoG8fgCHGB2Q=="
    },
    "Language": "zh-CN",
    "Namespace": "test-cq",
    "OperatorUin": "130000000253",
    "Region": "region-name",
    "RequestId": "6fa8b9aa-9c2f-240b-9eee-3e582789b721",
    "RequestSource": "API",
    "SubAccountUin": "130000000253",
    "Uin": "909619400",
    "Version": "2020-05-06"
}

输出示例

{
    "Response": {
        "RequestId": "6fa8b9aa-9c2f-240b-9eee-3e582789b721",
        "Result": true
    }
}