コンソールでファイル共有を作成する

1. IBM Cloud コンソールで、 ナビゲーション メニュー> インフラストラクチャ> ストレージ > ファイル ストレージ共有をクリックします。 ファイル共有のリストが表示されます。

2. [VPC のファイルストレージ共有] ページで、[ 作成 ] をクリックします。 「 ファイル共有の作成 」を選択します。

3. 以下の情報を入力します。

1. マウントターゲットの 作成は任意。 ここでマウント・ターゲットを作成しない場合は、このステップをスキップできます。 しかし、ファイル共有をコンピュート・ホストにマウントするには、1つ必要です。 ファイル共有は複数のマウントターゲットを持つことができるので、複数のVPCからアクセスすることができます。 マウント・ターゲットは、ファイル共有ごとに VPC 1 つにつき 1 つ作成できます。 作成するには、「 作成 」をクリックします。

   マウント・ターゲットは 仮想ネットワーク・インターフェイス （VNI）で作成する必要があります。 VNIはファイル共有に予約IPアドレスを提供し、選択した セキュリティ グループのルールを適用する。 このマウント・ターゲットは、転送中の暗号化およびゾーン間マウントをサポートします。 以下の情報を提供してマウントターゲットを定義します：

   1. マウント・ターゲット名を指定してください。 名前は、小文字の英数字を最大63文字まで使用でき、ハイフン（-）を含めることができます。また、小文字のアルファベットで始まる必要があります。 名前は必要に応じて後で編集できます。
   2. 使用可能な VPC を選択します。 このリストには、選択したリージョンにサブネットを持つVPCのみが含まれます。 場所の選択は、ファイル共有から継承されます（例 us-south-2 ）。
   3. デフォルトの仮想ネットワークインターフェースが生成される。 アイコンをクリックしてカスタマイズすることができます。 その場所に複数のサブネットがある場合は、名前またはサブネットを変更できます。 マウント・ターゲットにアタッチする既存のVNIを選択することもできます。 VPC 内で利用可能な VNI のリストと場所が表示されます。 VNIのセカンダリIPアドレスはファイル共有のマウントターゲットとして受け付けられないため、リストから除外されます。
   4. 次へ をクリックします。
   5. 転送中の暗号化は、ゾーン共有ではデフォルトで無効になっており、リージョナル共有ではデフォルトで有効になっています。 トグルをクリックしてプリセット値を変更します。 この機能について詳しくは、 Encryption in transit-Securing mount connections between file share and host を参照してください。
   6. そして、「次へ」 をクリックします。
   7. 選択内容を確認し、 「戻る」 をクリックして戻って選択内容を更新するか、 「作成」 をクリックします。

2. 「 保存時の暗号化 」セクションでは、すべてのファイル共有は、デフォルトで IBM が管理するキーによって暗号化されます。 独自の暗号化キー を使用するには、トグルをクリックして「 お客様暗号化」を有効にしてください。 すでにKMSインスタンスとルートキーをお持ちの場合は、システムが自動的にそれを選択します。 キーまたはインスタンスを変更するには、 [編集]アイコン をクリックして、「 暗号化の設定 」サイドパネルを開きます。 暗号化キーを確認するには、以下のオプションから1つを選択してください：

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

3. 「シングルゾーンの可用性」を選択した場合、「暗号化」カードの下に「 災害復旧 」セクションが表示されます。 このステップはオプションです。 これを使用して、プロビジョニング時に同一リージョン間の非同期レプリケーションを設定します。 地域をまたぐレプリケーションは、共有がプロビジョニングされ、安定した状態になった後に、別途設定する必要があります。 詳細については、「 ファイル共有へのレプリケーションの追加 」を参照してください。

   同一リージョン間のレプリケーションを設定するには、「 非同期レプリケーション 」の切り替えボタンをクリックしてください。 複製フィールドはインラインで展開されます。 レプリカは、元の共有のプロファイルと暗号化設定を引き継ぎます。 マウント・ターゲットは個別に追加する必要があります。

   以下のフィールドに入力してください。

   1. ゾーン ：地理情報および地域は、ソース・シェアの所在地に基づいてあらかじめ設定されており、変更することはできません。 ドロップダウンからレプリカのゾーンを選択してください。 レプリケーションの対象となるゾーンのみが表示されます。
   2. レプリカ名 ：レプリカ共有の名前を入力してください。
   3. 最大 IOPS ：レプリカ共有の最大 IOPS を指定します。
   4. 頻度 ：ソース共有からの変更をレプリカに同期する頻度を選択し、開始時刻を設定します：
      • 15分ごと ：開始時刻の分を入力してください。
      • 「 1時間ごと 」：開始時刻の分を入力してください。
      • 毎日 ：開始時刻をUTCでHH:MM形式で入力してください。00:00から23:59までの範囲で指定してください。
      • 「毎週 」：レプリケーションを実行する曜日を選択し、開始時刻をUTCでHH:MM形式（00:00～23:59の間）で入力してください。
      • 毎月 ：レプリケーションを実行する日付（1～31）を入力し、開始時刻をUTCでHH:MM形式（00:00～23:59の間）で入力してください。
      • Cron式 ： cron-spec 式を「 minute hour day month weekday 」という形式で入力してください。 レプリケーションは、15分以上の間隔を空けてスケジュールする必要があります。 たとえば、毎日UTC午後5時30分にレプリケーションを行うには、「 30 17 * * * 」と入力します。

