--- title: "createAutoScalingGroup" slug: "cli-vautoscaling-autoscalinggroup-createautoscalinggroup" tags: ["Auto Scaling"] updated: 2026-10-08T09:44:11Z published: 2026-10-08T09:44:11Z canonical: "cli.ncloud-docs.com/cli-vautoscaling-autoscalinggroup-createautoscalinggroup" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createAutoScalingGroup VPC環境で利用できます。 Auto Scaling Groupを作成します。 ## 構文 `createAutoScalingGroup`構文は次の通りです。 ``` ./ncloud vautoscaling createAutoScalingGroup \ --vpcNo \ --subnetNo \ --accessControlGroupNoList \ --launchConfigurationNo \ --minSize \ --maxSize \ [--desiredCapacity ] \ [--autoScalingGroupName ] \ [--serverNamePrefix ] \ [--defaultCoolDown ] \ [--healthCheckTypeCode ] \ [--healthCheckGracePeriod ] \ [--targetGroupNoList ] \ [--regionCode ] \ [--output ] ``` ## オプション `createAutoScalingGroup`の実行時に指定できるオプションについて説明します。 ### 必須オプション `createAutoScalingGroup`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | VPC番号 - [getVpcList](/docs/ja/cli-vpc-vpcmanagement-getvpclist)を参照 | | `--subnetNo` | String | Required | Subnet番号 - [getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 | | `--accessControlGroupNoList` | List | Required | ACG番号リスト - Scale-out時に作成されるサーバに適用 - 1~3個以内で入力可能 - スペースで区切って複数入力可能 (例: `--accessControlGroupNoList 1234 2345`) - [getAccessControlGroupList](/docs/ja/cli-vserver-acg-getaccesscontrolgrouplist)を参照 | | `--launchConfigurationNo` | String | Required | Launch Configuration番号 - Scale-out時に適用する Launch Configurationを指定 - [getLaunchConfigurationList](/docs/ja/cli-vautoscaling-launchconfiguration-getlaunchconfigurationlist)を参照 | | `--minSize` | Integer | Required | Auto Scaling Groupの最小サーバ数 - `0`~`30` - `maxSize`以下に設定 - サーバを保持しない場合は`0`を入力 | | `--maxSize` | Integer | Required | Auto Scaling Groupの最大サーバ数 - `0`~`30` - `minSize`以上に設定 | | `--healthCheckGracePeriod` | Integer | Conditional | ヘルスチェックの猶予期間 (秒) - サーバの初期処理を考慮し、ヘルスチェックに失敗してもサーバを異常とみなさない時間 - `0`~`2147483647` (デフォルト: `300`) - `healthCheckTypeCode`が`LOADB`の場合、必ず入力 | ### 任意オプション `createAutoScalingGroup`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--desiredCapacity` | Integer | Optional | Auto Scaling Groupの期待サーバ数 - `minSize`以上、`maxSize`以下に設定 (デフォルト: `minSize`) - 入力値に応じてサーバ数を自動調整 | | `--autoScalingGroupName` | String | Optional | Auto Scaling Group名 - 英字の小文字、数字、記号の`-`を組み合わせて1~255文字以内で入力 - 先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - 未入力時、自動作成 | | `--serverNamePrefix` | String | Optional | サーバ名の接頭辞 - `s` (デフォルト) - 英字の小文字、数字、記号の`-`を使用して3~7文字以内で入力 - 先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - サーバ名ルール: {接頭辞}-{英字\|数字}」で、接頭辞以外の部分は自動作成 | | `--defaultCoolDown` | Integer | Optional | クールダウンのデフォルト値 (秒) - `0`~`2147483647` (デフォルト: `300`) - Scaling後のサーバ準備に向けたモニタリングの待機時間 | | `--healthCheckTypeCode` | String | Optional | ヘルスチェックタイプコード - `SVR` (デフォルト) \| `LOADB` - `SVR`: サーバ - `LOADB`: ロードバランサ - `LOADB`の場合、`healthCheckGracePeriod`は必ず入力 | | `--targetGroupNoList` | List | Optional | Target Group番号リスト - `healthCheckTypeCode`が`LOADB`の場合にのみ有効 - 各グループのヘルスチェック方式と基準に基づき、サーバの状態を判断 - スペースで区切って複数入力可能 (例: `--targetGroupNoList 1234 2345`) - [getTargetGroupList](/docs/ja/cli-vloadbalancer-targetgroup-gettargetgrouplist)を参照 | ### 共通オプション `vautoscaling`コマンドで共通して使用するオプションについては、[Auto Scaling (VPC)のオプション](/docs/ja/cli-vautoscaling#%EC%98%B5%EC%85%98)をご参照ください。 ## 例 Auto Scaling Groupの作成リクエストが成功すると、Auto Scaling Groupの構成情報と作成状態が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./ncloud vautoscaling createAutoScalingGroup \ --vpcNo 12345678 \ --subnetNo 23456789 \ --accessControlGroupNoList 67890123 \ --launchConfigurationNo 18305791 \ --minSize 0 \ --maxSize 0 \ --desiredCapacity 0 \ --autoScalingGroupName asg-01 \ --serverNamePrefix test \ --defaultCoolDown 300 \ --healthCheckTypeCode SVR \ --regionCode KR \ --output json ``` ### 出力 出力の例は次の通りです。 ``` { "createAutoScalingGroupResponse": { "totalRows": 1, "autoScalingGroupList": [ { "vpcNo": "12345678", "subnetNo": "23456789", "serverNamePrefix": "test", "autoScalingGroupNo": "20461037", "autoScalingGroupName": "asg-01", "launchConfigurationNo": "18305791", "minSize": 0, "maxSize": 0, "desiredCapacity": 0, "defaultCoolDown": 300, "healthCheckGracePeriod": 300, "healthCheckType": { "code": "SVR", "codeName": "サーバ" }, "createDate": "2026-07-07T10:22:20+0900", "autoScalingGroupStatus": { "code": "CREAT", "codeName": "Created" }, "targetGroupNoList": [], "inAutoScalingGroupServerInstanceList": [], "accessControlGroupNoList": [ "67890123" ], "suspendedProcessList": [] } ], "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "returnCode": "0", "returnMessage": "success" } } ```