nifty-import-instance
処理概要
API「ImportInstance」が実行されます。
また、VMDKファイルをアップロードインターフェースへ送信します。
指定したOVFファイルの情報に基づいて、サーバーインポートを予約します。1回のリクエストで1台のサーバーが作成可能です。
no-uploadオプションを指定した場合、アップロードが中断した場合は、nifty-resume-importで再開してください。
サーバーの作成には、時間がかかることがあります。
「nifty-describe-instances」のレスポンス値「instanceState」でサーバーのステータスを確認できます。
インポートしたサーバーは通常ほかのサーバー作成と同様に課金されますが、ニフクラの基本ディスク容量（Linux:30GB、Windows:80GB）を超えるディスクを持つ場合は100GB単位で追加料金が発生します。
ニフクラがサポートしないOS製品である、複数OSのサーバーであるなどの場合はインポートできず、エラーが返されます。またファイアウォール機能を提供していない環境でファイアウォールグループを指定して実行した場合は、エラーが返されます。
インポート処理開始前にエラーが発生した場合、サーバーは削除されます。
インポート中にエラーが発生した場合、サーバーはその状態で残されます。コントロールパネル画面からエラーを回復してください。
オプション「--ip-type」を指定して、かつオプション「--network」に共通グローバルを指定した場合、エラーが返されます。
インポートしたサーバーは、APIからの削除が可能です。
APIからの削除を禁止したい場合は、インポート完了後にnifty-modify-instance-attributeを実行してください。
80000MB以上のファイルをアップロードする方法について
80000MB以上のファイルをアップロードする場合、no-uploadオプションを指定してインポートを行ってください。
返却されたタスクIDを指定してnifty-resume-importでインポートを再開することが可能です。
コマンド構文
nifty-import-instance VMDKファイルパス [オプション]
オプション
| オプション | 短縮 | 説明 | 必須 |
|---|---|---|---|
| --instance-type サーバータイプ | -t | サーバータイプを指定します。 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 |
|
| --group グループ名 [--group グループ名 ...] |
-g | ファイアウォールグループ名を指定します。 | |
| --no-upload | ディスクイメージをアップロードせず、インポートタスクのみ作成します。 インポートタスクを完了するには、nifty-resume-importを利用します。 |
||
| --instance-id サーバー名 | サーバー名を指定します。 | ||
| --ovf OVFファイル名 | -V | OVFイメージのファイル名を指定します。 | ○ |
| --accounting-type 利用料金タイプ | 利用料金タイプを指定します。 | ||
| --ip-type IPアドレスタイプ | IPアドレスタイプを指定します。 static（固定化）| elastic（付替）| none（グローバルIPなし） |
||
| --availability-zone ZONE | -z | サーバーのゾーンを指定します。 | |
| --upload-url URL | アップロード先のエンドポイントを指定します。 | ||
| --public-ip IPアドレス | 付替グローバルIPアドレスを指定します。 | （IPアドレスタイプがelasticのみ○） | |
| --description DESCRIPTION | メモ情報を指定します。 | ||
| --network "network-id=value, network-name=value, ip-address=value", [ --network " network-id=value, network-name=value, ip-address=value] | サーバーに設定するネットワークID、ネットワーク名、IPアドレスを指定します。 （network-idとnetwork-nameはどちらか1つを指定します。）
|
出力要素
※ニフクラAPIの応答フィールド名を記述します。
- タスクタイプ（IMPORTINSTANCE）
- IDタイプ（DISKIMAGE）
- IMPORTINSTANCE / conversionTaskId
- IMPORTINSTANCE / expirationTime
- IMPORTINSTANCE / instanceId
- IMPORTINSTANCE / instanceUniqueId
- IMPORTINSTANCE / description
- DISKIMAGE / size
- DISKIMAGE / volumeSize
- DISKIMAGE / availabilityZone
- DISKIMAGE / bytesConverted
- DISKIMAGE / status
- DISKIMAGE / statusMessage
- NETWORK_INTERFACE / niftyNetworkId
- NETWORK_INTERFACE / niftyNetworkName
- NETWORK_INTERFACE / status
- NETWORK_INTERFACE / macAddress
- NETWORK_INTERFACE / privateIpAddress
- NETWORK_INTERFACE / privateIpAddressV6
- NETWORK_INTERFACE_ATTACHMENT / deviceIndex
- NETWORK_INTERFACE_ATTACHMENT / status
- NETWORK_INTERFACE_ATTACHMENT / deleteOnTermination
- NETWORK_INTERFACE_ASSOCIATION / publicIp
- NETWORK_INTERFACE_ASSOCIATION / publicIpV6
- （対象ファイル情報）
- （分割送信情報）
- （アップロード進捗）
- （平均速度）
実行サンプル
PROMPT>nifty-import-instance svimg.vmdk -t mini -V svref.ovf -g fwgroup01 --availability-zone east-11 --network “network-id=net-COMMON_GLOBAL” --network “network-id=net-COMMON_PRIVATE”
IMPORTINSTANCE import-1-1-1-1 2011-xx-xxT00:20:12+09:00 new-instance-01 i-abfd1234
DISKIMAGE 2656406016 0 east-11 4367650 active
NETWORK_INTERFACE net-COMMON_GLOBAL available 00-00-00-00-00-00
NETWORK_INTERFACE_ATTACHMENT 0 attached true
NETWORK_INTERFACE_ASSOCIATION 172.16.13.10
NETWORK_INTERFACE net-COMMON_PRIVATE available 00-00-00-00-00-00 10.10.10.10
NETWORK_INTERFACE_ATTACHMENT 0 attaching true
Uploading svimg.vmdk
Uploading 2656406016 bytes across 254 parts
0% |--------------------------------------------------| 100%
|==================================================|
Done
Average speed was 5.359 MBps
