NiftyDescribeAutoScalingGroups
処理概要
指定したオートスケールの定義情報を取得します。
オートスケールを指定するためには、オートスケール名が必要です。
オートスケールを指定しない場合、取得できるすべてのオートスケールの定義情報を取得します。
指定するパラメーター
| パラメーター | 型 | 説明 | 必須 |
|---|---|---|---|
| AutoScalingGroupName.n | string |
オートスケール名 使用可能文字: 半角英数字(1~15文字) |
応答フィールド
| フィールド (項目) | 型 | 説明 |
|---|---|---|
| NiftyDescribeAutoScalingGroupsResponse | - |
NiftyDescribeAutoScalingGroupsレスポンス |
| ␣requestId | string |
リクエスト識別子 |
| ␣autoScalingReservationSet | - |
取得したオートスケール情報セット |
| ␣␣item | - |
オートスケール情報 |
| ␣␣␣autoScalingGroupName | string |
オートスケール名 |
| ␣␣␣description | string |
メモ |
| ␣␣␣imageId | string |
イメージID |
| ␣␣␣instanceType | string |
サーバータイプ |
| ␣␣␣groupSet | - |
ファイアウォール情報セット |
| ␣␣␣␣item | - |
ファイアウォール情報 |
| ␣␣␣␣␣groupId | string |
ファイアウォールグループ名 |
| ␣␣␣triggerSet | - |
トリガー情報セット |
| ␣␣␣␣item | - |
トリガー情報 |
| ␣␣␣␣␣resource | string |
リソース |
| ␣␣␣␣␣upperThreshold | double |
条件「以上」の閾値 |
| ␣␣␣␣␣breachDuration | integer |
長さ(秒) |
| ␣␣␣scaleoutCondition | string |
スケールアウトの条件 |
| ␣␣␣loadBalancing | - |
ロードバランサー情報セット |
| ␣␣␣␣item | - |
ロードバランサー情報 |
| ␣␣␣␣␣loadBalancerName | string |
ロードバランサー名 |
| ␣␣␣␣␣loadBalancerPort | integer |
待ち受けポート |
| ␣␣␣␣␣instancePort | integer |
宛先ポート |
| ␣␣␣minSize | integer |
スケールアウトするサーバーの最小台数 |
| ␣␣␣maxSize | integer |
スケールアウトするサーバーの最大台数 |
| ␣␣␣instanceLifecycleLimit | integer |
スケールアウトサーバーの有効時間(秒) |
| ␣␣␣scaleout | integer |
スケールアウト開始間隔(秒) |
| ␣␣␣defaultCooldown | integer |
縮退開始間隔(秒) |
| ␣␣␣changeInCapacity | integer |
スケールアウト/縮退台数 |
| ␣␣␣scheduleSet | - |
スケジュール情報セット |
| ␣␣␣␣item | - |
スケジュール情報 |
| ␣␣␣␣␣timeZone | - |
スケールアウトを有効にする時間帯 |
| ␣␣␣␣␣␣startingTimeZone | string |
開始時間帯 |
| ␣␣␣␣␣␣endingTimeZone | string |
終了時間帯 |
| ␣␣␣␣␣day | - |
スケールアウトを有効にする曜日 |
| ␣␣␣␣␣␣setSunday | string |
日曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣␣setMonday | string |
月曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣␣setTuesday | string |
火曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣␣setWednesday | string |
水曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣␣setThursday | string |
木曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣␣setFriday | string |
金曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣␣setSaturday | string |
土曜日の設定 備考: 返却値 0(無効),1(有効) |
| ␣␣␣␣␣dDay | - |
スケールアウトを有効にする月内日 |
| ␣␣␣␣␣␣startingDDay | string |
月内開始日 |
| ␣␣␣␣␣␣endingDDay | string |
月内終了日 |
| ␣␣␣␣␣month | - |
スケールアウトを有効にする月 |
| ␣␣␣␣␣␣startingMonth | string |
開始月 |
| ␣␣␣␣␣␣endingMonth | string |
終了月 |
| ␣␣␣placement | - |
ゾーン情報 |
| ␣␣␣␣availabilityZone | string |
ゾーン名 |
| ␣␣␣instancesSet | - |
スケールアウトサーバー情報セット |
| ␣␣␣␣item | - |
スケールアウトサーバー情報 |
| ␣␣␣␣␣instanceId | string |
サーバー名 |
| ␣␣␣␣␣instanceUniqueId | string |
サーバーのユニークID |
| ␣␣␣␣␣instanceState | - |
サーバーステータス |
| ␣␣␣␣␣␣code | integer |
ステータスコード |
| ␣␣␣␣␣␣name | string |
ステータス名 |
| ␣␣␣␣␣dnsName | string |
グローバルIPアドレス |
| ␣␣␣␣␣instanceType | string |
サーバータイプ |
| ␣␣␣␣␣expireTime | timestamp |
有効時間 表示形式: yyyy-mm-ddThh:mm:ssZ |
| ␣␣␣alarm | string |
アラーム状態 備考: 返却値 0(正常),1(スケールアウト中),2(縮退中) |
| ␣␣␣createdTime | timestamp |
オートスケール設定の作成日時 表示形式: yyyy-mm-ddThh:mm:ssZ |
リクエストサンプル
https://jp-east-1.computing.api.nifcloud.com/api/
?Action=NiftyDescribeAutoScalingGroups
&CommonParams
応答サンプル
<NiftyDescribeAutoScalingGroupsResponse xmlns="https://computing.api.nifcloud.com/api/">
<requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
<autoScalingReservationSet>
<item>
<autoScalingGroupName>1126AutoScale</autoScalingGroupName>
<description>memo</description>
<imageId>255</imageId>
<instanceType>small4</instanceType>
<groupSet>
<item>
<groupId>1114restTestEx</groupId>
</item>
</groupSet>
<triggerSet>
<item>
<resource>2</resource>
<upperThreshold>90.0</upperThreshold>
<breachDuration>10</breachDuration>
</item>
</triggerSet>
<scaleoutCondition>1</scaleoutCondition>
<loadBalancing>
<item>
<loadBalancerName>afdsa</loadBalancerName>
<loadBalancerPort>80</loadBalancerPort>
<instancePort>80</instancePort>
</item>
</loadBalancing>
<minSize>1</minSize>
<maxSize>98</maxSize>
<instanceLifecycleLimit>30</instanceLifecycleLimit>
<scaleout>10</scaleout>
<defaultCooldown>30</defaultCooldown>
<changeInCapacity>1</changeInCapacity>
<scheduleSet>
<item>
<timeZone>
<startingTimeZone>1</startingTimeZone>
<endingTimeZone>24</endingTimeZone>
</timeZone>
<day>
<setSunday>1</setSunday>
<setMonday>1</setMonday>
<setTuesday>1</setTuesday>
<setWednesday>1</setWednesday>
<setThursday>1</setThursday>
<setFriday>1</setFriday>
<setSaturday>1</setSaturday>
</day>
<dDay>
<startingDDay>1</startingDDay>
<endingDDay>31</endingDDay>
</dDay>
<month>
<startingMonth>1</startingMonth>
<endingMonth>12</endingMonth>
</month>
</item>
</scheduleSet>
<placement>
<availabilityZone>zone_21</availabilityZone>
</placement>
<instancesSet>
<item>
<instanceId>image01_2</instanceId>
<instanceUniqueId>47621</instanceUniqueId>
<instanceState>
<code>16</code>
<name>running</name>
</instanceState>
<dnsName>124.25.69.150</dnsName>
<instanceType>small4</instanceType>
<expireTime>2015-02-13T14:18:55.000+09:00</expireTime>
</item>
</instancesSet>
<createdTime>2015-02-13T09:17:02.000+09:00</createdTime>
<alarm>0</alarm>
</item>
</autoScalingReservationSet>
</NiftyDescribeAutoScalingGroupsResponse>