4. 必要な情報をすべて入力したら、 「ファイル共有の作成」 をクリックします。 File Storage for VPC ページに戻ります。このページには、ファイル共有がプロビジョニング中であることを示すメッセージが表示されます。 トランザクションが完了すると、共有状況が 「アクティブ」 に変わります。

まだ注文する準備ができていない場合、または単に価格設定情報を探している場合は、サイド・パネルに表示される情報を見積もりに追加できます。 この機能がどのように機能するかについての詳細は、 費用の見積もりを ご覧ください。

開始前に

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

以下の例では、マウントターゲットの有無やアクセスモードの違いによるゾーン共有とリージョナル共有の作成方法を説明します。 コマンド オプションと構文の詳細については、 VPC CLI リファレンスを参照してください。 ibmcloud is share-create。

ファイル共有作成に必要な情報の収集

ibmcloud is share-create コマンドを実行する前に、他のファイル共有、マウント・ターゲット、およびファイル・ストレージ・プロファイルに関する情報を表示することで、共有のプロビジョニングに必要な情報を収集できます。

• ibmcloud is shares コマンドですべてのファイル共有をリストアップする。
• ibmcloud is share SHARE コマンドで特定のファイル共有の詳細を一覧表示する。
• ibmcloud is share-snapshots SHARE コマンドで特定のファイル共有のスナップショットを一覧表示する。
• ibmcloud is share-profiles コマンドを使用して、リージョン内のすべてのファイル共有プロファイルを一覧表示します。 ファイル共有の作成に使用できるのは、 dp2 と rfs の共有プロファイルのみです。
• ibmcloud is share-mount-targets SHARE コマンドを使用して、特定のファイル共有のすべてのマウント ターゲットを一覧表示します。
• ibmcloud is subnets コマンドで、リージョン内で利用可能なすべてのサブネットをリストする。
• ibmcloud is subnet-reserved-ips 、サブネット内の予約済みIPアドレスをすべてリストアップする。
• ibmcloud is security-groups コマンドで利用可能なすべてのセキュリティグループをリストする。

CLIからマウントターゲットなしでゾーンファイル共有を作成する

ibmcloud is share-create コマンドを使用して、選択したゾーンのゾーンファイル共有を dp2 プロファイルで、特定の容量と IOPS 値でプロビジョニングできます。 次の例は、 us-south-1 ゾーンに 100 IOPS で 40GB のファイル共有を作成する方法を示している。 このファイル共有は、デフォルトのセキュリティー・グループ・アクセス・モードおよびプロバイダー管理の暗号化を使用して作成されます。

ibmcloud is share-create --name my-file-share --zone us-south-1 --profile dp2 --size 40 --iops 100 --allowed-access-protocols nfs4 --atem ipsec,none

Creating file share my-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-a08c2505-b933-4dce-a771-efff2e1a59e1
Name                               my-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-a08c2505-b933-4dce-a771-efff2e1a59e1
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   ipsec,none
Zone                               us-south-1
Profile                            dp2
Size(GB)                           40
IOPS                               100
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T20:10:35+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

CLIからマウントターゲットなしで地域ファイル共有を作成する

次の例は、1000Mbpsの帯域幅で40GBの地域ファイル共有を作成する方法を示しています。 このファイル共有は、プロバイダーが管理する暗号化で作成される。 ファイル共有は、ログイン時に選択した地域に作成されるため、場所の選択は不要です。

ibmcloud is share-create --name my-regional-file-share --profile rfs --size 40 --bandwidth 1000 --allowed-access-protocols nfs4 --atem stunnel,none

