tencent cloud

APIs

CreateLibraDBClusters

Unduh
Mode fokus
Ukuran font
Terakhir diperbarui: 2026-10-22 10:47:39

1. API Description

Domain name for API request: cynosdb.intl.tencentcloudapi.com.

This API is used to create a TDSQL-C analysis cluster

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: CreateLibraDBClusters.
Version Yes String Common Params. The value used for this API: 2019-01-07.
Region Yes String Common Params. For more information, please see the list of regions supported by the product. This API only supports: ap-bangkok, ap-beijing, ap-chengdu, ap-chongqing, ap-guangzhou, ap-hongkong, ap-jakarta, ap-nanjing, ap-seoul, ap-shanghai, ap-shenzhen-fsi, ap-singapore, ap-tokyo, eu-frankfurt, na-ashburn, na-siliconvalley, sa-saopaulo.
Count Yes Integer Quantity.
Zone Yes String Availability zone
InstanceInitInfos.N Yes Array of LibraDBInstanceInitInfo Instance initialization information
AdminPassword No String user password
AutoRenewFlag No Integer Whether to perform auto-renewal.
AutoVoucher No Integer Whether to automatically select a voucher.
ClusterName No String Cluster name.
DealMode No String Order placement mode
EncryptMethod No String Encryption method
LibraDBVersion No String LibraDBVersion version. Defaults to the latest version.
OrderSource No String Order Source
PayMode No Integer Payment mode
ProjectId No String Project ID
SecurityGroupIds.N No Array of String Security group
TimeSpan No Integer Duration
TimeUnit No String Time unit
ResourceTags.N No Array of Tag Instance creation binds Tag array information
VpcId No String VPC ID of the cluster location
SubnetId No String Subnet ID of the cluster location
Port No String Port.

3. Output Parameters

Parameter Name Type Description
BigDealIds Array of String Prepaid Total Order Number
ClusterIds Array of String Cluster ID
DealNames Array of String Each resource corresponds to a dealName. The business needs to ensure the delivery API idempotency based on the dealName.
TranId String Freeze transaction
ResourceIds Array of String Instance ID.
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Create a TDSQL-C Analysis Cluster

Create a new TDSQL-C analysis cluster

Input Example

POST / HTTP/1.1
Host: cynosdb.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: CreateLibraDBClusters
<Common request parameters>

{
    "Count": 1,
    "Zone": "ap-guangzhou-7",
    "InstanceInitInfos": [
        {
            "Cpu": 4,
            "Memory": 16,
            "StorageSize": 20,
            "StorageType": "",
            "InstanceType": "Common",
            "LibraDBVersion": "",
            "InstanceCount": 1,
            "VpcId": "vpc-nnakli31",
            "SubnetId": "subnet-558rhwt2",
            "Port": 3306
        }
    ],
    "AdminPassword": "root123",
    "ClusterName": "duckduckgogogo",
    "DealMode": "0",
    "OrderSource": "autotest",
    "PayMode": 1,
    "ProjectId": "0",
    "TimeSpan": 1,
    "TimeUnit": "m",
    "ResourceTags": [
        {
            "TagKey": "autotest",
            "TagValue": "autotest"
        }
    ]
}

Output Example

{
    "Response": {
        "BigDealIds": [
            "20250515625002861909831"
        ],
        "ClusterIds": [],
        "DealNames": [
            "20250515625002861909861"
        ],
        "RequestId": "cf0a271a-4c08-42e8-96e2-d00ca6167e48",
        "ResourceIds": [],
        "TranId": ""
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
FailedOperation.CreateOrder Failed to create and pay the order.
FailedOperation.InsufficientBalance Insufficient account balance.
FailedOperation.OperationFailedError Operation failed. Try again later. If the issue persists, contact customer service.
FailedOperation.QuerySpecBySpecCodeError Specification information query failed.
FailedOperation.TradeCreateOrderError Failed to create and pay for the order. Try again later. If the issue persists, contact customer service.
InternalError.DbOperationFailed Query database failed.
InternalError.GetSubnetFailed Failed to obtain the subnet.
InternalError.GetVpcFailed Failed to get the VPC.
InternalError.InternalHttpServerError http request execution error.
InternalError.UnknownError Unknown internal error.
InvalidParameterValue.DBTypeNotFound Unsupported instance type.
InvalidParameterValue.IllegalPassword The password does not meet requirements.
InvalidParameterValue.InvalidDBVersion Invalid instance version.
InvalidParameterValue.InvalidParameterValueError Parameter value is invalid.
InvalidParameterValue.InvalidSpec Invalid instance specification.
InvalidParameterValue.InvalidZoneIdError Invalid AZ.
InvalidParameterValue.ProjectIdNotFound ProjectId not found
InvalidParameterValue.RegionZoneUnavailable The selected region and availability zone are unavailable.
InvalidParameterValue.SubnetNotFound Subnet not found.
InvalidParameterValue.VpcNotFound The selected VPC network is not found.
LimitExceeded.UserInstanceLimit Number of user instances exceeds the limit.
OperationDenied.InsufficientBalanceError Insufficient account balance.
OperationDenied.UserNotAuthenticatedError User not verified with real-name authentication. Please proceed with real-name authentication before purchase.
UnauthorizedOperation.NotRealNameAccount Non-verified users are prohibited from purchasing.
UnauthorizedOperation.PermissionDenied CAM authentication failed.

Bantuan dan Dukungan

Apakah halaman ini membantu?

masukan