ConoHa CLI

Appearance

image ​

VPS イメージ (OS イメージやカスタム ISO) を管理するコマンドグループです。

image list ​

イメージ一覧を表示します (ID / Name / Status / MinDisk / Visibility)。

使い方 ​

bash
conoha image list

image show ​

特定イメージの詳細を表示します。v0.8.0 以降は イメージ名・部分文字列・ID のいずれかで指定できます (crowdy/conoha-cli#190)。

使い方 ​

bash
conoha image show <名前 | 部分文字列 | ID>

例 ​

bash
# UUID で指定
conoha image show aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

# 完全な名前
conoha image show vmi-docker-29-ubuntu-24.04-amd64

# 部分文字列（一意に解決できる場合のみ。曖昧時は候補一覧を表示）
conoha image show docker-29

# image list と組み合わせて絞り込み → show
conoha image list --format table | grep ubuntu-24.04

image create ​

イメージレコードのみを作成します。実際のファイルアップロードは別途 image upload を呼び出します。一気に作成 + アップロードしたい場合は image import を使ってください。

使い方 ​

bash
conoha image create --name <name> [flags]

オプション ​

オプション説明
--nameイメージ名（必須）
--disk-formatディスクフォーマット（デフォルト: iso）
--container-formatコンテナフォーマット（デフォルト: bare）

image upload ​

既存のイメージレコードにファイルをアップロードします。アップロード進捗とサイズが stderr に出力されます。

使い方 ​

bash
conoha image upload <id> --file <path>

オプション ​

オプション説明
--fileアップロードするローカルファイルのパス（必須）

image import ​

image create + image upload を 1 コマンドで実行します。--wait で active ステータスになるまで待機できます。

使い方 ​

bash
conoha image import --name <name> --file <path> [flags]

オプション ​

オプション説明
--nameイメージ名（必須）
--fileアップロードするローカルファイルのパス（必須）
--disk-formatディスクフォーマット（デフォルト: iso）
--container-formatコンテナフォーマット（デフォルト: bare）
--waitactive 状態になるまで待機
--wait-timeout待機タイムアウト（デフォルト: 5m）

動作 ​

  1. CreateImage でレコード作成（ID が stderr に出力）
  2. ファイルをマルチパートアップロード
  3. --wait 指定時はステータスをポーリング (active で成功、killed / deactivated で失敗)
  4. アップロード失敗時はリトライコマンド (conoha image upload <id> --file ...) を案内

image delete ​

イメージを削除します (確認プロンプトあり、--yes で省略可)。

使い方 ​

bash
conoha image delete <id>