インスタンス作成時の Block Storage for VPC ボリュームの作成および接続

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックします。
2. 仮想サーバー・インスタンスのリストから、 「作成」 をクリックします。
3. 「VPC プロビジョニング用の仮想サーバー」ページで、「サーバー・タイプ」、「ロケーション」、「OS」、「プロファイル」、「配置グループ」などを選択します。 インスタンスのプロビジョニングについて詳しくは、 UI を使用した仮想サーバー・インスタンスの作成 を参照してください。
4. 作成されるブート・ボリュームの詳細がページに表示されます。 「 編集アイコン 」をクリックしてブートボリュームを編集し、容量の変更、暗号化の設定、およびこのリソースを識別するためのユーザータグの追加を行うことができます。 プロファイルを「 sdp 」または「 general-purpose 」に変更できます。
5. データボリュームを作成してインスタンスに接続するには、データ量インスタンスプロビジョニングページのセクションで、作成する。 サイドパネルで、ボリュームの詳細を指定してください。
   1. 空のデータボリュームを作成するか、スナップショットからインポートしたデータでボリュームを作成することができます。 既存のスナップショットのインポートを選択した場合は、リストから利用可能なスナップショットを選択します。 CRNでスナップショットをインポートを選択した場合、スナップショットのCRNを入力できるようにしておいてください。
   2. ボリュームに、一意で意味のある名前を指定してください。 たとえば、コンピューティングやワークロードの機能を表す名前などが挙げられます。 ボリューム名は小文字で始まる必要があります。 名前は最大63文字の小文字の英数字で、ハイフン（-）を含めることができます。ボリューム名はVPC内で一意でなければなりません。 必要であれば、後で名前を変更することもできます。
   3. 「 自動削除 」機能は、デフォルトでは無効になっています。 接続されている仮想サーバー インスタンスが削除されたときにボリュームも削除する場合は、トグルをクリックして機能を有効にします。
   4. リソース グループと場所はインスタンスから継承されます。 これらの値は変更できません。
   5. このボリュームに関連付けるオプションのユーザー タグを指定できます。 ユーザー・タグを使用したリソースの編成について詳しくは、「 タグの処理」を参照してください。
   6. [ 暗号化 ] セクションでは、プロバイダー管理による暗号化がデフォルトで有効になっています。 独自の暗号化キー を使用するには、トグルをクリックして「 お客様暗号化」を有効にしてください。 すでにKMSインスタンスとルートキーをお持ちの場合は、システムが自動的にそれを選択します。 「 編集アイコン 」をクリックすると、別のキーまたはインスタンスに変更できます。 暗号化キーを見つけるには、次のいずれかのオプションを選択します。
      • インスタンスによる検索 ：このパネルには3つの手順があります：
        1. KMSインスタンスの選択 ：このリストには、利用可能な各 Key Protect インスタンスの名前、ID、タイプ（StandardまたはDedicated）、およびロケーションが表示されます。 インスタンスを選択し、「 選択 」をクリックします。 まだインスタンスをお持ちでない場合は、「 作成 」をクリックしてインスタンスをプロビジョニングしてください。
        2. 関連キー ：このリストには、利用可能な各ルートキーの名前、ID、最終更新日、エイリアス、およびキーリングが表示されています。 キーを選択し、「 選択 」をクリックしてください。 まだキーをお持ちでない場合は、「 新しいキーを作成 」をクリックしてください。
        3. 確認 ：キー管理サービス、インスタンスタイプ、インスタンス名、キー名など、選択内容を確認してください。 「 サービス認証 」セクションでは、 Block Storage for VPC と KMS インスタンス間の必要な認証がすでに設定されているかどうかが表示されます。 そうでない場合は、 Key Protect に認証情報を自動的に作成させるか、手動で作成することができます。 詳細については、「 Block Storage for VPC におけるサービス間認証の設定 」を参照してください。 [ 確認 ] をクリックして選択内容を適用し、ボリューム設定画面に戻ります。
      • Locate by CRN ：ボリュームの暗号化に使用するお客様 CRNを入力します。 別のアカウントのCRKを使用する場合は、このオプションを選択してください。 「選択 」をクリックして、「 インスタンスによる検索 」オプションで説明されている「 確認 」ステップに進みます。
   7. ストレージ プロファイルを選択します。 スナップショットからデータをインポートする場合は、スナップショットのストレージ生成 値が、選択したボリュームプロファイルのストレージ生成値と一致する必要があります。
      • ストレージ容量を最大32,000GBまで指定し、カスタムIOPSおよびスループット制限を設定したい場合は、 sdp プロファイルを 選択できます。
      • 事前に定義されたIOPS階層を持つ第一世代ボリュームを使用したい場合、 _階層化_プロファイルの 1つを選択することができます。 _汎用を_選択した場合、 5iops-tier または 10iops-tier を選択した場合、指定する必要があるのは容量だけです。
      • アプリケーションのパフォーマンス要件がどのIOPS層にも当てはまらない場合は、 カスタム・ プロファイルを選択できます。 ボリュームのサイズとIOPSを、ボリューム容量に適した範囲で指定してください。 ボリュームのサイズは、10～16,000 GBに設定できます。 IOPS 値を入力すると、UI に受け入れ可能な範囲が表示されます。 また、 ストレージサイズのリンクをクリックすると、 カスタムボリュームプロファイルの サイズとIOPSの範囲を確認できます。
   8. ボリュームの作成時にバックアップポリシーを適用できます。 適用] をクリックし、サイドパネルのドロップダウンリストから既存のポリシーを選択します。 ターゲットに適用するタグを選択し、 ポリシーとタグの適用をクリックします。
   9. 保存 をクリックします。
