--- title: "Auto Scaling groups and policies" slug: "auto-scaling-policies" source: "https://app.cloudpe.com/help/auto-scaling-policies" updated: "2026-09-27T20:31:29.853Z" --- # Auto Scaling groups and policies ## Overview Auto Scaling allows you to dynamically adjust the capacity of virtual machine fleets in response to real-time workload demands and scheduled timetables. The **Auto Scaling** console manages dynamic capacity across three primary tabs: **VM Groups** (the collections of virtual machines and capacity boundaries), **Policies** (the metric-based or schedule-based scaling rules), and **Events** (the execution audit log of evaluated actions and pending sign-offs). When traffic surges or resource utilization exceeds configured thresholds, Auto Scaling automatically scales out additional virtual machines. When demand subsides, it scales in surplus capacity to minimize unnecessary infrastructure spend. ## Before you start - You need the `vms:read` permission to view groups, policies, and scaling execution history. - Creating or editing VM groups, configuring scaling policies, and approving or cancelling scaling events require the `vms:manage` permission. - Provision baseline instances before creating a VM group. See [Creating and managing virtual machines](/help/create-manage-virtual-machines). - Scale-out operations provision standard billable instances subject to available project quotas and account wallet balances. - If your workload distributes traffic across instances, connect your VM group behind a load balancer. See [Load balancers](/help/load-balancer-setup). ## Steps ### Create a VM group 1. In the sidebar, open **Auto Scaling** under **COMPUTE**. 2. On the **VM Groups** tab, select **Create Group**. ![](/kb/compute/auto-scaling-policies-01-groups.png) 3. In the **Create VM Group** modal, provide a descriptive group name, specify minimum and maximum instance count boundaries, and configure the default cooldown duration between scaling actions. 4. Select the initial member virtual machines and save the group. ![](/kb/compute/auto-scaling-policies-03-create-group.png) ### Define scaling policies 1. Switch to the **Policies** tab and select **Create Policy**. ![](/kb/compute/auto-scaling-policies-02-policies.png) 2. In the policy wizard, select the target VM group and configure the policy parameters. 3. Select the policy type: - Horizontal scaling adjusts instance counts across a VM group. - Vertical scaling scales a single VM flavor up or down. - Scheduled scaling adjusts target instance counts on a recurring cron timetable. 4. For horizontal and vertical policies, choose the scaling type: - Simple threshold applies a fixed instance count or percentage step when a threshold is breached. - Step adjustments applies tiered scaling adjustments across lower and upper metric breach ranges. - Target tracking dynamically adjusts capacity to keep an evaluation metric near a specified target value. 5. Select the evaluation metric (such as CPU Usage, Memory Usage, Disk Usage, CPU I/O Wait, or GPU metrics), operator, threshold value, and scaling direction (scale out, scale in, resize up, or resize down). 6. Configure the sustained breach duration in seconds (duration_seconds, default 300 seconds; set to 0 to fire immediately on the first evaluation breach) and the cooldown delay (cooldown_seconds, default 300 seconds, minimum 60 seconds). 7. Enable or disable manual approval (approval_required, default true). When enabled, scaling actions enter a pending state for operator review. 8. For scheduled policies, define a five-field cron expression, target instance count, and timezone (default UTC). 9. Save the policy. ### Review scaling events 1. Switch to the **Events** tab to monitor real-time evaluation logs and execution history. 2. Select **Refresh** to load the latest evaluation entries. 3. For policies configured with manual approval enabled, review pending events and select approve or cancel as needed. 4. Open the VM detail page for any group member under **Instances** to verify its associated scaling group membership row. ## API Automate Auto Scaling configurations through the REST API. | Method and path | Permission | |---|---| | `GET /api/v1/vm-groups` | `vms:read` | | `POST /api/v1/vm-groups` | `vms:manage` | | `GET /api/v1/vm-groups/{group_id}` | `vms:read` | | `PATCH /api/v1/vm-groups/{group_id}` | `vms:manage` | | `DELETE /api/v1/vm-groups/{group_id}` | `vms:manage` | | `POST /api/v1/vm-groups/{group_id}/members` | `vms:manage` | | `DELETE /api/v1/vm-groups/{group_id}/members/{vm_id}` | `vms:manage` | | `GET /api/v1/vm-groups/by-vm/{vm_id}` | `vms:read` | | `GET /api/v1/scaling-policies` | `vms:read` | | `POST /api/v1/scaling-policies` | `vms:manage` | | `GET /api/v1/scaling-policies/{policy_id}` | `vms:read` | | `PATCH /api/v1/scaling-policies/{policy_id}` | `vms:manage` | | `DELETE /api/v1/scaling-policies/{policy_id}` | `vms:manage` | | `GET /api/v1/scaling-events` | `vms:read` | | `GET /api/v1/scaling-events/{event_id}` | `vms:read` | | `POST /api/v1/scaling-events/{event_id}/approve` | `vms:manage` | | `POST /api/v1/scaling-events/{event_id}/cancel` | `vms:manage` | List VM groups: ```bash curl https://app.cloudpe.com/api/v1/vm-groups \ -H "Authorization: Bearer " ``` List scaling policies: ```bash curl https://app.cloudpe.com/api/v1/scaling-policies \ -H "Authorization: Bearer " ``` Add a member VM to a VM group: ```bash curl -X POST https://app.cloudpe.com/api/v1/vm-groups//members \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{ "vm_id": "", "role": "member" }' ``` Approve a pending scaling event: ```bash curl -X POST https://app.cloudpe.com/api/v1/scaling-events//approve \ -H "Authorization: Bearer " ``` Cancel a pending scaling event: ```bash curl -X POST https://app.cloudpe.com/api/v1/scaling-events//cancel \ -H "Authorization: Bearer " ``` ## Limits & billing - Instances added during scale-out operations are standard virtual machines metered on compute flavor, attached storage, and public IP allocations. - Scale-out activities respect project resource quotas and will not exceed maximum instance boundaries. - Cooldown durations prevent rapid thrashing by enforcing a stabilization delay between consecutive scaling actions. - If additional capacity is needed beyond current quotas, submit a quota expansion request. See [Estimating costs and requesting capacity](/help/capacity-planning-requests). ## Troubleshooting | Message | What it means | What to do | |---|---|---| | `Scaling policy not found.` | The specified policy identifier does not exist or has been deleted. | Refresh the **Policies** tab or call `GET /api/v1/scaling-policies` to retrieve valid identifiers. | | `Scaling event not found.` | The requested scaling event identifier does not exist in the active organization. | Open the **Events** tab to verify available event records. | | `VM group not found.` | The specified VM group identifier does not exist or has been deleted. | Refresh the **VM Groups** tab or call `GET /api/v1/vm-groups` to retrieve valid group identifiers. | | `VM is not a member of this group.` | The specified virtual machine is not associated with this scaling group. | Verify the member virtual machine identifier or add it using `POST /api/v1/vm-groups/{group_id}/members`. | | `VM or VM group not found.` | The requested VM or VM group could not be found in your organization scope. | Verify resource identifiers and confirm that the active organization is selected. | ## FAQ **What happens if a scale-out event exceeds project quota?** If a project reaches its quota limit, scale-out cannot provision additional instances and the failure is logged in the **Events** tab. **Can I configure both metric and scheduled policies on the same VM group?** Yes. You can combine scheduled policies for planned recurring traffic spikes with metric policies for unexpected load fluctuations. ## Related - [Creating and managing virtual machines](/help/create-manage-virtual-machines) - [Load balancers](/help/load-balancer-setup) - [Estimating costs and requesting capacity](/help/capacity-planning-requests)