---
title: "getAutoScalingGroupList"
slug: "compute-autoscaling-getautoscalinggrouplist"
updated: 2026-09-17T09:57:45Z
published: 2026-09-17T09:57:45Z
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

## 概要

scaling groupの説明をリスト形式で渡します。 Auto Scaling Group名が指定されていない場合は、ユーザーが保有するすべての Auto Scaling Groupの説明がリスト形式で取得します。 Auto Scaling Group名が指定されている場合は、指定された Auto Scaling Groupの説明だけリスト形式で取得します。

## リクエスト

### リクエストパラメータ

| パラメータ名 | 必須の有無 | タイプ | 制限事項 | 説明 |
| --- | --- | --- | --- | --- |
| autoScalingGroupNameList | No | List | 最小: 1 最大: 255 | 照会対象のオートスケーリンググループ名リストを入力 オートスケーリンググループ名を入力しないと、アカウント内に作成された全リストを表示 オートスケーリンググループ名リストを入力すると、リクエストしたオートスケーリングに対応するリストのみ表示 |
| pageNo | No | Integer | 最小: 0 最大: 2147483647 | リスト照会時に Paginationのページ情報を入力 デフォルトの0を入力した場合、全リストを照会 |
| pageSize | No | Integer | 最小: 0 最大: 2147483647 | リスト照会時に Paginationの1ページ当たりの情報数を入力 デフォルトの0を入力した場合、全リストを照会 |
| sortedBy | No | String | - | `autoScalingGroupName`(オートスケーリンググループ名) `createDate`(作成日時) `default : autoScalingGroupName`(オートスケーリンググループ名) |
| sortingOrder | No | String | - | `ascending`(昇順) `descending`(降順) `default : ascending`(昇順) |
| regionNo | No | String |  | 入力可能な状態は getRegionListアクションを通じて取得可能 |
| responseFormatType | No | String |  | - レスポンス結果の形式タイプ オプション: xml \| json デフォルト: xml |

## レスポンス

### レスポンスボディ

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

## 例

### リクエスト例

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

### レスポンス例

```
<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>
```