6. 仮想インスタンスのプロビジョニング ページに戻り、仮想サーバー インスタンスの残りの属性の定義を完了します。
7. 選択に満足したら、クリックします仮想サーバーを作成する。

Block Storage for VPC のボリュームは、一度に1つの仮想サーバーにのみアタッチできます。 「 Block Storage for VPC 」のボリューム概要ページでは、「 アタッチされたインスタンス 」の下にあるインスタンス名を選択することで、仮想サーバーインスタンスの詳細を確認できます。

既存のインスタンスからの Block Storage for VPC ボリュームの作成および接続

既存のインスタンスから Block Storage for VPC ボリュームを作成できます。

1. 仮想サーバーインスタンスの一覧に移動します。 IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ コンピュート > 仮想サーバーインスタンス をクリックします。
2. リストからインスタンスを選択します。
3. インスタンスの詳細ページで、 Storage タブをクリックする。
4. アタッチされたストレージボリュームのリストで、 ［アタッチ］をクリックします。
5. サイド・パネルで、 「ブロック・ボリューム」 の下の下矢印をクリックし、 「データ・ボリュームの作成」 を選択します。 サイド・パネルが拡張され、ボリュームを定義するためのフィールドが表示されます。
   1. 以前にボリューム・スナップショットを作成した場合は、それをインポートするオプションが使用可能になります。 スナップショットからインポートへのトグルをクリックし、リストからスナップショットを選択するか、CRNでスナップショットを検索します。
   2. ボリュームに、一意で意味のある名前を指定してください。 たとえば、コンピューティングやワークロードの機能を表す名前などが挙げられます。 ボリューム名は小文字で始まる必要があります。 名前は最大63文字の小文字の英数字で、ハイフン（-）を含めることができます。ボリューム名はVPC内で一意でなければなりません。 必要であれば、後で名前を変更することもできます。
   3. 「 自動削除 」機能は、デフォルトでは無効になっています。 接続されている仮想サーバー インスタンスが削除されたときにボリュームも削除する場合は、トグルをクリックして機能を有効にします。
   4. リソース グループと場所はインスタンスから継承されます。 これらの値は変更できません。
   5. このボリュームに関連付けるオプションのユーザー タグを指定できます。 ユーザー・タグを使用したリソースの編成について詳しくは、「 タグの処理」を参照してください。
   6. [ 暗号化 ] セクションでは、プロバイダー管理による暗号化がデフォルトで有効になっています。 独自の暗号化キー を使用するには、トグルをクリックして「 お客様暗号化」を有効にしてください。 すでにKMSインスタンスとルートキーをお持ちの場合は、システムが自動的にそれを選択します。 「 編集アイコン 」をクリックすると、別のキーまたはインスタンスに変更できます。 暗号化キーを見つけるには、次のいずれかのオプションを選択します。
      • インスタンスによる検索 ：このパネルには3つの手順があります：
        1. KMSインスタンスの選択 ：このリストには、利用可能な各 Key Protect インスタンスの名前、ID、タイプ（StandardまたはDedicated）、およびロケーションが表示されます。 インスタンスを選択し、「 選択 」をクリックします。 まだインスタンスをお持ちでない場合は、「 作成 」をクリックしてインスタンスをプロビジョニングしてください。
        2. 関連キー ：このリストには、利用可能な各ルートキーの名前、ID、最終更新日、エイリアス、およびキーリングが表示されています。 キーを選択し、「 選択 」をクリックしてください。 まだキーをお持ちでない場合は、「 新しいキーを作成 」をクリックしてください。
        3. 確認 ：キー管理サービス、インスタンスタイプ、インスタンス名、キー名など、選択内容を確認してください。 「 サービス認証 」セクションでは、 Block Storage for VPC と KMS インスタンス間の必要な認証がすでに設定されているかどうかが表示されます。 そうでない場合は、 Key Protect に認証情報を自動的に作成させるか、手動で作成することができます。 詳細については、「 Block Storage for VPC におけるサービス間認証の設定 」を参照してください。 [ 確認 ] をクリックして選択内容を適用し、ボリューム設定画面に戻ります。
      • Locate by CRN ：ボリュームの暗号化に使用するお客様 CRNを入力します。 別のアカウントのCRKを使用する場合は、このオプションを選択してください。 「選択 」をクリックして、「 インスタンスによる検索 」オプションで説明されている「 確認 」ステップに進みます。
   7. 次へ をクリックします。
   8. ストレージ プロファイルを選択します。 スナップショットからデータをインポートする場合は、スナップショットのストレージ生成 値が、選択したボリュームプロファイルのストレージ生成値と一致する必要があります。
      • sdp プロファイルを 選択できます。 次に、ボリュームの容量、必要な帯域幅の制限、および必要なIOPSを指定します。 ボリュームのサイズは1～32,000GB。 IOPSは100～64,000の範囲で指定できる。 スループットの制限範囲は1000～8192Mbps。
      • _階層化された_プロファイルの いずれかを選択できます。 _汎用を_選択した後 5iops-tier または 10iops-tier を選択したら、次はボリュームの容量を指定します。 ボリュームのサイズは、10～16,000 GBに設定できます。
      • アプリケーションのパフォーマンス要件がどのIOPS層にも当てはまらない場合は、 カスタム・ プロファイルを選択できます。 次に、ボリュームのサイズとIOPSをボリューム容量に適した範囲で指定します。 ボリュームのサイズは、10～16,000 GBに設定できます。 IOPS 値を入力すると、UI に受け入れ可能な範囲が表示されます。 また、 ストレージサイズのリンクをクリックすると、 カスタムボリュームプロファイルの サイズとIOPSの範囲を確認できます。
   9. 保存 をクリックします。
