---
title: "getAutoScalingGroupList"
slug: "compute-autoscaling-getautoscalinggrouplist"
updated: 2026-09-17T10:05:57Z
published: 2026-09-17T10:05:57Z
canonical: "api.ncloud-docs.com/compute-autoscaling-getautoscalinggrouplist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getAutoScalingGroupList

## Overview

Pass descriptions of scaling groups in a list format. If the Auto Scaling Group name is not specified, the description of all Auto Scaling Groups owned by the user is received as a list. If the Auto Scaling Group name is specified, the description of only the specified Auto Scaling Group is received as a list.

## Request

### Request parameters

| Parameter name | Required | Type | Restrictions | Description |
| --- | --- | --- | --- | --- |
| autoScalingGroupNameList | No | List | Min: 1 Max: 255 | Enter the list of auto scaling group names to query. If you do not enter the auto scaling group name, all the lists created in the account will be displayed. If you enter the list of autoscale groups, only the list corresponding to the requested autoscaling will be displayed. |
| pageNo | No | Integer | Min: 0 Max: 2147483647 | Enter the page information of pagination when querying the list. If you enter the default value 0, all lists will be queried. |
| pageSize | No | Integer | Min: 0 Max: 2147483647 | Enter the number of information per page in pagination when querying the list. If you enter the default value 0, all lists will be queried. |
| sortedBy | No | String | - | `autoScalingGroupName` (auto scaling group name) `createDate` (creation date and time) `default : autoScalingGroupName` (auto scaling group name) |
| sortingOrder | No | String | - | `ascending` `descending` `default : ascending` |
| regionNo | No | String |  | You can obtain the status where input is possible through the getRegionList action. |
| responseFormatType | No | String |  | - Format type of the response result Options: xml \| json Default: xml |

## Response

### Response body

- [AutoScalingGroupList](/docs/en/common-apidatatype-autoscalinggrouplist)

## Examples

### Request example

```
{AUTOSCALILNG_API_URL}/getAutoScalingGroupList
?autoScalingGroupNameList.1=asg-1
```

### Response example

```
<getAutoScalingGroupListResponse>
   <requestId>be42c6e2-9c59-4bbc-b9d4-42194a68077d</requestId>
   <returnCode>0</returnCode>
   <returnMessage>success</returnMessage>
   <totalRows>1</totalRows>
   <autoScalingGroupList>
      <autoScalingGroup>
         <autoScalingGroupName>asg-1</autoScalingGroupName>
         <autoScalingGroupNo>***517</autoScalingGroupNo>
         <launchConfigurationName>lc-1</launchConfigurationName>
         <launchConfigurationNo>***013</launchConfigurationNo>
         <desiredCapacity>0</desiredCapacity>
         <minSize>0</minSize>
         <maxSize>0</maxSize>
         <loadBalancerInstanceSummeryList>
            <loadBalancerInstanceSummery>
               <loadBalancerName>slb-1</loadBalancerName>
            </loadBalancerInstanceSummery>
            <loadBalancerInstanceSummery>
               <loadBalancerName>slb-2</loadBalancerName>
            </loadBalancerInstanceSummery>
         </loadBalancerInstanceSummeryList>
         <healthCheckGracePeriod>600</healthCheckGracePeriod>
         <healthCheckType>
            <code>SVR</code>
            <codeName>Server</codeName>
         </healthCheckType>
         <createDate>2014-02-13T17:24:19+0900</createDate>
         <inAutoScalingGroupServerInstanceList />
         <suspendedProcessList />
         <zoneList>
            <zone>
               <zoneNo>2</zoneNo>
               <zoneName>zone2</zoneName>
               <zoneDescription>nang zone</zoneDescription>
            </zone>
            <zone>
               <zoneNo>3</zoneNo>
               <zoneName>zone3</zoneName>
               <zoneDescription>nang zone2</zoneDescription>
            </zone>
         </zoneList>
      </autoScalingGroup>
   </autoScalingGroupList>
</getAutoScalingGroupListResponse>
```