Creating file share my-regional-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-749d05eb-9779-4414-b902-553a4fd1421d
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-749d05eb-9779-4414-b902-553a4fd1421d
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel,none
Zone                               -
Profile                            rfs
Size(GB)                           40
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                          Name
                                   No mounted targets found.
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T20:20:09+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     -
Snapshot size                      -
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  regional
Bandwidth(Mbps)                    1000
Storage Generation                 2

マウントターゲット作成に必要な情報収集

マウント・ターゲットを作成するときは、そのターゲットの対象となるファイル・シェアを指定する必要があります。 ファイル共有の名前または ID を使用できます。 VPC も、その ID または名前を使用して指定する必要があります。 VPC は各マウント・ターゲットにおいて固有でなければなりません。 共有へのアクセスを管理するために使用するセキュリティー・アクセス・グループも指定する必要があります。 マ ウ ン ト タ ーゲ ッ ト に関連付けるセキ ュ リ テ ィ グループは、 共有を マ ウ ン ト す る すべてのサーバか ら NFS ポー ト の TCP プ ロ ト コ ルの受信ア ク セ ス を許可す る 必要があ り ます。

最後に、マウント・ターゲットの 仮想ネットワーク・インターフェース を作成するために必要なオプションの値を指定する必要があります。 適切な CLI コマンドを使用して、使用可能な サブネット、 サブネット内の予約 IP アドレス、 セキュリティー・グループ をリストし、必要な情報を取得します。

以下の例は、異なるアクセス・モードでマウント・ターゲットを作成する方法を示しています。 コマンドのオプションと構文の詳細については、 VPC CLI リファレンスを参照してください。 ibmcloud is share-mount-target-create。

セカンダリ IP アドレスが割り当てられている仮想ネットワークインターフェイスは、ファイル共有のマウント先として指定することはできません。

セキュリティグループアクセスモードでマウントターゲットを作成する

以下の例では、セキュリティー・グループ・アクセス・モードを持つファイル共有の仮想ネットワーク・インターフェースを使用して、マウント・ターゲットを作成します。

ibmcloud is share-mount-target-create my-regional-file-share --subnet my-subnet --name my-regional-share-mount-target-1 --vni-name my-share-vni-2  --resource-group-id 6edefe513d934fdd872e78ee6a8e73ef  --access-protocol nfs4 --transit-encryption none --vpc my-vpc

Mounting target for share r006-749d05eb-9779-4414-b902-553a4fd1421d under account Test Account as user test.user@ibm.com...
ID                          r006-bc95a3c2-b84b-4186-8c5a-e3dd220abefa
Name                        my-regional-share-mount-target-1
VPC                         ID                                          Name
                            r006-243394d6-b192-4e05-bfab-5d0b4e77cf81   my-vpc
Access control mode         security_group
Resource type               share_mount_target
Virtual network interface   ID                                          Name             Protocol State Filtering Mode
                            0717-24e7dcac-e30f-43cf-9bee-3cab93692690   my-share-vni-2   auto
Lifecycle state             pending
Mount path                  -
Transit Encryption          none
Created                     2025-09-23T20:45:14+00:00
Access Protocol             nfs4

VPCアクセスモードでのマウントターゲットの作成

非推奨

次の例では、非推奨となった VPC アクセスモードを持つゾーン型ファイル共有のマウントターゲットを作成します。

vpc 、2027年5月6日にサポート終了となる。 移行ガイドに従って、共有のアクセス・コントロール・モードを security-group に更新してください。

ibmcloud is share-mount-target-create my-vpc-file-share --vpc cli-vpc-3 --name my-vpc-mount-target --access-protocol nfs4 --transit-encryption none

Mounting target for share r006-10e82e16-ff7f-4ca4-b543-d24084fc03cf under account Test Account as user test.user@ibm.com...
ID                        r006-71fd953c-8e49-48e8-ab49-5977c324a365
Name                      my-vpc-mount-target
VPC                       ID                                          Name
                          r006-060fbfe6-4d0f-47b0-b9c5-94da8e719e22   cli-vpc-3
Access control mode       vpc
Resource type             share_mount_target
Virtual network interface
Lifecycle state           pending
Created                   2025-09-23T22:15:15+00:00
Mount path                -
Transit Encryption        none

マウントターゲットによるゾーンファイル共有の作成

次の例は、 us-south-1 ゾーンに容量 500 GB、2000 IOPS のゾーンファイル共有を作成する方法を示している。 ファイル共有は env:dev でタグ付けされ、セキュリティー・グループ・アクセス制御モードを持ちます。 ファイル共有は、マウント・ターゲット my-new-mount-target を使用して、許可された仮想サーバーにマウントできます。