6. ボリュームの定義が完了したら、 「保存」 をクリックします。 ボリュームが作成され、インスタンスにアタッチされました。 インスタンスの詳細ページに戻ります。 新しいボリュームがストレージボリュームの一覧に表示されます。

スタンドアロン Block Storage for VPC ボリュームの作成

仮想サーバーのプロビジョニングとは独立して、 Block Storage for VPC ボリュームを作成し、後でそのボリュームをインスタンスにアタッチすることができます。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ ストレージ > Block Storage ボリューム をクリックします。

2. 「作成」 をクリックします。

3. 上のBlock Storage for VPCプロビジョニングページで、位置情報。 地理、地域、ゾーンはVPCから継承されます（例：北米、ダラス、Dallas-1 ）。 メニューからあなたの地域の別のゾーンを選択するには、編集アイコン。

4. の中に詳細セクションでは、ボリュームの名前とボリュームを追加するリソース グループを指定する必要があります。 オプションで、ユーザーおよびアクセス管理タグを追加できます。

   1. ボリュームに分かりやすい名前を指定します。 例えば、コンピュート機能やワークロード機能を説明する名前などを指定します。

      ボリューム名は小文字で始まる必要があります。 ボリューム名は、最大 63 文字の小文字の英数字で、ハイフン (-) を含めることができます。ボリューム名は、VPC インフラストラクチャ全体で一意である必要があります。 名前は後で編集できます。

   2. リソース・グループを指定します。

   3. リソースを編成し、 バックアップ・ポリシー で使用するために、 ユーザー・タグ を指定します。

   4. ボリュームへのアクセスの管理に役立つように、IAM で作成された アクセス管理タグ を指定します。

5. の中にオプション構成セクションでは、スナップショットのデータを使用してボリュームを作成するかどうかを指定できます。 詳細については、スタンドアロンを作成するBlock Storage for VPCスナップショットからのボリューム。 また、バックアップ ポリシーを適用することもできます。 「 適用 」をクリックして、利用可能な保険契約やプランを確認してください。

6. プロファイルセクションでは、ボリュームのパフォーマンスプロファイル、パフォーマンス制限、および容量を指定できます。 スナップショットからデータをインポートすることを選択した場合、スナップショットのスト レージ世代値は、選択したボリュームプロファイルのストレージ世代値と一致する必要があります。

   • sdp プロファイルを 選択できます。 次に、ボリュームの容量、要求されるスループット制限、および必要なIOPSを指定します。 ボリュームのサイズは1～32,000GB。 IOPSは100～64,000の範囲で指定できる。 スループットの制限範囲は1000～8192Mbps。
   • _階層化された_プロファイルの いずれかを選択できます。 _汎用を_選択した後 5iops-tier または 10iops-tier を選択したら、次はボリュームの容量を指定します。 ボリュームのサイズは、10～16,000 GBに設定できます。
   • アプリケーションのパフォーマンス要件がどのIOPS層にも当てはまらない場合は、 カスタム・ プロファイルを選択できます。 次に、ボリュームのサイズとIOPSをボリューム容量に適した範囲で指定します。 IOPS 値を入力すると、UI に受け入れ可能な範囲が表示されます。 また、 ストレージサイズのリンクをクリックすると、 カスタムボリュームプロファイルの サイズとIOPSの範囲を確認できます。

7. 「 保存時の暗号化 」セクションでは、すべてのボリュームでデフォルトで有効になっている、 IBM が管理する鍵による暗号化を維持するかどうかの選択が可能です。 あるいは、 独自の暗号化キー を使用することもできます。 キーまたはインスタンスを変更するには、 [編集]アイコン をクリックして、「 暗号化の設定 」サイドパネルを開きます。 暗号化キーを確認するには、以下のオプションから1つを選択してください：

   • インスタンスによる検索 ：このパネルには3つの手順があります：
     1. KMSインスタンスの選択 ：このリストには、利用可能な各 Key Protect インスタンスの名前、ID、タイプ（StandardまたはDedicated）、およびロケーションが表示されます。 インスタンスを選択し、「 選択 」をクリックします。 まだインスタンスをお持ちでない場合は、「 作成 」をクリックしてインスタンスをプロビジョニングしてください。
     2. 関連キー ：このリストには、利用可能な各ルートキーの名前、ID、最終更新日、エイリアス、およびキーリングが表示されています。 キーを選択し、「 選択 」をクリックしてください。 まだキーをお持ちでない場合は、「 新しいキーを作成 」をクリックしてください。
     3. 確認 ：キー管理サービス、インスタンスタイプ、インスタンス名、キー名など、選択内容を確認してください。 「 サービス認証 」セクションでは、 Block Storage for VPC と KMS インスタンス間の必要な認証がすでに設定されているかどうかが表示されます。 そうでない場合は、 Key Protect に認証情報を自動的に作成させるか、手動で作成することができます。 詳細については、「 Block Storage for VPC におけるサービス間認証の設定 」を参照してください。 [ 確認 ] をクリックして選択内容を適用し、ボリュームプロビジョニングページに戻ります。
   • Locate by CRN ：ボリュームの暗号化に使用するお客様 CRNを入力します。 別のアカウントのCRKを使用する場合は、このオプションを選択してください。 「選択 」をクリックして、「 インスタンスによる検索 」オプションで説明されている「 確認 」ステップに進みます。

   ボリュームの作成に第2世代のスナップショットを選択した場合、ボリュームの暗号化タイプとスナップショットの暗号化タイプが一致している必要があります。 スナップショットにプロバイダが管理する鍵がある場合は、鍵管理サービスの鍵を指定しないでください。

