--- title: "createAutoScalingGroup" slug: "compute-vautoscaling-autoscalinggroup-createautoscalinggroup" updated: 2026-09-17T09:57:42Z published: 2026-09-17T09:57:42Z canonical: "api.ncloud-docs.com/compute-vautoscaling-autoscalinggroup-createautoscalinggroup" --- > ## 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. # createAutoScalingGroup VPC環境で利用できます。 Auto Scaling Groupを作成します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET \| POST | /vautoscaling/v2/createAutoScalingGroup | 参考 ガイドは GETメソッドを基準に説明します。POSTメソッドの呼び出しテストは、NAVERクラウドプラットフォームコンソールの API Gatewayサービスの Swaggerで行えます。 ### リクエストヘッダ Auto Scaling APIで共通して使用されるヘッダの詳細は、[Auto Scalingのリクエストヘッダ](/docs/ja/compute-vautoscaling#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `regionCode` | String | Optional | リージョンコード - [getRegionList](/docs/ja/compute-vserver-server-common-getregionlist)を参照 - 照会結果の最初のリージョン(デフォルト) | | `launchConfigurationNo` | String | Required | Launch Configuration番号 - [getLaunchConfigurationList](/docs/ja/compute-vautoscaling-launchconfiguration-getlaunchconfigurationlist)を参照 - Scale-out時に適用する Launch Configurationを指定 | | `autoScalingGroupName` | String | Optional | Auto Scaling Group名 - 英字の小文字、数字、記号の「-」を組み合わせて1~255文字以内で入力 - 文字列の先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - 入力しないと自動作成 (デフォルト) | | `vpcNo` | String | Required | VPC番号 - [getVpcList](/docs/ja/networking-vpc-vpcmanagement-getvpclist)を参照 | | `subnetNo` | String | Required | Subnet番号 - [getSubnetList](/docs/ja/networking-vpc-subnetmanagement-getsubnetlist)を参照 | | `accessControlGroupNoList.N` | Array | Required | ACG番号リスト - [getAccessControlGroupList](/docs/ja/compute-vserver-acg-getaccesscontrolgrouplist)を参照 - Scale-out時に作成されるサーバに適用 - 1~3個以内で入力 - <例> `accessControlGroupNoList.1=1234&accessControlGroupNoList.2=2345` | | `serverNamePrefix` | String | Optional | サーバ名の Prefix - `s` (デフォルト) - 英字の小文字、数字、記号の「-」を組み合わせて3~7文字以内で入力 - 文字列の先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - サーバ名ルール: {Prefix}-{英字\|数字}で、Prefixを除く残りは自動作成 | | `minSize` | Integer | Required | 最小容量: Auto Scaling Groupの最小サーバ数 - 0~30 - `maxSize`以下に設定 - サーバを保有しない場合は0を入力 | | `maxSize` | Integer | Required | 最大容量: Auto Scaling Groupの最大サーバ数 - 0~30 - `minSize`以上に設定 | | `desiredCapacity` | Integer | Optional | 希望する容量: Auto Scaling Groupの希望するサーバ数 - `minSize`以上、`maxSize`以下に設定 (デフォルト: `minSize`と同じ) - 入力値に応じてサーバ数を自動調整 | | `defaultCoolDown` | Integer | Optional | デフォルトのクールダウン(秒) - 0~2147483647 (デフォルト: 300) - Scaling後にサーバを準備するためのモニタリング待機時間 | | `healthCheckGracePeriod` | Integer | Conditional | ヘルスチェックの猶予期間(秒) - 0~2147483647 (デフォルト: 300) - サーバの初期動作を考慮し、ヘルスチェックに失敗してもサーバを異常と判断しない時間 - `healthCheckTypeCode`が`LOADB`の場合、必ず入力 | | `healthCheckTypeCode` | String | Optional | ヘルスチェックタイプコード - `SVR` (デフォルト) \| `LOADB` - `SVR`: サーバ - `LOADB`: ロードバランサ - `LOADB`の場合、`healthCheckGracePeriod`は必ず入力 | | `targetGroupNoList.N` | Array | Optional | Target Group番号リスト - [getTargetGroupList](/docs/ja/networking-vloadbalancer-targetgroup-gettargetgrouplist)を参照 - 各グループのヘルスチェック方式と基準に基づいてサーバの状態を判断 - `healthCheckTypeCode`が`LOADB`の場合にのみ有効 - <例> `targetGroupNoList.1=1234&targetGroupNoList.2=2345` | | `responseFormatType` | String | Optional | レスポンスデータの形式 - `xml`(デフォルト) \| `json` | 参考 リクエストクエリパラメータの入力時、下記の内容をご確認ください。 - `defaultCoolDown`: 新しいサーバが作成されたとしても、初期化スクリプトの実行やアップデートのインストールなどの理由で実際のサービスを実行できるように準備が整うまでは時間がかかります。これを考慮し、実際に Scalingが実行中か、実行完了した後にモニタリングイベントアラームが発生しても反応せず無視させるように設定した期間をクールダウン(Cooldown)時間と定義します。 - `healthCheckGracePeriod`: サーバが作成されて「運用中」に変わったとしても、サーバアップデートのインストールなどの動作により、ヘルスチェックに正常に応答できない場合があります。これを考慮し、ヘルスチェックに失敗してもサーバに異常がないと判断する、ヘルスチェック猶予期間を設定することができます。 ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://ncloud.apigw.ntruss.com/vautoscaling/v2/createAutoScalingGroup ?regionCode=KR &launchConfigurationNo=5891 &vpcNo=4**5 &subnetNo=3***4 &accessControlGroupNoList.1=1***1 &minSize=0 &maxSize=1 &desiredCapacity=0 &healthCheckTypeCode=SVR &responseFormatType=json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `createAutoScalingGroupResponse` | Object | - | レスポンス結果 - [AutoScalingGroupList](/docs/ja/common-vapidatatype-autoscalinggrouplist)を参照 | | `createAutoScalingGroupResponse.requestId` | String | - | リクエスト ID - UUID形式 | | `createAutoScalingGroupResponse.returnCode` | String | - | レスポンスコード | | `createAutoScalingGroupResponse.returnMessage` | String | - | レスポンスメッセージ | ### レスポンスステータスコード Auto Scaling APIで共通して使用されるレスポンスステータスコードの詳細は、[Auto Scalingのレスポンスステータスコード](/docs/ja/compute-vautoscaling#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` { "createAutoScalingGroupResponse": { "totalRows": 1, "autoScalingGroupList": [ { "vpcNo": "4**5", "subnetNo": "3***4", "serverNamePrefix": "", "autoScalingGroupNo": "1***1", "autoScalingGroupName": "as19762e46344", "launchConfigurationNo": "5891", "minSize": 0, "maxSize": 1, "desiredCapacity": 0, "defaultCoolDown": 300, "healthCheckGracePeriod": 300, "healthCheckType": { "code": "SVR", "codeName": "サーバ" }, "createDate": "2025-06-12T15:47:04+0900", "autoScalingGroupStatus": { "code": "CREAT", "codeName": "Created" }, "targetGroupNoList": [], "inAutoScalingGroupServerInstanceList": [], "accessControlGroupNoList": [ "1***1" ], "suspendedProcessList": [] } ], "requestId": "cb3b0c69-****-****-****-179d71217eea", "returnCode": "0", "returnMessage": "success" } } ```