ibmcloud is share-create --name my-new-file-share --zone us-south-1 --profile dp2 --size 500 --iops 2000 --allowed-transit-encryption-modes ipsec,none --user-tags env:dev --mount-targets '[{"name":"my-new-mount-target","virtual_network_interface": {"name":"my-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]'

Creating file share my-new-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-201487a2-cf35-4b2a-a4fe-f480803e1e80
Name                               my-new-file-share
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-201487a2-cf35-4b2a-a4fe-f480803e1e80
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   ipsec,none
Zone                               us-south-1
Profile                            dp2
Size(GB)                           500
IOPS                               2000
User Tags                          env:dev
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-c8952df9-f479-49a8-a66b-85bf112e0831   my-new-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:17:25+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

マウントターゲットによる地域ファイル共有の作成

次の例は、CLIからマウント・ターゲットを使用して地域ファイル共有を作成する方法を示しています。 コマンドが低い帯域幅値を指定した場合、システムは最低800 Mbpsを提供するように設定を自動修正することに注意してください。

ibmcloud is share-create --name my-regional-file-share --profile rfs --size 5000 --bandwidth 800 --allowed-access-protocols nfs4 --atem stunnel --mount-targets '[{"name":"my-new-mount-target","virtual_network_interface": {"name":"my-regional-vni","subnet": {"id":"0717-c66032c9-048d-4c35-aa83-c932e24afdbb"}}}]'

Creating file share my-regional-file-share under account under account Test Account as user test.user@ibm.com...
ID                                 r006-770ff2f9-3211-459d-918b-fbf0b4a4f999
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-770ff2f9-3211-459d-918b-fbf0b4a4f999
Lifecycle state                    pending
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel
Zone                               -
Profile                            rfs
Size(GB)                           5000
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                                          Name
                                   r006-f7c84cb2-0e82-4f9e-b729-6e51ea437df6   my-new-mount-target
Resource group                     ID                                 Name
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                            2025-09-23T21:27:07+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     -
Snapshot size                      -
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  regional
Bandwidth(Mbps)                    800
Storage Generation                 2

開始前に

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

generation パラメーターを指定し、 generation=2 を指定する必要があります。 詳細については、『 Virtual Private Cloud API リファレンス 』の 「Generation」 の項を参照してください。

API についての知識を身に付けるには、IBM Cloud コンソールのプロビジョニングのページの**「サンプル API 呼び出しの取得 (Get sample API call)」**をクリックしてください。 API 要求の正しい順序を確認し、アクションとその依存関係について理解を深めることができます。

APIで必要な情報を収集する

POST /shares リクエストを行う前に、以下のAPIメソッドを使用して、共有のプロビジョニングに必要な情報を収集する。

• リージョン内の GET /shares を持つ ファイル共有を一覧表示 する。
• GET /shares/{id} で ファイル共有を取得 し、その詳細を確認する。
• List file share snapshots with GET /shares/{share_id}/snapshots 、特定のファイル共有のスナップショットを一覧表示する。
• GET /share/profiles で ファイル共有プロファイルを一覧表示 し、地域で利用可能なファイル共有プロファイルを確認できます。 ファイル共有の作成に使用できるのは、 dp2 と rfs のみである。
• ファイル共有のマウントターゲットを一覧表示するGET /shares/{share_id}/mount_targets ファイル共有の既存のマウントターゲットを表示するには、
• GET /subnets で サブネットを一覧表示 し、地域で利用可能なサブネットを確認する。
• GET /subnets/{subnet_id}/reserved_ips で サブネット内の予約済みIPアドレスをリストアップする。
• GET /security_groups を使って セキュリティ・グループをリストアップする。

API を使用したゾーン別ファイル共有の作成

ファイル共有を作成するための POST /shares 要求を行います。 ファイル共有のサイズ、名前、IOPS プロファイル、ゾーンを指定します。 きめ細かなアクセス権限でファイル共有を作成したい場合は、アクセスモードとして「security_group 指定する。 セキュリティグループアクセスモードを持つ共有は、転送中の暗号化、クロスゾーンマウント、スナップショット、バックアップもサポートするように設定できる。 以下の例を参照してください。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "access_control_mode": "security-group",
    "allowed_transit_encryption_modes": ["none","ipsec"],
    "size": 4800,
    "iops": 3000,
    "name": "myshare-1",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"}
}