8. 完了したらクリックブロックストレージボリュームを作成する。

   • まだ注文する準備ができていない場合、または価格設定情報を探しているだけの場合は、サイド・パネルに表示される情報を見積もりに追加できます。 この機能の仕組みの詳細については、コストの見積もり。

9. 「 Block Storage for VPC 」のボリュームページに戻り、ボリュームが作成中であることを示すメッセージが表示されます（ボリュームのステータスは「 保留中」 です）。 ボリュームが作成されると（ボリュームの状態が「 利用可能 」になると）、2つ目のメッセージが表示されます。

10. 新規ボリュームの詳細を表示するには、2 つ目のメッセージの**「リソースの表示」**リンクを選択して、「ボリューム詳細」ページに移動します。

コンソールで「 Block Storage 」のボリューム一覧を更新すると、新しいボリュームがボリューム一覧の先頭に表示されます。 単体の巻については、「添付タイプ」列は空白（-）となっています。表の行末にある「 アクション 」メニュー には、 Block Storage ボリュームをインスタンスにアタッチする へのリンクが用意されています。

スタンドアロンの作成Block Storage for VPCコンソールのスナップショットからのボリューム

Block Storage for VPC ボリュームを作成 するときに、スナップショットを選択し、そのデータを使用して新規ボリュームを作成できます。 提示されたスナップショットは安定状態にあります。 スナップショットから作成されたデータ・ボリュームはインスタンスに接続されておらず、 Block Storage for VPC ボリュームのリスト に表示されます。 後で、そのボリュームをインスタンスにアタッチすることができます。

「ブート可能」スナップショットからブート・ボリュームをリストアすることができます。 ブート・ボリュームは、仮想サーバー・インスタンスの作成時にリストアされます。

1. IBM Cloud コンソールで、ナビゲーションメニュー アイコン インフラストラクチャ ストレージ > Block Storage ボリューム をクリックします。
2. **「作成」**を選択します。
3. ボリュームの場所、ボリューム名、オプションのリソースグループ、タグを指定します。
4. の中にオプション構成セクションをクリックスナップショットからインポート。 以下の選択肢から1つを選んでください
   • 既存のスナップショットをインポートをクリックすると、利用可能なスナップショットのリストが表示されます。 表示されるスナップショットはすべて_安定_状態です。 デフォルトでは、すべてのデータ ボリューム スナップショットを一覧表示する Nonbootable タブが選択されています。 ブートボリュームを復元するには、ブート可能タブをクリックします。 Attach volume to new virtual server instance はデフォルトで選択されています。 ブート・ボリュームは、インスタンスの作成時に復元されます。
   • CRN によるスナップショットのインポート］をクリックし、使用するスナップショットの CRN を入力します。
5. 保存 をクリックします。 スナップショットに関する情報がボリューム・プロビジョニング・ページに表示されます。これには、名前、サイズ、作成日、ソース・ボリューム、およびブート可能なスナップショットかどうかが含まれます。 ブート可能なスナップショット情報には、オペレーティング・システムとイメージが含まれます。 暗号化はスナップショットから継承され、暗号化セクションに表示されます。
6. [ ブロックストレージボリュームの作成 ] をクリックします。

第一世代と第二世代の体積プロファイルに互換性はない。 第2世代ボリュームのスナップショットを使用して別の第2世代ボリュームを作成することはできますが、ボリューム・プロファイルを第1世代ボリューム・プロファイルに切り替えることはできません。 同様に、第1世代ボリュームのスナップショットを使用して、同じデータを持つ別の第1世代ボリュームを作成することができます。新しいボリュームを sdp プロファイルに切り替えることはできません。

Block Storage for VPC の「ボリューム」ページを更新すると、新しいボリュームがボリューム一覧の一番上に表示されます。 ボリュームが正常に作成された場合は、「使用可能」の状況が表示されます。 スタンドアロン・ボリュームの場合、「接続タイプ」列はブランク (-) です。 表の行の末尾にある 「アクション」 メニュー は、 Block Storage for VPC ボリュームをインスタンスに接続する ためのリンクを提供します。

開始前に

CLI を使用する前に、IBM Cloud CLI および VPC CLI プラグインをインストールする必要があります。 詳しくは、CLI の前提条件を参照してください。

1. IBM Cloud にログインします。

   ibmcloud login --sso -a cloud.ibm.com
   

   このコマンドを実行すると、URL が返され、パスコードの入力を求めるプロンプトが表示されます。 ブラウザーでその URL にアクセスしてログインします。 成功すると、ワンタイム・パスコードが表示されます。 そのパスコードをコピーし、プロンプトに応答として貼り付けます。 認証が成功すると、アカウントの選択を求めるプロンプトが表示されます。 複数のアカウントアクセスできる場合は、ログインしたいアカウントを選択してください。 残りのプロンプトにすべて応答して、ログインを完了します。

CLI からの Block Storage for VPC ボリュームの作成

