本文へジャンプします。

ニフクラ ユーザーガイド

StartInstances

処理概要

指定したサーバーを起動します。

サーバーを指定するためには、サーバー名が必要です。

サーバーの起動には、時間がかかることがあります。このAPIのレスポンス「currentState.name」を確認して「pending」が返ってきた場合は、API「DescribeInstances」のレスポンス値「instanceState」でサーバーのステータスを確認できます。

NiftyIsBiosをtrueに指定すると、BIOS起動画面で停止した状態となります。コンソールからBIOS設定操作を行ってください。

UserDataを指定してリクエストする場合は、POSTのみの対応となりますので、ご注意ください。

指定するパラメーター

パラメーター 説明 必須
InstanceId.n string サーバー名
InstanceType.n string サーバータイプ
値: e-mini | mini | c-small | e-small | small | c-small2 | e-small2 | small2 | c-small4 | e-small4 | small4 | e-small8 | small8 | e-small16 | small16 | c-medium | e-medium | medium | c-medium4 | e-medium4 | medium4 | c-medium8 | e-medium8 | medium8 | e-medium16 | medium16 | e-medium24 | medium24 | c-large | e-large | large | c-large8 | e-large8 | large8 | e-large16 | large16 | e-large24 | large24 | e-large32 | large32 | e-extra-large8 | extra-large8 | e-extra-large16 | extra-large16 | e-extra-large24 | extra-large24 | e-extra-large32 | extra-large32 | e-extra-large48 | extra-large48 | e-double-large16 | double-large16 | e-double-large24 | double-large24 | e-double-large32 | double-large32 | e-double-large48 | double-large48 | e-double-large64 | double-large64 | e-double-large96 | double-large96 | triple-large48 | triple-large64 | triple-large96 | triple-large128 | quad-large128
Default: 現在の設定値
AccountingType.n string 利用料金タイプ
※変更する場合、翌月からの反映になります。
値: 1 (月額課金) | 2 (従量課金)
Default: 現在の設定値
UserData string サーバー起動時スクリプト
UserData.Encoding string サーバー起動時スクリプトのエンコード
Default: base64
NiftyIsBios boolean BIOS画面起動の可否
値: True (BIOS起動画面で停止) | False (BIOS起動画面で停止しない)
Default: False
Tenancy.n string テナント属性
値: default (通常) | dedicated (専有)
Default: default

応答フィールド

フィールド (項目) 説明
StartInstancesResponse - StartInstancesレスポンス
Ancestor: なし
Children: requestId | instancesSet
requestId string リクエスト識別子
Ancestor: StartInstancesResponse
Children: なし
instancesSet - 対象サーバーの情報セット
Ancestor: StartInstancesResponse
Children: item
item - 対象サーバーの情報
Ancestor: instancesSet
Children: instanceId | instanceUniqueId | currentState | previousState | tenancy
instanceId string サーバー名
Ancestor: item
Children: なし
instanceUniqueId string サーバーユニークID
Ancestor: item
Children: なし
currentState - 現在のサーバーのステータス
Ancestor: item
Children: code | name
code integer 現在のステータスコード
値: 0 (pending) | 16 (running) | 80 (stopped)
Ancestor: currentState
Children: なし
name string 現在のステータス名
値: pending(処理中) | running(起動済み) | stopped(停止済み)
Ancestor: currentState
Children: なし
previousState - 直前のサーバーのステータス
Ancestor: item
Children: code | name
code integer 直前のステータスコード
値: 0 (pending) | 16 (running) | 80 (stopped)
Ancestor: previousState
Children: なし
name string 直前のステータス名
値: pending(処理中) | running(起動済み) | stopped(停止済み)
Ancestor: previousState
Children: なし
tenancy string テナント属性
値: default(通常) | dedicated(専有)
Ancestor: item
Children: なし

リクエストサンプル

    https://jp-east-1.computing.api.nifcloud.com/api/
  ?Action=StartInstances
  &InstanceId.1=server04
  &CommonParams

  

応答サンプル

    <StartInstancesResponse xmlns="https://computing.api.nifcloud.com/api/">
  <requestId>ac501097-4c8d-475b-b06b-a90048ec181c</requestId>
  <instancesSet>
    <item>
      <instanceId>server04</instanceId>
      <instanceUniqueId>i-efba9876</instanceUniqueId>
      <currentState>
        <code>0</code>
        <name>pending</name>
      </currentState>
      <previousState>
        <code>80</code>
        <name>stopped</name>
      </previousState>
      <tenancy>default</tenancy>
    </item>
  </instancesSet>
</StartInstancesResponse>

  

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ

推奨画面サイズ 1024×768 以上