ニフクラAPI (コンピューティング: StartInstances)

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-large32 triple-large48 triple-large64 triple-large96 triple-large128 quad-large64 quad-large96 quad-large128 septa-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>