Block Storage for VPC ボリュームを作成するには、次のコマンドを実行してください。 ボリューム名、プロファイル名、およびリージョン内のアベイラビリティー・ゾーンの名前を指定します。 Block Storage for VPC プロファイルについて詳しくは、 プロファイル を参照してください。 追加のオプションが大括弧で囲まれて表示されます。

有効なボリューム名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 ボリューム名の先頭は小文字にする必要があります。 ボリューム名は、VPC インフラストラクチャー全体で固有でなければなりません。 たとえば、同じアカウントおよびリージョン内で同じ名前のボリュームを2つ作成すると、「 volume name duplicate 」というエラーが発生します。

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--json]

以下の例を参照してください。

ibmcloud is volume-create demovolume1 custom us-east-1 --capacity 500 --iops 3000 --tags env:test,env:prod

Creating volume demovolume1 in resource group Default under account Test Account as user test.user@ibm.com...
ID                                     r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Name                                   demovolume1
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-e45f9c8c-4655-4a3e-9d90-70c2d64d1746
Status                                 pending
Attachment state                       unattached
Capacity                               500
IOPS                                   3000
Bandwidth(Mbps)                        6291
Profile                                custom
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-07-24T16:20:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   env:test,env:prod
Storage Generation                     1

容量はメガバイト単位で表示され、10～16,000 GBの範囲となります。 指定しない場合、デフォルトの容量は 100 GB です。 IOPS の値は、プロファイルとボリューム・サイズに応じて 100 IOPS から 48,000 IOPS の間の値にすることができます。 指定しない場合は、デフォルトでボリューム・プロファイルごとに有効な構成の IOPS 値が設定されます。 詳しくは、カスタム IOPS の表を参照してください。

ボリューム名には、最大 63 文字の英小文字および数字を使用できます。ハイフン (-) も使用できますが、先頭は小文字にする必要があります。 ボリューム名は、VPC インフラストラクチャー全体で固有でなければなりません。

ボリューム ID をメモします。 Block Storage for VPC を仮想サーバーインスタンスにアタッチする場合、 Block Storage for VPC でボリュームの詳細を表示する場合、またはボリュームを削除する場合は、IDを指定する必要があります。

ボリュームの状況が pending である間、ボリュームの正常性の状態は inapplicable と表示されます。 ボリュームが作成された後、作成が失敗しない限り、正常性の状態は OK と表示されます。 詳しくは、 Block Storage for VPC ボリュームの正常性の状態 を参照してください。

ボリューム・リソースを識別するためにユーザー・タグが追加されます。 これらのタグがバックアップ・ポリシー内のタグと一致すると、ボリュームはバックアップ計画内のスケジュールに従ってバックアップされます。 詳しくは、『バックアップ・ポリシーの作成』を参照してください。

スタンドアロン・ボリュームを作成するには、 ibmcloud is volume-create コマンドを実行し、 sdp プロファイル、サイズ、およびボリュームのパフォーマンス要件を指定します。 以下の例では、us-eastリージョンに容量200MB、100IOPSのデータボリュームを作成しています。

ibmcloud is volume-create defined-performance-vol sdp us-east-3 --capacity 200 --iops 3000 --bandwidth 2000

Creating volume defined-performance-vol under account Test Account as user test.user@ibm.com...
ID                                     r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Name                                   defined-performance-vol
CRN                                    crn:v1:bluemix:public:is:us-east-3:a/a1234567::volume:r014-9b41d061-d00c-4571-92c0-f592b91f5cd0
Status                                 pending
Attachment state                       unattached
Capacity                               200
IOPS                                   3000
Bandwidth(Mbps)                        2000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-03-25T09:59:26+05:30
Zone                                   us-east-3
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Adjustable IOPS                        true
Busy                                   false
Tags                                   -
Storage Generation                     2

CLI からのお客様管理の暗号化を使用したスタンドアロン Block Storage for VPC ボリュームの作成

CLI から、 お客様暗号化が適用された「 Block Storage 」ボリュームを作成するには、 ibmcloud is volume-create コマンドに --encryption-key オプションを指定して実行します。 encryption_key オプションを使用するには、キー管理サービスのルートキーに対して有効なCRNが必要です。

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--encryption-key ENCRYPTION_KEY] [--capacity CAPACITY] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON]

以下の例は、カスタム IOPS を持つボリュームと、お客様管理の暗号化を使用して作成された容量を示しています。

ibmcloud is volume-create demo-cli-volume custom us-east-1 --capacity 300 --iops 1500 --encryption-key crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9

Creating volume demo-cli-volume under account Test Account as user test.user@ibm.com...
ID                                     r014-3984600c-6f4d-4940-82de-519a867fa3c0
Name                                   demo-cli-volume
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-3984600c-6f4d-4940-82de-519a867fa3c0
Status                                 pending
Attachment state                       unattached
Capacity                               300
IOPS                                   1500
Bandwidth(Mbps)                        3145
Profile                                custom
Encryption key                         crn:v1:bluemix:public:kms:us-east:a/a1234567:3b05b403-8f51-4dac-9114-c777d0a760d4:key:7a8a2761-08e3-455f-a348-144ed604bba9
Encryption                             user_managed
Resource group                         defaults
Created                                2023-06-29T20:10:52+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

CLI からのスナップショットからのスタンドアロン Block Storage for VPC ボリュームの作成