マ ウ ン ト タ ーゲ ッ ト を作成す る 際に、 仮想サーバ イ ン ス タ ン ス が属す る セキ ュ リ テ ィ グループのメンバである仮想ネッ ト ワーク イ ン タ ーフ ェ イ ス を指定す る 必要があ る こ と を確認 し て く だ さ い。

API を使用した地域別ファイル共有の作成

次の例は、8000Mbpsの帯域幅で1000GBの地域ファイル共有を作成する方法を示しています。 このファイル共有は、デフォルトのセキュリティー・グループ・アクセス・モードおよびプロバイダー管理の暗号化を使用して作成されます。 ファイル共有は、ログイン時に選択した地域に作成されるため、場所の選択は不要です。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
  "name": "my-regional-share-1",
  "mount_targets": [],
  "profile": {"name": "rfs"},
  "size": 1000,
  "bandwidth": 8000,
  "allowed_transit_encryption_modes": ["none","stunnel"],
  "resource_group": {"id": "db8e8d865a83e0aae03f25a492c5b39e"},
  "access_control_mode": "security_group"
}'

サブネットとセキュリティー・グループを指定して、既存のファイル共有にマウント・ターゲットを追加する

POST /shares/{share_id}/mount_targets 要求を行い、マウント・ターゲット・ネットワーク・インターフェースのサブネットおよびセキュリティー・グループを指定します。 マ ウ ン ト タ ーゲ ッ ト に関連付けるセキ ュ リ テ ィ グループは、 共有を マ ウ ン ト す る すべてのサーバか ら NFS ポー ト の TCP プ ロ ト コ ルの受信ア ク セ ス を許可す る 必要があ り ます。

この例では、IDで識別される既存のゾーンファイル共有にマウントターゲットを追加し、ネットワークインターフェイスを定義するためにサブネットとセキュリティグループを提供します。 転送中の暗号化が有効になっている。

 curl -X POST "$vpc_api_endpoint/v1/shares/r006-201487a2-cf35-4b2a-a4fe-f480803e1e80/mount_targets/?version=2023-07-18&generation=2"\
 -d '{
     "virtual_network_interface": {
        "subnet": {"id": "1a0b3d75-8a62-4c78-9263-f9bcd25a8759"},
        "security_groups": [{"id": "b2599112-7027-480e-ad1b-fd917d2fcb84"}]
     },
     "transit_encryption": "ipsec"
}'

次の例は、地域のファイル共有にマウント・ターゲットを追加する方法を示しています。 地域ファイル共有ターゲットで転送中の暗号化を有効にするには、"stunnel "を指定する。

 curl -X POST "$vpc_api_endpoint/v1/shares/r006-ee1f6fc0-6fa3-4821-ad70-f6589e30c566/mount_targets/?version=2025-09-23&generation=2"\
 -d '{
     "virtual_network_interface": {
        "subnet": {"id": "1a0b3d75-8a62-4c78-9263-f9bcd25a8759"},
        "security_groups": [{"id": "b2599112-7027-480e-ad1b-fd917d2fcb84"}]
     },
     "transit_encryption": "stunnel"
}'

VPC アクセスモードを使用して、既存のファイル共有にマウント先を追加する

非推奨

このリクエストは、既存のファイル共有にマウント先を追加します。 この例では、ファイル共有のアクセス制御モードが「 vpc 」であるため、「 vpc 」という値が指定されています。 転送中のデータ暗号化は有効にできない。

curl -X POST "$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-H 'Content-Type: application/json'\
-d '{
    "access_control_mode": "vpc"
    "name": "mount-target-name1",
    "vpc": {"id": "6e01bc24-4a6e-4a0c-a1bd-4caa0c8159e7"},
    "transit_encryption": "none"
  }'

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

{
  "access_control_mode": "vpc",
  "created_at": "2023-08-08T23:31:59Z",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/ff859972-8c39-4528-91df-eb9160eae918/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
  "lifecycle_state": "pending",
  "mount_path": "domain.com:/vol_xyz_2891fd0a_63aa_4deb_9ed5_1159e37cb5aa",
  "name": "mount-target-name1",
  "resource_type": "share_target",
  "transit_encryption": "none",
  "vpc": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/e6ff7b61-feb4-4c87-94aa-277d6f93e164",
    "id": "e6ff7b61-feb4-4c87-94aa-277d6f93e164",
    "name": "vpc-name1",
    "resource_type": "vpc"
  }
}

サブネットの指定によるファイル共有およびマウント・ターゲットの作成

