UpdateSiteInstance - Edge Security Acceleration - Alibaba Cloud Documentation Center

Replaces the plan instance for 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

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

esa:UpdateSiteInstance

none

*All Resource

*

None

Request syntax

POST  HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
SiteId	integer	Yes	The ID of the site. You can call the ListSites operation to obtain the ID.	901109460617712
NewInstanceId	string	Yes	The target instance ID.	esa-site-bckh96ri1eyo
ResourceOwner	integer	No	The UID of the Alibaba Cloud account that owns the new plan instance.	1700594193617909

Response elements

Element	Type	Description	Example
	object	Schema of Response
RequestId	string	The ID of the request.	0E50DBC5-0F50-583C-AC2D-87B2764776CF

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.

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.