ibmcloud is volume-create コマンドを実行し、「--snapshot オプションに新しいボリュームの作成に使用するスナップショットの名前、ID、またはCRNを指定します。 応答の接続状態で示されているように、ボリュームは接続されていません。

この例では、名前で指定されたスナップショットから新規ボリュームを作成します。

ibmcloud is volume-create volume-4 general-purpose us-south-1 --snapshot r006-4602b3de-3885-4b49-8d46-65aacb72a1d6

Creating volume volume-4 under account Test Account as user test.user@ibm.com...
ID                                     r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name                                   volume-4
CRN                                    crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status                                 pending
Attachment state                       unattached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2023-06-29T16:14:59+00:00
Zone                                   us-east-1
Health State                           inapplicable
Volume Attachment Instance Reference   -
Active                                 false
Busy                                   false
Tags                                   -
Storage Generation                     1

詳しくは、CLI リファレンスの ibmcloud is volume-create を参照してください。

第一世代と第二世代の体積プロファイルに互換性はない。 第2世代ボリュームのスナップショットを使用して別の第2世代ボリュームを作成することはできますが、ボリューム・プロファイルを第1世代ボリューム・プロファイルに切り替えることはできません。 同様に、第1世代ボリュームのスナップショットを使用して、同じデータを持つ別の第1世代ボリュームを作成することができます。新しいボリュームを sdp プロファイルに切り替えることはできません。

開始前に

IAM トークン、API エンドポイント、および API バージョンを表す変数を定義します。 手順については、API および CLI の環境のセットアップを参照してください。

API を使用して、インスタンスのプロビジョニングの一環としてデータボリュームを作成する

POST /instances 要求を行ってインスタンスを作成し、volume_attachments パラメーターを使用してボリュームを定義します。 ボリューム名、容量、およびプロファイルを指定します。

有効なボリューム名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 ボリューム名の先頭は小文字にする必要があります。 ボリューム名は、VPC インフラストラクチャー全体で固有でなければなりません。 たとえば、同じアカウントおよびリージョン内で同じ名前のボリュームを2つ作成すると、「 volume name duplicate 」というエラーが発生します。

この例では、ブート・ボリュームおよびデータ・ボリュームのお客様管理の暗号化およびユーザー・タグを指定します。

curl -X POST "$vpc_api_endpoint/v1/instances?version=2022-06-14&generation=2" -H "Authorization: Bearer $iam_token" -d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-boot-volume",
      "profile": {"name": "general-purpose"},
      "storage_generation": 1,
      "user_tags": {"env:test","env:prod"}}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
  "name": "my-instance",
  "placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
  "profile": {"name": "bx2-2x8"},
  "volume_attachments": [
    {"volume": {
        "capacity": 1000,
        "encryption_key": {"crn": "crn:[...]"},
        "name": "my-data-volume",
        "profile": {"name": "5iops-tier"},
        "storage_generation": 1,
        "user_tags": {"env:test","env:prod"}}
    }],
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-south-1"}
}'

正常な応答は、以下のようになります。

{
  "bandwidth": 4000,
  "boot_volume_attachment": {
    "device": {
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
    },
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
    "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
    "name": "my-boot-volume-attachment",
    "volume": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
      "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
      "name": "my-boot-volume"
    }
  },
  "created_at": "2022-06-15T16:11:57Z",
  "crn": "crn:[...]",
  "dedicated_host": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "disks": [],
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "id": "eb1b7391-2ca2-4ab5-84a8-b92157a633b0",
  "image": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366",
    "name": "my-image"
  },
  "memory": 8,
  "name": "my-instance",
  "network_interfaces": [
    {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
      "name": "my-network-interface",
      "primary_ipv4_address": "10.0.0.32",
      "resource_type": "network_interface",
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/7389-bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
        "name": "my-subnet"
      }
    }
  ],
  "placement_target": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/dedicated_hosts/0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221",
    "name": "test-new",
    "resource_type": "dedicated_host"
  },
  "primary_network_interface": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/network_interfaces/7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "id": "7ca88dfb-8962-469d-b1de-1dd56f4c3275",
    "name": "my-network-interface",
    "primary_ipv4_address": "10.0.0.32",
    "resource_type": "network_interface",
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4",
      "name": "my-subnet"
    }
  },
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/instance/profiles/bx2-2x8",
    "name": "bx2-2x8"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "running",
  "status_reasons": [],
  "vcpu": {
    "architecture": "amd64",
    "count": 2
  },
  "volume_attachments": [
    {
      "device": {
        "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
      "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
      "name": "my-boot-volume-attachment",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
        "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
        "name": "my-boot-volume"
      }
    },
    {
      "device": {
        "id": "e77125cb-4df0-4988-a878-531ae0ae0b70"
      },
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-e77125cb-4df0-4988-a878-531ae0ae0b70",
      "id": "e77125cb-4df0-4988-a878-531ae0ae0b70",
      "name": "my-volume-attachment-1",
      "volume": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "id": "2cc091f5-4d46-48f3-99b7-3527ae3f4392",
        "name": "my-data-volume"
      }
    }
  ],
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "id": "f0aae929-7047-46d1-92e1-9102b07a7f6f",
    "name": "my-vpc"
  },
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

APIによるインスタンス・プロビジョニングの一環として、 sdp ブート・ボリュームを作成する

容量とIOPSに加えて、 bandwidth プロパティでカスタムスループット制限を指定することもできます。 以下の例を参照してください。

