Viewing Scaling History of an Elastic Resource Pool

Function

This API is used to view scaling history of an elastic resource pool.

Authorization

Each account has full permissions to call all APIs, but its IAM users need permission assignments to do so. For specific permission requirements, refer to Permissions Policies and Supported Actions.

URI

GET /v3/{project_id}/elastic-resource-pools/{elastic_resource_pool_name}/scale-records

**Table 1** URI parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which is used for resource isolation. For details about how to obtain its value, see Obtaining a Project ID.
elastic_resource_pool_name	Yes	String	Elastic resource pool name The value can contain up to 128 characters.

**Table 2** query parameters
Parameter	Mandatory	Type	Description
start_time	No	Long	Start time of the historical scaling records you want to query. The time must be 30 days earlier than the current time and earlier than the end_time. The value is a UNIX timestamp in milliseconds. If start_time is left empty, data generated in the recent seven days before end_time will be queried. The end_time cannot be later than 30 days after the current time. If both start_time and end_time are left empty, data generated in the recent 15 days before the current time will be queried.
end_time	No	Long	End time of the historical scaling records. The value cannot be earlier than the start_time or later than the current time. The value is a UNIX timestamp in milliseconds. If end_time is left empty, data generated since the start_time will be queried. If both start_time and end_time are left empty, data generated in the recent 15 days before the current time will be queried.
status	No	String	Scaling status Options: success fail
offset	No	Integer	Offset Minimum value: 0
limit	No	Integer	Number of records displayed on a page Minimum value: 0 Maximum value: 100

Request Parameters

None

Response Parameters

**Table 3** Response body parameters
Parameter	Type	Description
count	Integer	Number of elements in the array
items	Array of arrays	Data returned in the array For details, see Table 4.

**Table 4** items parameters
Parameter	Type	Description
max_cu	Integer	Maximum number of CUs
min_cu	Integer	Minimum number of CUs
current_cu	Integer	Scaled number of CUs
origin_cu	Integer	Original number of CUs
target_cu	Integer	Target number of CUs
record_time	Long	Operation completion time
status	String	Scaling status, which can be success or failure
fail_reason	String	Failure cause

Example Request

GET https://{endpoint}/v3/{project_id}/elastic-resource-pools/{elastic_resource_pool_name}/scale-records?start_time=1650784624000&end_time=1652625304002&status=&limit=20&offset=1

Example Response

The following is an example for a successful query:

{ 
  "count" : 1, 
  "items" : [ { 
    "max_cu" : 64, 
    "min_cu" : 16, 
    "current_cu" : 16, 
    "target_cu" : 16, 
    "origin_cu" : 16, 
    "record_time" : 1650784624000, 
    "status" : "fail", 
    "fail_reason" : "Internal error, please contact technical support." 
  } ] 
}