NiftyCreateAutoScalingGroup
処理概要
オートスケール定義を新規作成します。
オートスケール定義を新規作成するには、自身で作成したイメージ(追加ディスクなし)が必要です。
指定したイメージが存在するゾーンに対してオートスケール定義が作成されます。
指定するパラメーター
パラメーター | 型 | 説明 | 必須 |
---|---|---|---|
AutoScalingGroupName | string |
オートスケール名 使用可能文字: 半角英数字(1~15文字) |
○ |
Description | string |
メモ |
|
ImageId | string |
イメージID 使用可能文字: スタンダードイメージ識別子 半角数字1〜4文字以内、カスタマイズイメージ識別子 半角数字1〜15文字以内 |
○ |
InstanceType | string |
サーバータイプ 値:
|
|
SecurityGroup.n | string |
ファイアウォールグループ名 使用可能文字: 半角英数字(1~15文字) |
|
ScalingTrigger.n.Resource | string |
オートスケールのトリガーにするリソース名 値:
|
○ |
ScalingTrigger.n.UpperThreshold | double |
条件「以上」の閾値 使用可能文字: %の場合 0-100、Mbpsの場合 0-1048576 |
○ |
ScalingTrigger.n.BreachDuration | integer |
長さ 単位: 秒 Default: 600 (10分) 使用可能文字: 600(10分) | 1200(20分) | 1800(30分) |
|
ScaleoutCondition | string |
スケールアウトの条件 値:
|
○ |
LoadBalancers.n.Name | string |
ロードバランサー名 使用可能文字: 半角英数字(1~15文字) |
|
LoadBalancers.n.LoadBalancerPort | integer |
待ち受けポート 使用可能文字: 0〜65535の数値 |
○ (LoadBalancers.n.Nameを指定する場合) |
LoadBalancers.n.InstancePort | integer |
宛先ポート 使用可能文字: 0〜65535の数値 |
○ (LoadBalancers.n.Nameを指定する場合) |
MinSize | integer |
サーバーの最小台数 使用可能文字: 1と(サーバー設定上限数−1)の間 |
○ |
MaxSize | integer |
サーバーの最大台数 使用可能文字: MinSizeとサーバー設定上限数の間 |
○ |
InstanceLifecycleLimit | integer |
有効時間 単位: 秒 Default: 18000 (300分) 使用可能文字: 1800(30分)-36000(600分) (1800刻み) |
|
Scaleout | integer |
スケールアウト開始間隔 単位: 秒 Default: 0 (0分) 使用可能文字: 0(0分) | 600(10分) | 1200(20分) | 1800(30分) |
|
DefaultCooldown | integer |
縮退開始間隔 単位: 秒 Default: 1800 (30分) 使用可能文字: 600 (10分)-36000(600分) (600刻み) |
|
ChangeInCapacity | integer |
スケールアウト・縮退台数 使用可能文字: 1, 2, 3, 4, 5 |
○ |
ScalingSchedule.n.TimeZone.StartingTimeZone | string |
スケールアウトを有効にする時間帯(開始) Default: 0 (0:00) 使用可能文字: 0-23 |
|
ScalingSchedule.n.TimeZone.EndingTimeZone | string |
スケールアウトを有効にする時間帯(終了) Default: 24 (1440) 使用可能文字: StartingTimeZoneの値+1-24 |
|
ScalingSchedule.n.Day.SetSunday | string |
スケールアウトを有効にする曜日(日曜日) 値:
|
|
ScalingSchedule.n.Day.SetMonday | string |
スケールアウトを有効にする曜日(月曜日) 値:
|
|
ScalingSchedule.n.Day.SetTuesday | string |
スケールアウトを有効にする曜日(火曜日) 値:
|
|
ScalingSchedule.n.Day.SetWednesday | string |
スケールアウトを有効にする曜日(水曜日) 値:
|
|
ScalingSchedule.n.Day.SetThursday | string |
スケールアウトを有効にする曜日(木曜日) 値:
|
|
ScalingSchedule.n.Day.SetFriday | string |
スケールアウトを有効にする曜日(金曜日) 値:
|
|
ScalingSchedule.n.Day.SetSaturday | string |
スケールアウトを有効にする曜日(土曜日) 値:
|
|
ScalingSchedule.n.DDay.StartingDDay | string |
スケールアウトを有効にする月内日(開始) Default: 1 使用可能文字: 1-31 |
|
ScalingSchedule.n.DDay.EndingDDay | string |
スケールアウトを有効にする月内日(終了) Default: 31 |
|
ScalingSchedule.n.Month.StartingMonth | string |
スケールアウトを有効にする月(開始) Default: 1 使用可能文字: 1-12 |
|
ScalingSchedule.n.Month.EndingMonth | string |
スケールアウトを有効にする月(終了) Default: 12 使用可能文字: StartingMonthの値-12 |
応答フィールド
フィールド (項目) | 型 | 説明 |
---|---|---|
NiftyCreateAutoScalingGroupResponse | - |
NiftyCreateAutoScalingGroupレスポンス |
␣requestId | string |
リクエスト識別子 |
␣return | boolean |
処理ステータス 値:
|
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/
?Action=NiftyCreateAutoScalingGroup
&AutoScalingGroupName=autoscale001
&ImageId=99999
&ScalingTrigger.1.Resource=Server-cpu
&ScalingTrigger.1.UpperThreshold=50
&ScalingTrigger.1.BreachDuration=600
&ScaleoutCondition=or
&MinSize=2
&MaxSize=5
&ChangeInCapacity=2
&CommonParams
応答サンプル
<NiftyCreateAutoScalingGroupResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
<return>true</return>
</NiftyCreateAutoScalingGroupResponse>