curl -X POST "$vpc_api_endpoint/v1/instances?version=2024-09-24&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "boot_volume_attachment": {
    "volume": {
      "encryption_key": {"crn": "crn:[...]"},
      "name": "my-defined-performance-boot-volume",
      "profile": {"name": "sdp"},
      "boot_capacity": 250,
      "iops": 3000,
      "bandwidth": 1000
      "storage_generation": 2,
      "user_tags": {"env:test","env:prod"}},
  "image": {"id": "9aaf3bcb-dcd7-4de7-bb60-24e39ff9d366"},
  "keys": [{"id": "363f6d70-0000-0001-0000-00000013b96c"}],
  "name": "my-instance",
  "placement_target": {"id": "0787-8c2a09be-ee18-4af2-8ef4-6a6060732221"},
  "primary_network_interface": {
    "name": "my-network-interface",
    "subnet": {"id": "bea6a632-5e13-42a4-b4b8-31dc877abfe4"}},
  "profile": {"name": "bx3dc-2x10"},
  "vpc": {"id": "f0aae929-7047-46d1-92e1-9102b07a7f6f"},
  "zone": {"name": "us-east-1"}
  }
}

APIによるボリューム作成の詳細については、 Block Storage ボリュームの作成 および インスタンス 作成のAPIリファレンスを参照してください

API を使用したスタンドアロン Block Storage for VPC ボリュームの作成

POST /volumes 要求を実行すると、ボリュームを作成できます。 名前、IOPS、容量、プロファイル、およびゾーンを指定します。

以下の例では、 us-south 領域に 50 MB の容量と 100 IOPS の custom ボリュームを作成しました。 この要求は、お客様管理の暗号化用のカスタマー・ルート鍵とリソース・グループも指定します。

curl -X POST "$vpc_api_endpoint/v1/volumes?version=2022-06-14&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-volume-4",
      "iops": 100,
      "capacity": 50,
      "zone": {"name": "us-south-2"},
      "profile": {"name": "custom"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

正常な応答は、次の例のようになります。

{
  "capacity": 50,
  "created_at": "2022-06-14T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 100,
  "name": "my-volume-4",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "4bbce614c13444cd8fc5e7e878ef8e21",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
    "name": "us-south-2"
  }
}

sdp プロファイルを使用すると、カスタム容量とカスタム IOPS でデータ・ボリュームを作成でき、 bandwidth プロパティでカスタム・スループット制限を指定することもできます。 以下の例では、このようなスタンドアロン・データ・ボリュームを us-east リージョンに作成する。

curl -X POST "$vpc_api_endpoint/v2/volumes?version=2024-09-27&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "name": "my-special-volume-1",
      "iops": 3000,
      "capacity": 250,
      "bandwidth": 5000,
      "zone": {"name": "us-east-2"},
      "profile": {"name": "sdp"},
      "encryption_key":{"crn":"crn:[...]"},
      "resource_group": {"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"}
    }'

正常な応答は、次の例のようになります。

{
  "adjustable_capacity_states:": "attached, unattached",
  "adjustable_iops_states": "attached, unattached",
  "bandwidth": 5000,
  "capacity": 250,
  "created_at": "2024-09-27T23:16:53.000Z",
  "crn": "crn:[...]",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:[...]"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-east.iaas.cloud.ibm.com/v2/volumes/2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
  "iops": 3000,
  "name": "my-special-volume-1",
  "profile": {
    "href": "https://us-east.iaas.cloud.ibm.com/v2/volume/profiles/sdp",
    "name": "sdp"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "name": "Default"
  },
  "status": "available",
  "status_reasons": [],
  "volume_attachments": [],
  "zone": {
    "href": "https://us-east.iaas.cloud.ibm.com/v1/regions/us-east/zones/us-east-2",
    "name": "us-east-2"
  }
}

API を使用したボリュームの作成について詳しくは、 Block Storage ボリュームの作成 および ボリュームの作成 に関する API リファレンスを参照してください。

API を使用してスナップショットからデータボリュームを作成する

POST /volumes 呼び出しでスナップショット ID、名前、または CRN を指定して、スタンドアロン データ ボリュームを作成できます。 storage_generation プロパティ値が1であるスナップショットを指定すると、同じ storage_generation 値を持つ新しいブロックストレージボリュームが作成され、同じ世代のボリュームプロファイルのみが適用できます。

データ・ボリュームを仮想サーバー・インスタンスに接続すると、データは完全にリストアされます。 詳細については、スナップショットからのボリュームの復元について。 API呼び出しの例については、未接続ボリュームのスナップショットからデータボリュームを復元する。

Terraform を使用したスタンドアロン Block Storage for VPC ボリュームの作成

Block Storage for VPC ボリュームを作成するには、 ibm_is_volume リソースを使用します。 次の例では、容量4 TB、 10iops-tier パフォーマンス・プロファイルの第一世代ボリュームを作成します。

resource "ibm_is_volume" "10iops_volume_example" {
  name     = "example-volume-10iops"
  profile  = "10iops-tier"
  zone     = "us-south-1"
  capacity = 4000
}

次の例では、 custom プロファイルで第一世代ボリュームを作成します。 作成されたボリュームには 200 MB の容量があり、1000 IOPS を実行できます。

