All Products
Search
Document Center

Edge Security Acceleration:CheckSiteFeaturesMatchPlan

Last Updated:Jul 15, 2026

Validates whether a site is compatible with the target plan during site plan migration.

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 syntax

GET  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

NewInstanceId

string

Yes

The target instance ID.

esa-site-b0bivjxucjk0

SiteId

integer

Yes

The site ID. You can call the ListSites operation to obtain the site ID.

861405331573200

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

65705631-908C-5D24-997C-17E0397721C8

IsPassed

boolean

Indicates whether the features of the current site are compatible with the target instance.

true

UnPassedSiteQuotas

array<object>

The information about site quotas that do not meet the requirements.

object

QuotaName

string

The quota name.

cache_reserve

CurrentQuotaValue

string

The quota value of the current site.

true

DestQuotaValue

string

The quota value of the target instance.

false

Examples

Success response

JSON format

{
  "RequestId": "65705631-908C-5D24-997C-17E0397721C8",
  "IsPassed": true,
  "UnPassedSiteQuotas": [
    {
      "QuotaName": "cache_reserve",
      "CurrentQuotaValue": "true",
      "DestQuotaValue": "false"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 InternalException Failed to call the service. Try again later or contact technical support. Failed to call the service. Try again later or contact technical support.
400 InvalidParameter.FunctionName The specified feature does not exist. Specify a valid feature name based on the related documentation. The specified feature does not exist. Specify a valid feature name based on the related documentation.
400 FunctionQuotaCheckFailed The quota verification for this function fails. It may be that the configuration of this function exceeds the limit of the site plan. Please check the plan introduction document corresponding to this site. The current plan does not support the configuration of restricted functions, please check the plan related function description.
400 InstanceNotExist The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account. The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account.
400 Instance.NotOnline Your plan is unavailable due to an overdue payment. Complete the payment first. Your plan is unavailable due to an overdue payment. Complete the payment first.
400 NoPermission You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user. You do not have permissions to access or operate on the resource.Contact your account administrator to attach the AliyunESAFullAccess policy to the current user.
400 CheckPlanFailed Invalid plan name or code. Check and try again. Invalid plan name or code. Check and try again.
400 ServiceInvokeFailed The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details. Failed to call the service. Please try again later or contact customer service for details.
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 Site.QuotaFull The instance site count quota is full. The instance site count quota is full.
400 QuotaCheckFailed.CustomPort The current package does not support configuring custom ports. Please check the package description and upgrade your package. The current package does not support configuring custom ports. Please check the package description and upgrade your package.
400 Site.HasIpaEnableKeepAliveProtection The site has one or more TCP/UDP proxied applications with keep-alive-protection enabled. Its acceleration region or plan can't be edited. The site has one or more TCP/UDP proxied applications with keep-alive-protection enabled. Its acceleration region or plan can't be edited.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.