イメージファイルのダウンロード

対象リージョン:全リージョン

エクスポートした増設ストレージのイメージファイルをオブジェクトストレージからダウンロードします。

事前状況

イメージファイルの保存状況は以下のとおりです。

  • イメージファイル名は、イメージの作成時に指定した<イメージ名>+<.img.gz>、または<イメージ名>+<.qcow2.gz>になります。
  • イメージファイルと一緒にメタデータ(.json)が保存されています。イメージファイル(.img.gz、または.qcow2.gz)と併せてダウンロードしてください。

    注: メタデータは変更しないでください。
  • 東日本リージョン3と西日本リージョン3以外のオブジェクトストレージでは、イメージファイルは分割された状態で保存されます。

    • 分割されたファイルは、<コンテナ名>+<_segments>という別のコンテナに保存されます。

      注: これらの分割ファイルを削除した場合、イメージは利用できなくなります。

ダウンロードの手順

  • 東日本第3/西日本第3リージョン以外の場合、または東日本第3/西日本第3リージョンでオブジェクトストレージ[Swift互換]を利用する場合
    1. トークンの取得

      利用者管理サービスのAPIを実行してトークンを取得します。

      認証トークンのスコープにドメインは指定できません。

    2. 変数の設定
      # OBJECTSTORAGE=<オブジェクトストレージのAPIエンドポイント>
      # TOKEN=<取得したトークン>
      # PROJECT_ID=<プロジェクトID>
      # CONTAINER=<エクスポート先のコンテナ名>
      # IMAGE_FILE=<エクスポートしたイメージファイル名>
      # META_DATA=<エクスポートしたメタデータ名>
    3. オブジェクトの取得

      イメージファイルとメタデータの取得APIを実行します。

      • 東日本リージョン3/西日本リージョン3のオブジェクトストレージからイメージファイルとメタデータを取得する場合
        # curl -H "X-Auth-Token: ${TOKEN}" ${OBJECTSTORAGE}/v2/AUTH_${PROJECT_ID}/${CONTAINER}/${IMAGE_FILE} -o ${IMAGE_FILE}
        # curl -H "X-Auth-Token: ${TOKEN}" ${OBJECTSTORAGE}/v2/AUTH_${PROJECT_ID}/${CONTAINER}/${META_DATA} -o ${META_DATA}
      • 東日本リージョン3/西日本リージョン3以外のオブジェクトストレージからイメージファイルとメタデータを取得する場合

        # curl -H "X-Auth-Token: ${TOKEN}" ${OBJECTSTORAGE}/v1/AUTH_${PROJECT_ID}/${CONTAINER}/${IMAGE_FILE} -o ${IMAGE_FILE}
        # curl -H "X-Auth-Token: ${TOKEN}" ${OBJECTSTORAGE}/v1/AUTH_${PROJECT_ID}/${CONTAINER}/${META_DATA} -o ${META_DATA}
  • 東日本第3/西日本第3リージョンでオブジェクトストレージ[S3互換]を利用する場合
    1. 署名情報の作成

      イメージファイルを取得するAPIのリクエストに必要な署名情報を作成します。署名情報の詳細については「署名情報」を参照してください。

    2. オブジェクトの取得

      オブジェクトストレージ[S3互換]からイメージファイルを取得します。