resource "ibm_is_volume" "custom_volume_example" {
  name           = "example-volume-custom"
  profile        = "custom"
  zone           = "us-south-1"
  iops           = 1000
  capacity       = 200
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

次の例では、 sdp プロファイルで第 2 世代ボリュームを作成します。 作成されたボリュームの容量は250MBで、3000IOPSを実行でき、最大帯域幅は1000Mbpsに制限されている。

resource "ibm_is_volume" "sdp_volume_example" {
  name           = "example-volume-sdp"
  profile        = "sdp"
  zone           = "us-south-1"
  iops           = 3000
  capacity       = 250
  bandwidth      = 1000
  encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
}

引数および属性について詳しくは、 ibm_is_volumeを参照してください。

Terraform を使用したスナップショットからのスタンドアロン Block Storage for VPC ボリュームの作成

スナップショットから Block Storage for VPC ボリュームを作成するには、 ibm_is_volume リソースを使用します。 以下の例では、ID で識別されるスナップショットに基づいてボリュームを作成します。 名前またはCRNを使用してスナップショットを識別することもできます。

resource "ibm_is_volume" "example-volume-from-snapshot" {
  name            = "example-volume"
  profile         = "general-purpose"
  zone            = "us-south-1"
  source_snapshot = ibm_is_snapshot.example.id
}

引数および属性について詳しくは、 ibm_is_volumeを参照してください。

第一世代と第二世代の体積プロファイルに互換性はない。 第2世代ボリュームのスナップショットを使用して別の第2世代ボリュームを作成することはできますが、ボリューム・プロファイルを第1世代ボリューム・プロファイルに切り替えることはできません。 同様に、第1世代ボリュームのスナップショットを使用して、同じデータを持つ別の第1世代ボリュームを作成することができます。新しいボリュームを sdp プロファイルに切り替えることはできません。

Terraformでインスタンスプロビジョニングの一部としてブートボリュームを作成する

仮想サーバー・インスタンスの作成時にスナップショットからデータ・ボリュームを作成するには、 ibm_is_instance リソースを使用します。 次の例では、 sdp ボリュームプロファイルを使用し、 お客様暗号化キーで保護されたブートボリュームを持つ仮想サーバーインスタンスを作成します。 ブートボリュームに sdp プロファイルを指定すると、カスタム容量、IOPS、帯域幅の制限を指定できます。

   resource "ibm_is_instance" "example_instance" {
     name    = "example-instance-reserved-ip"
     image   = data.ibm_is_image.example_image.id
     profile = data.ibm_is_instance_profile.example_profile.name
     primary_network_interface {
       name   = "eth0"
       subnet = ibm_is_subnet.example_subnet.id
       primary_ip {
         reserved_ip = ibm_is_subnet_reserved_ip.example_reserved_ip.reserved_ip
       }
     }
     network_interfaces {
       name   = "eth1"
       subnet = ibm_is_subnet.example_subnet.id
       primary_ip {
         name = "example-reserved-ip1"
         auto_delete = true
         address = "${replace(ibm_is_subnet.example_subnet.ipv4_cidr_block, "0/24", "14")}"
       }
     }
     vpc  = ibm_is_vpc.example_vpc.id
     zone = "us-south-1"
     keys = [ibm_is_ssh_key.example_sshkey.id]
     boot_volume {
       name           = "example-boot-volume"
       profile        = "sdp"
       size           = 250
       iops           = 3000
       bandwidth      = 1000
       encryption_key = "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
      }
   }

引数および属性について詳しくは、 ibm_is_instanceを参照してください。

Terraform を使用したインスタンス・プロビジョニングの一部としてのスナップショットからのブート・ボリュームの作成

仮想サーバー・インスタンスの作成時にスナップショットからデータ・ボリュームを作成するには、 ibm_is_instance リソースを使用します。 以下の例では、「example-vsi-restore」という名前の仮想サーバー・インスタンスを作成します。 ブート・ボリュームは、名前、ソース・スナップショット、およびユーザー・タグを使用して boot_volume 引数で定義されます。

resource "ibm_is_snapshot" "example" {
  name          = "example-snapshot"
  source_volume = ibm_is_instance.example.volume_attachments[0].volume_id
}
resource "ibm_is_instance" "example" {
  name    = "example-vsi-restore"
  profile = "cx2-2x4"
  boot_volume {
    name     = "boot-restore"
    snapshot = ibm_is_snapshot.example.id
    tags     = ["tags-0"]
  }
  primary_network_interface {
    subnet = ibm_is_subnet.example.id
  }
  vpc  = ibm_is_vpc.example.id
  zone = "us-south-1"
  keys = [ibm_is_ssh_key.example.id]
  network_interfaces {
    subnet = ibm_is_subnet.example.id
    name   = "eth1"
  }
}

別のアカウントのスナップショットからボリュームをリストアする場合は、「source_snapshot_crn 引数を使用して、IDの代わりにCRNでスナップショットを識別することができます。

引数および属性について詳しくは、 ibm_is_instanceを参照してください。

Terraform を使用して既存のインスタンスに追加するためのデータ・ボリュームの作成

データ・ボリュームを作成し、それを仮想サーバー・インスタンスに接続するには、 ibm_is_instance_volume_attachment リソースを使用します。 次の例では、general-purpose ボリュームプロファイルで20 MBのデータボリュームを作成し、ibm_is_instance.example.id インスタンスにアタッチしています。

rresource "ibm_is_instance_volume_attachment" "example" {
  instance = ibm_is_instance.example.id
  name                               = "example-vol-att-1"
  profile                            = "general-purpose"
  capacity                           = "20"
  delete_volume_on_attachment_delete = true
  delete_volume_on_instance_delete   = true
  volume_name                        = "example-vol-1"
}

引数および属性について詳しくは、 ibm_is_instance_volume_attachmentを参照してください。