All Products
Search
Document Center

Edge Security Acceleration:PurchaseBotInstance

Last Updated:Jul 07, 2026

Purchases a new bot instance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

SiteInstanceId

string

Yes

The site instance.

esa-site-23kde*****

BotInstanceLevel

string

Yes

The bot instance specifications.

Valid values:

  • enterprise_bot :

    Web edition.

  • enterprise_bot_with_app :

    Web/App edition.

enterprise_bot

Response elements

Element

Type

Description

Example

object

The response struct.

RequestId

string

The request ID.

04F0F334-1335-436C-A1D7-6C044FE73368

OrderId

string

The order ID.

31223****11

InstanceId

string

The instance ID.

esa-bot-9v9x3o2***

Examples

Success response

JSON format

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368\n",
  "OrderId": "31223****11",
  "InstanceId": "esa-bot-9v9x3o2***"
}

Error codes

HTTP status code

Error code

Error message

Description

400 CheckOrderFailed Invalid order parameter. Invalid order parameter.
400 InternalError An internal exception occurred, please try again later. An inner exception was triggered. Please try again later.
400 InvalidSiteICP The specified website does not have an ICP filing or the filing information is invalid. Make sure your website is filed and try again. The specified website does not have an ICP filing or the filing information is invalid. Make sure your website is filed and try again.
400 InvalidSiteName Invalid website name. Check and try again. Invalid website name. Check and try again.
400 SYSTEM.NoSpecificCodeFailed Invalid subscription duration. Check and try again. Invalid subscription duration. Check and try again.
400 CheckPlanFailed Invalid plan name or code. Check and try again. Invalid plan name or code. Check and try again.
400 SubSiteUnavailable Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA. Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA.
400 InsufficientAvailableQuota Your account balance is insufficient. Your account is in arrears, please pay the arrears before purchasing.
400 InsufficientBalance Your account balance is insufficient. Your account balance is insufficient, please recharge before purchasing.
400 InvalidComponent The order parameters is invalid. The order parameters is invalid.
400 RamAuthFailed The sub-account has no operation permission. The RAM user does not have the required operation permissions.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.