ファイル共有のデフォルトのアクセス制御モードは security_group です。 ファイル共有の作成と同時にネットワーク・インターフェイスでマウント・ターゲットを作成するには、「POST /shares リクエストをしてサブネットを指定する。 subnet プロパティの指定は、仮想ネットワーク・インターフェイス を指定していない場合に必要です。

以下の例では、予約済みIPアドレスでマウントターゲットに 仮想ネットワークインタフェース を作成してアタッチし、選択したセキュリティグループのルールを適用しています。 マ ウ ン ト タ ーゲ ッ ト に関連付けるセキ ュ リ テ ィ グループは、 共有を マ ウ ン ト す る すべてのサーバか ら NFS ポー ト の TCP プ ロ ト コ ルの受信ア ク セ ス を許可す る 必要があ り ます。

この例では、マウント・ターゲット・セクションはサブネット ID を指定しています。 システムは、マウント・ターゲットの作成時に、そのサブネットから 仮想ネットワーク・インターフェース 用の予約 IP を選択します。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "allowed_transit_encryption_modes": ["ipsec"],
    "size": 10,
    "name": "my-share-1",
    "profile": {"name": "dp2"},
     "zone": {"name": "us-south-1"},
     "mount_targets": [{
         "virtual_network_interface": {"subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"}},
         "transit_encryption": "ipsec"}]
}'

transit_encryption プロパティーが ipsec に設定されている場合、インスタンス ID 証明書を使用した転送中の暗号化が有効になります。 transit_encryption プロパティのデフォルト値は「none であり、転送中の暗号化を無効にする。 ただし、 allowed_transit_encryption_modes を ipsec と指定した場合は、transit_encryption の値として ipsec を指定してマウントターゲットを作成する必要があります。

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

 {
    "access_control_mode": "security_group",
    "allowed_transit_encryption_modes": ["ipsec"],
    "created_at": "2023-09-23T12:15:12Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/90c4bb62-1724-47bd-8c45-f7d37d7c3508/mount_targets/7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "id": "7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "lifecycle_state": "pending",
    "mount_path": "",
    "name": "myshare-1",
    "primary_ip": {"address": ""},
    "resource_type": "share_target",
    "size": 10,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "name": "subnet-2",
        "resource_type": "subnet"
    },
    "transit_encryption": "ipsec",
    "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interface/710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "id": "710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "name": "enlace-traverse-oat-console",
        "resource_type": "VirtualNetworkInterface"
    },
    "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "id": "82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "name": "my-vpc-2",
        "resource_type": "vpc"
    },
    "user_tags": []
}

次の例は、地域のファイル共有にマウント・ターゲットを追加する方法を示しています。 地域ファイル共有ターゲットで転送中の暗号化を有効にするには、"stunnel "を指定する。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2025-09-23&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
    "allowed_transit_encryption_modes": ["stunnel","none"],
    "size": 5000,
    "name": "my-regional-share-1",
    "profile": {"name": "rfs"},
     "mount_targets": [{
         "virtual_network_interface": {"subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"}},
         "transit_encryption": "stunnel"}]
}'

transit_encryption プロパティが stunnel に設定されている場合、転送中の暗号化が有効になり、ファイル共有を安全にマウントするためには、コンピュートホスト上でいくつかの設定ステップを完了する必要があります。 この例では、 allowed_transit_encryption_modes が stunnel,none として指定され、マウントターゲットは transit_encryption の値としてこれらの値のいずれかを持つことができます。

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

 {
    "access_control_mode": "security_group",
    "accessor_binding_role": "none",
    "allowed_access_protocols": ["nfs4"],
    "allowed_transit_encryption_modes": ["stunnel"],
    "availability_mode": "regional",
    "access_control_mode": "security_group",
    "bandwidth": 2000,
    "created_at": "2025-09-23T12:15:12Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/90c4bb62-1724-47bd-8c45-f7d37d7c3508/mount_targets/7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "id": "7e5bdb52-676d-43b2-991f-2053cf6855eb",
    "lifecycle_state": "pending",
    "mount_path": "",
    "name": "my-regional-share-1",
    "primary_ip": {"address": ""},
    "resource_type": "share_target",
    "size": 5000,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "storage_generation": 2,
    "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde",
        "name": "subnet-2",
        "resource_type": "subnet"
    },
    "transit_encryption": "stunnel",
    "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interface/710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "id": "710y-b8aa945c-7eac-4c15-bad6-a56db9d1e9bd",
        "name": "enlace-traverse-oat-console",
        "resource_type": "VirtualNetworkInterface"
    },
    "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "id": "82fa21ae-a645-4dd5-9136-d48a723bf00e",
        "name": "my-vpc-2",
        "resource_type": "vpc"
    },
    "user_tags": []
}

