UpdateOriginPool - Edge Security Acceleration - Alibaba Cloud Documentation Center

This topic is generated by a machine translation engine without any human intervention. ALIBABA CLOUD DOES NOT GUARANTEE THE ACCURACY OF MACHINE TRANSLATED CONTENT. To request a human-translated version of this topic or provide feedback on this translation, please include it in the feedback form.

Modify the Monitor

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- For mandatory resource types, indicate with a prefix of * .
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
esa:UpdateOriginPool	update	*Site `acs:esa:{#regionId}:{#accountId}:site/{#SiteId}`	none	none

Request parameters

Parameter	Type	Required	Description	Example
Id	long	Yes	The ID of the origin pool, which can be obtained by calling the ListOriginPools interface.	1038520525196928
Enabled	boolean	No	Whether the origin pool is enabled: true: Enabled; false: Disabled.	true
Origins	array<object>	No	Information about the origins added to the origin pool. Multiple origins are passed as an array.
	object	No	Information about the origins added to the origin pool.
Name	string	No	The name of the origin, which must be unique under one origin pool.	origin1
Address	string	No	The address of the origin, e.g., www.example.com.	www.example.com
Enabled	boolean	No	Whether the origin is enabled: true: Enabled; false: Disabled.	true
Header	any	No	The request header to be included when fetching from the origin, supporting only Host.	{ "Host": [ "example.com" ] }
Weight	integer	No	The weight, an integer between 0 and 100.	50
Type	string	No	The type of the origin: ip_domain: IP or domain type origin; OSS: OSS address origin; S3: AWS S3 origin.	OSS
AuthConf	object	No	Authentication information. When the origin is OSS or S3 and requires authentication, you need to pass the related configuration information for authentication.
AuthType	string	No	The type of authentication. public: Public read/write, used when the origin is OSS or S3 and is set to public read/write; private_same_account: Private same account, used when the origin is OSS and the authentication type is private within the same account; private_cross_account: Private cross-account, used when the origin is OSS and the authentication type is private across accounts; private: Used when the origin is S3 and the authentication type is private.	public
AccessKey	string	No	The AccessKey required for private authentication.	yourAccessKeyID
SecretKey	string	No	The SecretKey required for private authentication.	yourAccessKeySecret
Version	string	No	The signature version required when the origin is AWS S3.	v2
Region	string	No	The region of the origin required when the origin is AWS S3.	us-east-1
SiteId	long	Yes	The site ID, which can be obtained by calling the ListSites interface.	216558609793952

Response parameters

Parameter	Type	Description	Example
	object	Schema of Response
RequestId	string	The request ID.	15C66C7B-671A-4297-9187-2C4477247A74
Id	long	Source address pool ID.	1038520525196928

Examples

Sample success responses

JSONformat

{
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
  "Id": 1038520525196928
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParameter	The specified parameter is invalid.	The specified parameter is invalid.
400	SourceNumberExceedLimit	The number of sources in the origin pool exceeds the quota limit.	The number of sources that can be created in the origin pool has reached the upper limit of the package. Please check your package quota and upgrade the package to obtain more quota.
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	OriginPoolNotExist	The specified origin pool does not exist or does not belong to your account or website. Check and try again.	The specified origin pool does not exist or does not belong to your account or website. Check and try again.
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	OriginPoolNameConflict	The specified origin pool name already exists or its hostname conflicts with a load balancer name. Try again with a unique name.	The specified origin pool name already exists or its hostname conflicts with a load balancer name. Try again with a unique name.
400	SourceAddressInvalid	Invalid origin address. Check whether the IP address or domain name is in the valid format.	Invalid origin address. Check whether the IP address or domain name is in the valid format.
400	LockFailed	The system is handling requests you previously submitted. Try again later.	The system is handling requests you previously submitted. Try again later.
400	InvalidParameter.AddressConflict	Duplicate origin addresses. Make sure that each origin address for the same pool is unique.	Duplicate origin addresses. Make sure that each origin address for the same pool is unique.
400	SourceCircleExist	The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.	The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.
404	SiteNotFound	The website does not exist or does not belong to you.	The website does not exist or does not belong to you.

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2025-11-07	API Description Update. The Error code has changed	View Change Details