本文へジャンプします。

ニフクラ APIリファレンス

nifty-start-instances

処理概要

API「StartInstances」が実行されます。

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

サーバーを指定するためには、サーバー名が必要です。削除済みのサーバーを指定した、管理外のサーバーを指定したなど、無効なサーバーを指定した場合は、エラーが返されます。

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

オプション「--bios」を指定した場合、BIOS起動画面で停止した状態となります。コンソールからBIOS設定操作を行ってください。

指定したサーバーのサーバータイプが「qlarge256」「slarge256」「olarge256」「olarge384」「olarge512」のいずれかに該当する場合、サーバータイプの変更ができません。サーバータイプを指定すると、エラーが返されます。

コマンド構文

nifty-start-instances サーバー名 [サーバー名,instance-type=サーバータイプ,accounting-type=利用料金タイプ ,tenancy=TENANCY[…]] [オプション]

パラメーター 指定可能値 必須
instance-type=TYPE サーバータイプを指定します。
e-mini | h2-mini | mini | c-small | e-small | h2-small | small | c-small2 | e-small2 | h2-small2 | small2 | c-small4 | e-small4 | h2-small4 | small4 | e-small8 | h2-small8 | small8 | e-small16 | h2-small16 | small16 | c-medium | e-medium | h2-medium | medium | c-medium4 | e-medium4 | h2-medium4 | medium4 | c-medium8 | e-medium8 | h2-medium8 | medium8 | e-medium16 | h2-medium16 | medium16 | e-medium24 | h2-medium24 | medium24 | c-large | e-large | h2-large | large | c-large8 | e-large8 | h2-large8 | large8 | e-large16 | h2-large16 | large16 | e-large24 | h2-large24 | large24 | e-large32 | h2-large32 | large32 | e-extra-large8 | h2-extra-large8 | extra-large8 | e-extra-large16 | h2-extra-large16 | extra-large16 | e-extra-large24 | h2-extra-large24 | extra-large24 | e-extra-large32 | h2-extra-large32 | extra-large32 | e-extra-large48 | h2-extra-large48 | extra-large48 | e-double-large16 | h2-double-large16 | double-large16 | e-double-large24 | h2-double-large24 | double-large24 | e-double-large32 | h2-double-large32 | double-large32 | e-double-large48 | h2-double-large48 | double-large48 | e-double-large64 | h2-double-large64 | double-large64 | e-double-large96 | h2-double-large96 | double-large96 | h2-triple-large32 | triple-large32 | h2-triple-large48 | triple-large48 | h2-triple-large64 | triple-large64 | h2-triple-large96 | triple-large96 | h2-triple-large128 | triple-large128 | h2-quad-large64 | quad-large64 | h2-quad-large96 | quad-large96 | h2-quad-large128 | quad-large128 | h2-septa-large128 | septa-large128
accounting-type=ACTYPE 利用料金タイプを指定します。
1 (月額課金) | 2 (従量課金)
tenancy=TENANCY テナント属性を指定します。
default (通常) | dedicated (専有)

オプション

オプション 短縮 説明 必須
--user-data スクリプト -d Base64エンコード済みのサーバー起動時スクリプトを指定します。  
--user-data-base64 スクリプト   Base64エンコード済みのサーバー起動時スクリプトを指定します。  
--user-data-plain スクリプト   サーバー起動時スクリプトを指定します。  
--user-data-fileファイル -f Base64エンコード済みのサーバー起動時スクリプトファイルを指定します。  
--user-data-file-base64ファイル   Base64エンコード済みのサーバー起動時スクリプトファイルを指定します。  
--user-data-file-plainファイル   サーバー起動時スクリプトファイルを指定します。  
--bios   BIOS起動画面での停止を行う場合指定します。  

出力要素

※ニフクラAPIの応答フィールド名を記述します。

  • INSTANCE / instanceId
  • INSTANCE / instanceUniqueId
  • INSTANCE / previousState,name
  • INSTANCE / currentState,name
  • INSTANCE / tenancy

実行サンプル

PROMPT>nifty-start-instances server01,instance-type=mini,accounting-type=1,tenancy=default
INSTANCE  server01  i-abfd1234  stopped  pending  default

ニフクラ サイト内検索

APIメニュー

  • ツイッターでフォローしてください
  • ニフクラ公式フェイスブックページ
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年5月25日時点の情報です。

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