サブネットおよびセキュリティー・グループの指定によるファイル共有およびマウント・ターゲットの作成

マウント・ターゲット・ネットワーク・インターフェースを作成するには、 POST /shares 要求を行い、サブネットとセキュリティー・グループを指定します。 マ ウ ン ト タ ーゲ ッ ト に関連付けるセキ ュ リ テ ィ グループは、 共有を マ ウ ン ト す る すべてのサーバか ら NFS ポー ト の TCP プ ロ ト コ ルの受信ア ク セ ス を許可す る 必要があ り ます。

以下の例では、 mount_targets プロパティでサブネット ID とセキュリティ・グループ ID を指定しています。 transit_encryption プロパティーを ipsec に設定すると、インスタンス ID 証明書を使用して転送中の暗号化が有効になります。 このオプションは、ゾーンファイル共有にのみ適用されます。 地域ファイル共有は、転送中の暗号化に stunnel。 デフォルト値は none で、転送中の暗号化を無効にします。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-09-23&generation=2"\
-H "Authorization: Bearer $iam_token" \
-d '{
    "size": 20,
    "iops": 100,
    "name": "myshare-3",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-1"},
    "allowed_transit_encryption_modes": ["ipsec"],
    "mount_targets": [{
        "virtual_network_interface": {
            "subnet": {"id": "4e95744c-7e64-48c9-b5d2-3b6481b1dfde"},
            "security_groups": [{"id": "34c09abb-37bf-4ef6-88bb-f63a0ef28915"}]
        },
        "transit_encryption": "ipsec"
      }]
    }'

次の例は、成功したAPI応答を示している。

{
    "access_control_mode": "security_group",
    "allowed_transit_encryption_modes": ["ipsec"],
    "created_at": "2025-09-23T12:55:40Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-56f91d4a-2801-470a-b368-176bde64e954",
    "id": "r006-56f91d4a-2801-470a-b368-176bde64e954",
    "initial_owner": {
        "gid": 0,
        "uid": 0
    },
    "iops": 100,
    "lifecycle_state": "pending",
    "name": "myshare-3",
    "mount_targets": [
        {
            "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-56f91d4a-2801-470a-b368-176bde64e954/mount_targets/r006-b8573e2c-60ee-4ecc-9eae-c52f890a8195",
            "id": "r006-b8573e2c-60ee-4ecc-9eae-c52f890a8195",
            "name": "sticky-idealist-spoiled-sloppily",
            "resource_type": "share_target",
            "transit_encryption": "ipsec"
        }
    ],
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
        "name": "dp2",
        "resource_type": "share_profile"
    },
    "replication_role": "none",
    "replication_status": "none",
    "replication_status_reasons": [],
    "resource_group": {
        "crn": "crn:[...]",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups//678523bcbe2b4eada913d32640909956",
        "id": "678523bcbe2b4eada913d32640909956",
        "name": "Default"
    },
    "resource_type": "share",
    "size": 20,
    "snapshot_count": 10,
    "snapshot_size": 10,
    "user_tags": [],
    "zone": {
        "href": "https://us-south.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
}

仮想ネットワーク・インターフェースの指定によるファイル共有およびマウント・ターゲットの作成

この操作を実行するには、すでに 仮想ネットワークインターフェイス があり、その仮想ネットワークインターフェイスが他のリソースにアタッチされていない必要があります。 セカンダリ IP アドレスが割り当てられた仮想ネットワークインターフェースは、ファイル共有のマウント先として指定することはできません。

POST /shares 要求を行い、仮想ネットワーク・インターフェースを使用してマウント・ターゲットを作成します。 マウント・ターゲットの「virtual_network_interface プロパティに、アタッチされていない仮想ネットワーク・インターフェイスのIDを指定する。

curl -X POST "$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
    "size": 10,
    "name": "my-share-sc-2",
    "profile": {"name": "dp2"},
    "zone": {"name": "us-south-3"},
    "allowed_transit_encryption_modes": ["none"],
    "mount_targets": [{
        "name": "mount-target-1",
        "transit_encryption": "none",
        "virtual_network_interface": {"id": "0767-fa41aecb-4f21-423d-8082-630bfba1e1d9"}
      }]
    }'

Terraformでゾーンファイル共有を作成する

