Skip to content

List Auto Scaling Group Scale Events

GET
/notebooks/autoscale-groups/{group_id}/scale-events/
curl --request GET \
--url 'https://api.e2enetworks.com/myaccount/api/v1/gpu/notebooks/autoscale-groups/{group_id}/scale-events/?project_id=<PROJECT_ID>&location=<LOCATION>&apikey=<API_KEY>' \
--header 'Authorization: Bearer <API_TOKEN>'

Returns the changes in the number of VMs of an Auto Scaling Group, and changes to its minimum and maximum, newest first. Send page or page_size to get the list in pages; without them every event comes back.

group_id
required
integer

Auto Scaling Group ID

project_id
required
integer

Project ID

page
integer
default: 1 >= 1

Page number, starting at 1. Send page, page_size or both to get the list in pages; send neither to get every entry as a plain array.

page_size
integer
default: 50 >= 1 <= 200

Entries per page. At most 200; a larger number is treated as 200.

active_iam
integer

Active IAM ID (To access contact person account) Find your Active IAM ID here

location
required
string
Allowed values: Delhi Chennai

Location

The list

Media typeapplication/json
object
code
integer
message
string
data
One of:

Without page and page_size: every entry, newest first.

Array<object>
object
id
integer
event_type

scale_up or scale_down when the number of VMs changed; band_change when the group’s minimum and maximum changed and the number of VMs did not.

string
Allowed values: scale_up scale_down band_change
from_replicas

Number of VMs before the change.

integer
to_replicas

Number of VMs after the change.

integer
band_before

For example {"min": 2, "max": 5}, before the change. Set when the minimum and maximum changed, including on a scale_up or scale_down event that the change caused; otherwise null.

object
band_after

For example {"min": 3, "max": 5}, after the change. Set when the minimum and maximum changed, including on a scale_up or scale_down event that the change caused; otherwise null.

object
triggered_by

What caused it: metric for usage-based scaling, schedule for a schedule, manual for a person (Scale Now or an edit).

string
Allowed values: metric schedule manual
performed_by

ID of the person who did it. null for metric and schedule events and for a manual hold that ran out.

integer
nullable
actor

Email of that person. null when performed_by is null.

string
nullable
occurred_at

When the change was noticed.

string
nullable
detail

Extra facts about the event, such as the schedule’s policy_id and policy_name. The keys vary by event.

object
scheduled_policy

{"id": 12, "name": "Morning"} when a schedule caused it. null otherwise. It keeps the name the schedule had at that time.

object
trigger_metric

The reading that triggered a usage-based change: cpu, memory, network, or the name of the group’s custom metric. null for schedule and manual events.

string
nullable
trigger_value

The value of that reading when the change was noticed.

number
nullable
trigger_target

The target of the group for that reading.

number
nullable
completed_at

When the change finished. null while it is pending, if it failed, and on older records.

string
nullable
duration_seconds

Seconds from occurred_at to completed_at. null when completed_at is null.

integer
nullable
errors
object

Example

{
"code": 200,
"message": "Success",
"data": {
"count": 1,
"next": null,
"previous": null,
"page": 1,
"page_size": 50,
"results": [
{
"id": 318,
"event_type": "scale_up",
"from_replicas": 2,
"to_replicas": 3,
"band_before": null,
"band_after": null,
"triggered_by": "metric",
"performed_by": null,
"actor": null,
"occurred_at": "2026-10-21T11:17:42+00:00",
"detail": {},
"scheduled_policy": null,
"trigger_metric": "cpu",
"trigger_value": 72.4,
"trigger_target": 60,
"completed_at": "2026-10-21T11:19:05+00:00",
"duration_seconds": 83
}
]
},
"errors": {}
}

page or page_size is not a whole number. errors is “Project ID is missing or invalid” when project_id is missing or not a number.

Media typeapplication/json
object
code
integer
message
string
data
object
errors
string

Example

{
"code": 400,
"message": "Bad Request",
"data": {},
"errors": "page and page_size must be integers."
}

No Auto Scaling Group with that ID in the project and region.

Media typeapplication/json
object
code
integer
message
string
data
object
errors
string

Example

{
"code": 404,
"message": "Bad Request",
"data": {},
"errors": "Autoscale Group not found"
}