All Products
Search
Document Center

Edge Security Acceleration:UpdateSiteInstance

Last Updated:Jul 23, 2026

Changes the plan instance associated with a site.

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

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

SiteId

integer

Yes

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

901109460617712

NewInstanceId

string

Yes

The target instance ID.

esa-site-bckh96ri1eyo

ResourceOwner

integer

No

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

The request ID.

0E50DBC5-0F50-583C-AC2D-87B2764776CF

Examples

Success response

JSON format

{
  "RequestId": "0E50DBC5-0F50-583C-AC2D-87B2764776CF"
}

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 OperationDenied.UnsupportPlan The current plan does not support this operation. Use the correct plan instance to try again. The current plan does not support this operation. Use the correct plan instance to try again.
400 ForbidUpdateSite.PlanUnallowed Site migration between preset plans and customized enterprise plans is not supported. Site migration between preset plans and customized enterprise plans is not supported.
400 ForbidUpdateSite.ConfigurationsUnclosed If there are unclosed configurations, please close them before migrating. If there are unclosed configurations, please close them before migrating.
400 Site.QuotaFull The instance site count quota is full. The instance site count quota is full.
400 InvalidParameter.Coverage The selected location is unavailable in your plan. Change the location to one that is covered by the plan and try again. The selected location is unavailable in your plan. Change the location to one that is covered by the plan and try again.
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.
400 SubSiteUnavailable Subdomains are allowed only in Enterprise plans. Upgrade your plan to add a subdomain to ESA. Your plan does not support creating sites with subdomains, please upgrade your plan.
404 SiteNotFound The website does not exist or does not belong to you. The website does not exist or does not belong to you.
404 UnsupportQuota Unsupported quota is specified. Check and try again. Unsupported quota is specified. Check and try again.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.