ファイル共有を作成するには、 ibm_is_share リソースを使用します。 次の例では、ゾーン可用性、200 GBの容量、500 IOPS、 dp2 パフォーマンスプロファイルの共有を作成します。

resource "ibm_is_share" "zonalexample" {
  allowed_transit_encryption_modes = ["ipsec", "none"]
  name                             = "my-new-share"
  size                             = "200"
  iops                             = "500"
  profile                          = "dp2"
  zone                             = "us-south-2"
}

Terraformで地域のファイル共有を作成する

次の例では、地域の可用性、200 GBの容量、800 Mbpsの帯域幅、および rfs パフォーマンスプロファイルを持つ共有を作成します。

resource "ibm_is_share" "regionalexample" {
  access_control_mode              = "security_group"
  allowed_transit_encryption_modes = ["stunnel", "none"]
  bandwidth                        = "800"
  name                             = "my-share"
  profile                          = "rfs"
  size                             = "200"
}

Terraformでレプリカとゾーンファイル共有を作成する

ファイル共有を作成するには、 ibm_is_share リソースを使用します。 レプリカを追加するには、以下の例のようにレプリカ共有を定義します。 220 GB 容量の共有と dp2 パフォーマンス・プロファイルを作成します。 replica_share 引数は、レプリカ共有の名前、複製の頻度 (cron 仕様内)、パフォーマンス・プロファイル、およびレプリカ共有が作成されるゾーンを定義します。

resource "ibm_is_share" "example-2" {
  allowed_transit_encryption_modes = "none"
  iops                             = "800"
  name                             = "my-share"
  profile                          = "dp2"
  size                             = "220"
  zone                             = "us-south-1"
  replica_share {
    name                           = "my-replica"
    replication_cron_spec          = "0 */5 * * *"
    profile                        = "dp2"
    zone                           = "us-south-3"
  }
}

セキュリティー・グループ・アクセス・モードでのマウント・ターゲットを使用したファイル共有の作成

VPC 内でセキュリティー・グループ・ベースの認証を許可するマウント・ターゲットを使用してファイル共有を作成するには、 ibm_is_share リソースを使用します。 アクセス制御モードを security_group として指定し、マウント・ターゲットの名前、仮想ネットワーク・インターフェースの詳細 (名前、サブネット、IP アドレスなど) を指定して、マウント・ターゲットを定義します。 また、ファイル共有へのアクセスを制御するために使用するセキュリティー・グループを指定します。 マ ウ ン ト タ ーゲ ッ ト に関連付けるセキ ュ リ テ ィ グループは、 共有を マ ウ ン ト す る すべてのサーバか ら NFS ポー ト の TCP プ ロ ト コ ルの受信ア ク セ ス を許可す る 必要があ り ます。

resource "ibm_is_share" "share4" {
   access_control_mode              = "security_group"
   allowed_transit_encryption_modes = "ipsec"
   iops                             = "3000"
   name                             = "my-share4"
   profile                          = "dp2"
   size                             = "800"
   zone                             = "us-south-2"
   mount_target {
       access_protocol              = "nfs4"
       name                         = "my-mount-target"
       resource_group               = <resource_group_id>
       security_groups.             = [<security_group_ids>]
       transit_encryption           = "ipsec"
       virtual_network_interface {
          primary_ip {
              address               = "10.240.64.5"
              auto_delete           = true
              name                  = "my-example-pip"
          }
       }
   }
}

前の例では、ゾーンファイル共有で転送中の暗号化を有効にした。 レジナル共有のトランジット暗号化でデータを保護する場合、 transit_encryption 引数に stunnel を指定します。

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

VPC 全体にわたるアクセス・モードでのマウント・ターゲットを使用したファイル共有の作成

Deprecated VPCアクセス制御モードは非推奨。 代わりにセキュリティグループオプションを選択する。

VPC 内のすべての仮想サーバーインスタンスからアクセス可能なマウントターゲットを持つゾーンファイル共有を作成するには、 ibm_is_share リソースを使用します。 アクセス制御モードとして vpc を指定し、マウント・ターゲットの名前と、それを使用する VPC を指定して、マウント・ターゲットを定義します。

resource "ibm_is_share" "share3" {
    access_control_mode   = "vpc"
    iops                  = "800"
    name                  = "my-share3"
    profile               = "dp2"
    size                  = "700"
    zone                  = "us-south-2"
    mount_target {
          access_protocol = "nfs4"
          name            = "my-mount-target"
          vpc             = <vpc_id>
    }
}

このタイプのファイル共有では、転送中のゾーン間マウントおよび暗号化はサポートされていません。