Help Center/ Auto Scaling/ API Reference/ APIs/ AS Configurations/ Modifying an AS Configuration

Updated on 2026-01-29 GMT+08:00

View PDF

Modifying an AS Configuration

Function

This API is used to modify an AS configuration.

Constraints

This API is only available in the following regions: CN South-Guangzhou, AP-Jakarta, AP-Bangkok, ME-Riyadh, LA-Buenos Aires1, LA-Lima1, TR-Istanbul, RU-Moscow2, CN Southwest-Guiyang1, and CN East-Shanghai2.

Authorization

Each account has all of the permissions required to call all APIs, but IAM users must have the required permissions specifically assigned.

If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.

If you are using identity policy-based authorization, the permission listed below is required.

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
as:scalingConfig:update	write	-	as:ImageId	-	-

URI

PUT /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id}

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the project ID.
scaling_configuration_id	Yes	Array of strings	Specifies the AS configuration ID. For details, see Querying AS Configurations.

Request

**Table 2** Request parameters
Parameter	Mandatory	Type	Description
instance_config	Yes	Object	Specifies the instance configuration. For details, see Table 3.

**Table 3** **instance_config** field description
Parameter	Mandatory	Type	Description
imageRef	Yes	String	Specifies the image ID. Its value is the same as that of image_id for specifying the image selected during ECS creation. You can obtain an image ID by calling the IMS API for querying images. For details, see Querying Images.

Example Request

Change the image ID in the AS configuration 8552e3ad-f1b7-4fb1-a8ee-7f715deef8f0 to 3aa499ee-a1f5-4496-8fa8-746be73a9656.

PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_configuration/8552e3ad-f1b7-4fb1-a8ee-7f715deef8f0

{
  "instance_config": {
    "imageRef": "3aa499ee-a1f5-4496-8fa8-746be73a9656"
  }
}

Response

None

Example Response

None

Returned Values

Normal
204

Abnormal

Returned Value	Description
400 Bad Request	The server failed to process the request.
401 Unauthorized	You must enter the username and password to access the requested page.
403 Forbidden	You are forbidden to access the requested page.
404 Not Found	The server cannot find the requested page.
405 Method Not Allowed	You are not allowed to use the method specified in the request.
406 Not Acceptable	The client does not accept the response generated by the server.
407 Proxy Authentication Required	The client must be authorized by the proxy before the request can proceed.
408 Request Timeout	The request timed out.
409 Conflict	The request cannot be processed due to a conflict.
500 Internal Server Error	Failed to complete the request. The service is abnormal.
501 Not Implemented	Failed to complete the request. The server does not support the requested function.
502 Bad Gateway	Failed to complete the request. The server received an invalid response from the upstream server.
503 Service Unavailable	Failed to complete the request. The system is abnormal.
504 Gateway Timeout	The gateway timed out.