CreateInstance

最后更新时间：2026-01-23 23:40:15

CreateInstance

最后更新时间： 2026-01-23 23:40:15

1. API Description

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

Creating an instance resource will generate an order for the newly purchased instance resource and automatically complete the payment using the balance of the Tencent Cloud account. The account calling this API must be granted the finace:trade permission; otherwise, the payment will fail.
Currently, the integrated and supported product for purchase includes: Cloud Firewall.

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: CreateInstance.
Version	Yes	String	Common Params. The value used for this API: 2018-07-09.
Region	No	String	Common Params. This parameter is not required for this API.
ClientToken	Yes	String	ClientToken is an unique, case-sensitive string generated by the client with no more than 64 ASCII characters. for example, ClientToken=123e4567-e89b-12d3-a456-42665544****.
ProductCode	Yes	String	Product code.
SubProductCode	Yes	String	Sub-product code.
RegionCode	Yes	String	Region code.
ZoneCode	Yes	String	Availability zone code.
PayMode	Yes	String	Payment mode. Available values: PrePay: upfront charge.
Parameter	Yes	String	Product detailed information.
Quantity	No	Integer	Product quantity, default value is 1.
ProjectId	No	Integer	Project id, default value is 0.
Period	No	Integer	Purchase duration, max number is 36, default value is 1.
PeriodUnit	No	String	Purchase duration unit. valid values: m: month, y: year. default value is: m.
RenewFlag	No	String	Auto-renewal flag. valid values: NOTIFY_AND_MANUAL_RENEW: manually renew, NOTIFY_AND_AUTO_RENEW: automatically renew, DISABLE_NOTIFY_AND_MANUAL_RENEW: renewal is disabled. default value is NOTIFY_AND_MANUAL_RENEW.

3. Output Parameters

Parameter Name	Type	Description
OrderId	String	Order ID
InstanceIdList	Array of String	Instance id list. Empty list will be returned once product delivery is delayed.
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 an Instance

Create a Cloud Workload Protection - Log Analytics instance with a purchase quantity of 1, purchase duration of 1 month, and set auto-renewal.

Input Example

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

{
    "ClientToken": "46E6BF87-AF23-4710-8C82-21032D5F985F",
    "ProductCode": "p_yunjing",
    "SubProductCode": "sp_yunjing_vas",
    "RegionCode": "ap-guangzhou",
    "ZoneCode": "ap-guangzhou-1",
    "PayMode": "PrePay",
    "Parameter": "{\"pid\":1005305,\"productCode\":\"p_yunjing\",\"subProductCode\":\"sp_yunjing_vas\",\"sv_yunjing_vas_la\":\"50\",\"timeSpan\":1,\"timeUnit\":\"m\"}",
    "Quantity": 1,
    "Period": 1,
    "PeriodUnit": "m",
    "ProjectId": 0,
    "RenewFlag": "NOTIFY_AND_AUTO_RENEW"
}

Output Example

{
    "Response": {
        "OrderId": "20251201********",
        "InstanceIdList": [
            "*******"
        ],
        "RequestId": "9792e525-4002-4fb2-8a35-74ebf854bee7"
    }
}

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

Tencent Cloud CLI 3.0

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
AuthFailure.UnauthorizedOperation	No permission.
FailedOperation.BalanceInsufficient	The account balance is insufficient.
FailedOperation.BusinessCheckErrCode	Business side validation failed error code.
FailedOperation.DistributeError	Distribution scenario restricted error.
FailedOperation.GetPriceParamError	Since parameter issue, result in price inquiry failure.
FailedOperation.InvalidDeal	Order status error. Only unpaid orders support payment.
FailedOperation.InvalidGoodsCategoryId	Order type ID is invalid. repurchase.
FailedOperation.NumLimitError	The quantity exceeds the maximum limit.
FailedOperation.dealCreateWhitelistError	Order placement allowlist interception.
InternalError	Internal error.
InternalError.InternalError	Internal system error.
InvalidParameter	Invalid parameter.
InvalidParameter.ApiParamError	Parameter error.
InvalidParameter.InvalidParameter	Parameter error.
UnauthorizedOperation.CertificationNeedUpgrade	Due to account security upgrade, purchase cloud resources requires complete real-name information.
UnauthorizedOperation.NotCertification	The account has not been real-name authenticated, and payment failed.
UnsupportedOperation	Operation unsupported.
UnsupportedOperation.NOT_SUPPORT_THIS_ACTION	This act is not currently supported.

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

是

否

文档反馈

tencent cloud