IBM Cloud Docs
ファイル共有、共有バインディング、マウントターゲットの表示

ファイル共有、共有バインディング、マウントターゲットの表示

すべてのファイル共有、そのバインディング、マウントターゲットをコンソールで表示したり、CLIやAPI、Terraformから情報を取得したりできる。 すべての共有、バインディング、およびマウント・ターゲットの情報を取得することも、特定のリソースの情報のみを取得することもできます。

コンソールでのファイル共有、共有バインディング、マウントターゲットの表示

コンソールですべてのファイル共有を表示する

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

  2. VPCのファイル共有一覧ページには、そのゾーンに作成されたすべてのファイル共有が表示されます。 「アクション」 メニュー 「アクション」アイコン オプションは、ファイル共有を管理するために使用します。 以下の表は、リストページの情報について説明したものである。

ファイル共有一覧ページ。
フィールド
リージョン ファイル共有のアカウントのリージョン。 別のリージョンを選択すると、そのリージョンの各ゾーンのファイル共有が表示されます。
名前 ファイル共有の名前。 元のファイル共有またはレプリカ・ファイル共有にすることができます。 名前をクリックすると、そのファイル共有に関する詳細が表示されます。
ステータス ファイル共有のステータスの一覧については、 ファイル共有のライフサイクルの状態を 参照してください。
マウント・ターゲット ファイル共有に関連付けられているマウント・ターゲットの数。 マウント・ターゲットは、ファイル共有ごとに VPC 1 つにつき 1 つ作成できます。
サイズ ファイル共有のサイズ (GB)。
IOPS プロファイル ファイル共有に関連付けられているパフォーマンス・プロファイルが表示されます。
複製の役割 ソース・ファイル共有との関係。 「Replica of」は、ファイル共有がリンクされているソース共有のレプリカであることを示す。 "ソース・オブ "は、リンクされているレプリカのソースを共有していることを示す。 「なし」は、ファイル共有が別の共有に複製されないことを示します。
クロスアカウントの役割 この列の値は、なしオリジン・シェア、_アクセサー・シェア_のいずれかである。 値が_なし_の場合、共有は他のアカウントや外部サービスと共有されません。 値が_オリジン共有_の場合、共有は他のアカウントや外部サービスと共有され、他のアカウントのアクセッサ共有にバインドされます。 値が_Accessor share_の場合、この共有はオリジン共有のデータにアクセスする目的でオリジン共有にバインドされます。
暗号化タイプ ファイル共有の暗号化タイプ(プロバイダー管理か顧客管理か)を示す。 お客様管理の暗号化は、独自のルート鍵を使用してデータを保護します。 UI は、 Key Protect または Hyper Protect Crypto Servicesの鍵管理サービス (KMS) も識別します。

「アクション」メニューにアクセスするには、 「アクション」アイコン をクリックします。 「アクション」メニューには、状態に応じてファイル共有を管理するためのオプションがあります。 _安定_状態のファイル共有では、共有の名前の変更、IOPSの編集、共有のCRNのコピー、レプリカの作成、ファイル共有の削除ができます。 すでにレプリカファイル共有へのレプリケーションを設定している場合、 Deleteと Create replicaは無効になります。 詳細については、レプリカファイル共有の作成

コンソールでファイル共有の詳細を表示する

  1. すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、ナビゲーションメニュー アイコン メニューアイコン インフラストラクチャ VPC アイコン ストレージ > ファイル共有 をクリックします。

  2. ファイル共有の名前をクリックして、詳細ページを表示します。 ファイル共有の編集可能な名前とステータスが表示されます。 ファイル共有にユーザーまたはアクセス管理タグを適用した場合は、ステータスの横に表示されます。 「タグの追加」 をクリックして、新しい タグ を共有に適用します。

  3. 詳細ページにはいくつかのタブがある。 デフォルトでは「 概要 」タブが表示される。

    • 概要- 次の表は、ファイル共有で利用可能な情報を説明したものです。

      ファイル共有の詳細ページ
      フィールド
      ファイル共有の詳細
      名前 ファイル共有の名前。 「編集」アイコン 「編集」アイコン をクリックして、名前を変更します。
      ファイル共有 ID ファイル共有の作成時に生成されたUUID。
      リソース・グループ アカウントでファイル共有に関連付けられたリソース・グループ。
      作成日 ファイル共有が作成された日付。
      Location ファイル共有の場所(例: us-south-2 )。
      複製の役割 ソース・ファイルの共有またはレプリカ。
      暗号化 プロバイダー管理または お客様管理の暗号化 を指定します。 ファイル共有が顧客管理キーで暗号化されている場合、暗号化インスタンス、暗号化キー名、暗号化キーCRNも表示されます。
      マウント・ターゲット・アクセス・モード ファイル共有へのアクセス権限は、サブネット内のセキュリティー・グループまたは VPC 内の仮想サーバー・インスタンスのいずれかによって付与されます。 「編集」アイコン 「編集」アイコン をクリックして、アクセス・モードを切り替えます。 セキュリティー・グループ・アクセスは、 dp2 プロファイル で作成されたファイル共有に対してのみ使用可能です。 詳しくは、「 Mount target access modes」を参照してください。
      CRN ファイル共有のコピー可能なクラウドリソース名。
      トランジット・モードでの暗号化を許可 この値は、クライアントがファイル共有にアクセスするときに転送中の暗号化が必要かどうかを示します。 「編集」アイコン 「編集」アイコン をクリックして、許可される値を変更します。 設定可能な値は、User managed(ユーザー管理)または None(なし)である。 このフィールドは、VPCアクセスモードのファイル共有には適用されません。
      クロスアカウントの役割 指定できる値は、None、Origin、Accessorです。 このフィールドは、VPCアクセスモードのファイル共有には適用されません。
      スナップショット・カウント この値は、ファイル共有で取得されたスナップショットの数を示します。 このフィールドは、VPCアクセスモードのファイル共有には適用されません。
      すべてのスナップショットで変更されたデータのサイズ これは、すべてのスナップショットにわたる請求可能なデータ量を表している。 このフィールドは、VPCアクセスモードのファイル共有には適用されません。
      プロファイルの詳細
      プロフィール ファイル共有のパフォーマンスを定義する共有 プロファイルの 名前。 ほとんどの場合、 dp2。
      サイズ GB単位のファイル共有容量。
      最大IOPS 指定された共有の最大IOPS。
      マウント・ターゲット ファイル共有に関連付けられているマウント・ターゲットの数。 マウント・ターゲットは、ファイル共有ごとに VPC 1 つにつき 1 つ作成できます。 他の VPC 用に追加のマウント・ターゲットを作成できます。 マウント・ターゲットの名前変更または削除、あるいはマウント・パスの表示を行うには、 「アクション」アイコン をクリックします。
      名前 マウント・ターゲットの名前。
      ステータス VPC 上のマウント・ターゲットの状況。
      Virtual Private Cloud このフィールドは、ファイル共有に VPC アクセス・モードがある場合に表示されます。 名前をクリックすると、そのVPCの詳細ページに移動し、そのVPCにマウント・ターゲットがある ファイル共有のリストを 見ることができます。
      サブネット このフィールドは、ファイル共有にセキュリティー・グループ・アクセス・モードがある場合に表示されます。 サブネット名をクリックすると詳細が表示されます。
      セキュリティー・グループ このフィールドは、ファイル共有にセキュリティー・グループ・アクセス・モードがある場合に表示されます。 これは、共有がメンバーになっているセキュリティー・グループの数です。
      予約済み IP このフィールドは、ファイル共有にセキュリティー・グループ・アクセス・モードがある場合に表示されます。 マウント・ターゲットに接続されている仮想ネットワーク・インターフェースの IP アドレス
      転送中の暗号化 このフィールドは、ファイル共有にセキュリティー・グループ・アクセス・モードがある場合に表示されます。 この値は有効にも無効にもできる。
      アクセサ共有バインディング このセクションは、共有が他のVPCにアクセサー共有を持っている場合に表示されます。
      バインディングID このフィールドは、起点共有をアクセサー共有に接続するバインディングの ID を示します。
      アカウント ID アクセサー共有を介して共有のデータへのアクセス権限を持つアカウントの ID。
      アクセサー ID このフィールドには、別の VPC でアクセサー共有を作成したアカウント ID が表示されます。
      ステータス アクセサー・ファイル共有のライフサイクル状況が表示されます。 status Stable が予期されています
      作成日 アクセサーシェアが作成された日時。
      ファイル共有の複製関係

      ソースとレプリカ・ファイル共有の名前、場所、および状況を表示します。

      • レプリカ・ファイル共有が作成されていない場合は、 「レプリカの作成」 をクリックして レプリカを作成 します。
      • 複製関係を切断するには、 「複製関係の削除」 をクリックします。 その後、レプリカ・ファイル共有は独立した読み取り/書き込みファイル共有になります。
      複製頻度 情報アイコンにカーソルを合わせると、cronレプリケーションスケジュールの説明が表示されます。
      ステータス 複製状況 (例えば、中断状態 または 使用可能)。
      最終同期開始時刻 最後の複製が開始された日時。
      最終同期完了時刻 最後にレプリケーションが終了した日時。
      転送速度 これは、最後の同期中にソース・ファイル共有からレプリカにデータがコピーされた速度を示します。
      振替金額 最後の同期中にソース・ファイル共有からそのレプリカにコピーされたデータの量。
      複製の役割 ソース・ファイルまたはレプリカ・ファイルの共有。
      ファイル共有名 ファイル共有名をクリックすると、その詳細が表示されます。
      Location ファイル共有のゾーン情報が表示されます。
      ステータス ファイル共有のライフサイクル状況が表示されます。 status Stable が予期されています。
    • スナップショット- 「スナップショット」タブでは、すべてのスナップショットに関する概要と、ファイル共有から取得されたスナップショットのリストを確認できます。

      • スナップショット・サマリーは、スナップショットの数、スナップショットでキャプチャされた全体のデータ量、レプリケーションの役割などの情報を提供します。
      • スナップショットリストには、ファイル共有のスナップショットが表示されます。 名前、スナップショットが取られた時のファイル共有のサイズ、スナップショットのステータスを見ることができます。 Create をクリックすると、新しいスナップショットをキャプチャできます。 アクションアイコン アクションアイコン アクションをクリックして、アクションメニューを表示します。 Actionsメニューには2つのオプションがあります:復元」と「削除」です。
    • モニタリング- 「モニタリング」タブでは、共有使用量、合計スループット、合計IOPSの3つのグラフを見ることができます。 これらのグラフは、IBM Cloud Monitoringインスタンスがなくても、無料で利用できます。 日付範囲をカスタマイズして、時系列でデータを表示することができます。

      これらの使用率メトリクスを監視することで、アプリケーションまたはワークロードによってどれだけの作業が行われたかを判断することができます。 この情報を使って、IOPS値を調整する必要があるかどうかを判断できる。 共有の利用可能容量を監視することで、共有へのデータ書き込みやレプリケーションで容量不足が問題になる前に、より多くのストレージの必要性を特定することができます。 これらの指標を見ることで、請求期間終了時の料金の変動を予測することができます。

      これらの指標はリアルタイムでは更新されない。 新しいファイル共有のデータは、ダッシュボードに表示されるまでに1時間または1時間15分かかることがあります。 利用状況の変化がグラフに反映されるには15分から30分かかる。

      IBM Cloud Monitoring サービスのインスタンスがある場合は、 Launch monitoring をクリックして Sysdig Web UI を開き、そこでメトリクス・ダッシュボードを操作します。 IBM Cloud Monitoringインスタンスの設定方法の詳細については、File Storage for VPC のメトリクスを監視するを参照してください。

コンソールでVPCのすべてのファイル共有を表示する

VPC の詳細ページを表示して、その VPC にマウント・ターゲットがあるすべてのファイル共有を確認できます。

  1. 以下のようにして VPC にアクセスします。

    1. ファイル共有の詳細のページで、マウント・ターゲットのリストにある対象の VPC のリンクをクリックします。
    2. UIから、ナビゲーションメニューアイコン メニューアイコン インフラストラクチャ VPCアイコン ネットワーク > VPC をクリックします。 リストで VPC の名前をクリックします。
  2. VPC の詳細ページで、**「この VPC にあるファイル共有 (File shares in this VPC)」**にスクロールします。

コンソールでマウントターゲットの詳細を表示する

  1. すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、ナビゲーションメニュー アイコン メニューアイコン インフラストラクチャ VPC アイコン ストレージ > ファイル共有 をクリックします。
  2. ファイル共有の名前をクリックして、詳細ページを表示します。
  3. 「マウント・ターゲット」セクションまでスクロールして、マウント・ターゲットのリストを表示します。 リストには、マウント・ターゲットの名前と状況、およびマウント・ターゲットが属する VPC が含まれます。
  4. アクションアイコン アクションアイコン アクションをクリックして、アクションメニューを表示します。 「アクション」メニューには、「名前変更」、「ビュー・パス」、および「削除」の 3 つのオプションがあります。
  5. 「パスの表示」 をクリックして、マウント・コマンドにコピー・アンド・ペーストできるマウント・パス情報を表示します。

CLI からのファイル共有、共有バインディング、およびマウント・ターゲットの表示

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

CLIからすべてのファイル共有を表示する

ibmcloud is shares コマンドを使用して、地域内のすべてのファイル共有をリストできます。

ibmcloud is shares
Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...

ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size   
r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0   
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0   
r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0   
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0   
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0   
r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0   

コマンド・オプションについて詳しくは、「 ibmcloud is shares」を参照してください。 lifecycle state について詳しくは、 ファイル共有状況 を参照してください。 Stable が予期されています。

CLIからファイル共有の詳細を表示する

ファイル共有の詳細を表示するには、 ibmcloud is share コマンドを実行し、ファイル共有を ID または名前で指定します。

次の例では、IDでファイル共有を識別している。 この共有は、 dp2 プロファイルに基づくレプリカであり、共有へのアクセス権限はセキュリティー・グループを使用して付与されます。 出力には、ソース・ファイル共有と複製の詳細に関する情報も示されます。

$ ibmcloud is share r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Getting file share r006-455b601c-8fc1-4476-8771-4708c49c8ef7 under account Test Account as user test.user@ibm.com...

ID                                 r006-455b601c-8fc1-4476-8771-4708c49c8ef7   
Name                               my-replica-share-dal-1   
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7   
Lifecycle state                    stable   
Access control mode                security_group   
Accessor binding role              none   
Allowed transit encryption modes   none,user_managed   
Zone                               us-south-1   
Profile                            dp2   
Size(GB)                           10   
IOPS                               100   
Encryption                         provider_managed   
Mount Targets                      ID                          Name      
                                   No mounted targets found.      

Resource group                     ID                                 Name      
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults      

Created                            2025-04-04T09:19:27+00:00   
Latest job                         Job status   Job status reasons      
                                   succeeded    -      

Latest Sync                        Completed At                Data Transferred   Started At      
                                   2025-04-18T21:00:04+00:00   3560               2025-04-18T21:00:00+00:00      

Replication cron spec              00 * * * *   
Replication role                   replica   
Replication status                 active   
Replication status reasons         Status code   Status message      
                                   -             -      

Source share                       ID                                          Name                    Resource type      
                                   r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   share      

Snapshot count                     0   
Snapshot size                      0   
Source snapshot                    -   

ソース共有の名前を使用して、その詳細を取得できます。 以下の例を参照してください。

$ ibmcloud is share my-source-file-share
Getting file share my-source-file-share under account Test Account as user test.user@ibm.com...

ID                               r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   
Name                             my-source-file-share   
CRN                              crn:v1:bluemix:public:is:us-south-2:a/a1234567b::share:r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   
Lifecycle state                  stable   
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes user_managed,none
Zone                             us-south-2   
Profile                          dp2   
Size(GB)                         1500   
IOPS                             2000   
User Tags                        env:dev   
Encryption                       provider_managed   
Mount Targets                    ID                                          Name      
                                 r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target      

Resource group                   ID                                 Name      
                                 db8e8d865a83e0aae03f25a492c5b39e   Default      

Created                          2024-06-25T15:42:53+00:00   
Latest job                       Job status   Job status reasons      
                                 succeeded    -      

Replication share                ID                                          Name                    Resource type      
                                 r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   share      

Replication role                 source   
Replication status               active   
Replication status reasons       Status code   Status message      
                                 -             -
Snapshot count                   0
Snapshot size                    0

コマンド・オプションについて詳しくは、「 ibmcloud is share」を参照してください。

CLI からのファイル共有の共有バインディングの表示

CLIからオリジン共有にリンクされているアクセサ共有バインディングを表示するには、ibmcloud is share-accesssor-bindings コマンドを使用します。 以下の例を参照してください。

$ ibmcloud is share-accessor-bindings my-origin-share
Listing accessor bindings for the share ID my-origin-share under account Test Account as user test.user@ibm.com...

ID                                           Lifecycle state  Created at                 Accessor CRN
r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3   stable           2024-06-25T00:50:57+05:30  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232

CLI からのファイル共有の特定の共有バインディングの表示

CLIからオリジン共有にリンクされている特定のアクセサー共有バインディングを表示するには、ibmcloud is share-accesssor-binding コマンドを使用します。 以下の例を参照してください。

$ ibmcloud is share-accessor-binding my-origin-share r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Get accessor binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for the share ID my-origin-share under account Test Account as user test.user@ibm.com...

ID               r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Created          2024-06-25T00:50:57+05:30
Href             https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed/bindings/r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Resource type    share_accessor_binding
Lifecycle state  stable
Accessor         Resource type  Name               CRN
                 share          my-accessor-share  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232

CLIからファイル共有のマウントターゲットを表示する

ファイル共有用に作成されたすべてのマウント・ターゲットを表示するには、 ibmcloud is share-mount-targets コマンドを実行してファイル共有 ID を指定します。

$ ibmcloud is share-mount-targets  r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Listing share mount target of r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                     VPC      Lifecycle state   Transit Encryption   
r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target   my-vpc   stable            none   

コマンド・オプションについて詳しくは、「 ibmcloud is share-mount-targets」を参照してください。

CLI からのマウント・ターゲットの詳細の表示

マウント・ターゲットに関する詳細情報を表示するには、 ibmcloud is share-mount-target コマンドを実行し、共有 ID または共有名をマウント・ターゲットの名前または ID と共に指定します。 以下の例を参照してください。

$ ibmcloud is share-mount-target  r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-mount-target
Getting mount target ID my-source-mount-target for share ID r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a under account Test Account as user test.user@ibm.com...

ID                          r006-fdbffc45-618c-49f1-bb08-ec530d7be378   
Name                        my-source-mount-target   
VPC                         ID                                          Name      
                            r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b   my-vpc      

Access control mode         security_group   
Resource type               share_mount_target   
Virtual network interface   ID                                          Name      
                            r006-3b0c00fa-0ce3-4ff8-9a5d-c7a645fbe530   my-source-vni      

Lifecycle state             stable   
Mount path                  10.240.64.6:/5975a795_e5e7_474c_82d3_46c1d4159c6a   
Transit Encryption          none   
Created                     2023-10-19T15:42:54+00:00   

コマンド・オプションについて詳しくは、「 ibmcloud is share-mount-target」を参照してください。

API を使用したファイル共有、共有バインディング、およびマウント・ターゲットの表示

以下のサンプル要求に示すように、 VPC API/shares メソッドを呼び出すことにより、共有とマウント・ターゲットをプログラマチックに表示できます。

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

API を使用した複製状況および lifecycle_state の表示

  • lifecycle_state
    • このプロパティーは、 ファイル共有の取得 メソッドを使用して、リソースの現在の状態を提供します。 lifecycle_state が提供する値は一般的なもので、ファイル共有だけでなく、さまざまなリソースに適用することを意図している。 lifecycle_state は、ファイル共有が安定しているか、更新中か、削除中か、一時停止中か、などを示す。 Stable は期待されている。 詳しくは、 ファイル共有状況 を参照してください。
  • replication_status
    • このプロパティーは、 「ファイル共有の取得」 メソッドを使用して、ファイルの現在の複製状況を提供します。 replication_status が返す値は、ファイル共有に固有のものです。 詳細については、 Virtual Private Cloud API の コンテンツを参照してください。

APIですべてのファイル共有を表示する

領域のすべてのファイル共有をリストするには、GET /shares 要求を行います。

curl -X GET "$vpc_api_endpoint/v1/shares?version=2023-07-18?limit=50&generation=2" -H "Authorization: $iam_token"

正常な応答は、次の例のようになります。 この例では、'limit クエリーパラメーターが50ファイル共有の制限を指定しているが、応答例には1つしか含まれていない。 access_control_mode プロパティーの値は vpc です。これは、VPC 内のすべての仮想サーバー・インスタンスにファイル共有をマウントできることを意味します。

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares?limit=50"
  },
  "limit": 50,
  "shares": [
    {
      "access_control_mode": "vpc",
      "created_at": "2023-07-18T13:02:17Z",
      "crn": "crn:[...]",
      "encryption": "provider_managed",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
      "id": "51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
      "iops": 3000,
      "lifecycle_state": "stable",
      "name": "share-name1",
      "profile": {
        "family": "tiered",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
        "name": "tier-10iops",
        "resource_type": "share_profile"
      },
      "resource_group": {
        "crn": "crn:[...]",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/60fc731a-1794-4f5d-ba51-ea24b5357207",
        "id": "60fc731a-1794-4f5d-ba51-ea24b5357207",
        "name": "Default"
      },
      "resource_type": "share",
      "size": 40,
      "mount_targets": [
        {
          "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
          "id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
          "name": "mount-target-name1",
          "resource_type": "share_target",
          "vpc": {
            "crn": "crn:[...]",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c2d941de-27f5-432c-b4d0-37a8491c3216",
            "id": "c2d941de-27f5-432c-b4d0-37a8491c3216",
            "name": "vpc-name1",
            "resource_type": "vpc"
          }
        }
      ],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    }
  ]
}

APIで単一のファイル共有を表示する

単一のファイル共有に関する詳細を取得するには、GET /shares/{share_id} 要求を行います。

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-04-01&generation=2"\
-H "Authorization: $iam_token"

正常な応答は、次の例のようになります。 この例では、共有は「dp2 プロファイルで作成されている。 access_ control_mode プロパティーの値は security_group です。これは、共有へのアクセスがセキュリティー・グループのルールによって決定されることを意味します。

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_transit_encryption_modes": [
      "none",
      "user_managed"
  ],
  "created_at": "2025-04-04T09:17:14.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "id": "r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "iops": 100,
  "latest_job": {
      "status": "succeeded",
      "status_reasons": [],
      "type": "replication_init"
  },
  "lifecycle_reasons": [],
  "lifecycle_state": "stable",
  "mount_targets": [],
  "name": "my-source-share-dal-2",
  "profile": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
      "name": "dp2",
      "resource_type": "share_profile"
  },
  "replica_share": {
      "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "id": "r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "name": "my-replica-share-dal-1",
      "resource_type": "share"
  },
  "replication_role": "source",
  "replication_status": "active",
  "replication_status_reasons": [],
  "resource_group": {
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
      "id": "6edefe513d934fdd872e78ee6a8e73ef",
      "name": "defaults"
  },
  "resource_type": "share",
  "size": 10,
  "snapshot_count": 0,
  "snapshot_size": 0,
  "user_tags": [],
  "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
      "name": "us-south-2"
  }
}

API とのファイル共有の共有バインディングをリストします

単一ファイル共有のバインディングのリストを取得するには、 GET /shares/{id}/bindings 要求を実行します。 この要求は、共有のすべてのバインディングをリストします。 各バインディングは、アクセサー共有の作成時に暗黙的に作成されます。

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"

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

{
  "bindings": [
    {
      "accessor": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "id": "r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "name": "my-accessor-share",
        "resource_type": "share"
      },
      "account": {
        "id": "a0000000000000000000000000000001",
        "resource_type": "account"
      },
      "created_at": "2022-01-07T16:56:54Z",
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
      "id": "r134-df760133-3513-47e7-b980-26cca666561b",
      "lifecycle_state": "stable",
      "name": "my-share-bind",
      "resource_type": "share_binding"
    }
  ],
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-65f30e48-3074-4eb0-9ec4-51ce2ec968eb/bindings?limit=20"
  },
  "limit": 50,
  "total_count": 1
}

API を使用したファイル共有の特定のバインディングの表示

ファイル共有の特定のバインディングの情報を取得するには、 GET /shares/{share_id}/bindings/{binding_id} 要求を行います。 このリクエストは、URLの識別子で指定された1つのバインディングを取得します。

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings/$binding_id?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"

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

{
  "accessor": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "id": "r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "name": "my-accessor-share",
    "resource_type": "share"
  },
  "account": {
    "id": "a0000000000000000000000000000001",
    "resource_type": "account"
  },
  "created_at": "2022-01-07T16:56:54Z",
  "crn": "crn:[...]",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
  "id": "r134-df760133-3513-47e7-b980-26cca666561b",
  "lifecycle_state": "stable",
  "name": "my-share-bind",
  "resource_type": "share_binding"
}

API を使用したファイル共有のすべてのマウント・ターゲットのリスト

ファイル共有のすべてのマウント・ターゲットをリストするには、GET /shares/{share_id}/mount_targets 要求を行います。

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

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-07-18?limit=50&generation=2"\
-H "Authorization: $iam_token"

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

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets?limit=50"
  },
  "limit": 50,
  "mount_targets": [
    {
      "access_control_mode": "security_group",
      "created_at": "2023-07-18T01:59:46.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "lifecycle_reasons": [],
      "lifecycle_state": "stable",
      "mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_voll_mz0716_a4cc07a3_4425_4adf_aed6_0d7e142bee0c",
      "name": "my-target",
      "primary_ip": {
        "address": "192.0.2.0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752/reserved_ips/0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
        "id": "0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
        "name": "my-reserved-ip",
        "resource_type": "subnet_reserved_ip"
      },
      "resource_type": "share_mount_target",
      "security_groups": [
        {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
          "id": "r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
          "name": "my-security-group",
          "resource_type": "security_group"
        }
      ],
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752",
        "id": "35984145-9c3a-4626-8ee7-52c7a8742752",
        "name": "my-subnet",
        "resource_type": "subnet"
      },
      "transit_encryption": "none",
      "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/388f01db-41bb-42aa-b5cd-34ba41288d47",
        "id": "388f01db-41bb-42aa-b5cd-34ba41288d47",
        "name": "my-virtual-network-interface",
        "resource_type": "virtual_network_interface"
      },
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
        "id": "4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "total_count": 1
}

APIで単一のマウントターゲットを表示する

ファイル共有の単一マウント・ターゲットの情報に対して GET /shares/{share_id}/mount_targets/{mount_target_id} 要求を行います。 この呼び出しにはマウント・パスの情報が含まれます。 このマウント・パスを使用して、ファイル共有をインスタンスに接続できます。

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

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$mount_target_id?version=2023-07-18&generation=2"\
-H "Authorization: $iam_token"

正常な応答は、次の例のようになります。 この例では、 data encryption in transit は有効になっていません。 transit_encryption プロパティーの値は provider_managed です。

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T01:59:46.000Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares//199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
    "id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
    "lifecycle_reasons": [],
    "lifecycle_state": "stable",
    "mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
    "name": "my-mount-target2",
    "primary_ip": {
      "address": "192.0.2.0",
      "href": "https://us-south.iaas.cloud.ibm.com/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a/reserved_ips/b96d456e-88f7-42a7-b02d-450a6d758534",
      "id": "b96d456e-88f7-42a7-b02d-450a6d758534",
      "name": "my-reserved-ip",
      "resource_type": "subnet_reserved_ip"
    },
    "resource_type": "share_mount_target",
    "security_groups": [
      {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/b79365be-f626-45d4-94ae-83f16fa4edd3",
        "id": "b79365be-f626-45d4-94ae-83f16fa4edd3",
        "name": "my-security-group",
        "resource_type": "security_group"
      }
    ],
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a",
      "id": "c2338e66-dcb5-4e9b-b572-108d47ca479a",
      "name": "my-subnet",
      "resource_type": "subnet"
    },
    "transit_encryption": "provider_managed",
    "virtual_network_interface": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/4551a68d-b45d-4443-b6b3-aba7a4a18c98",
      "id": "4551a68d-b45d-4443-b6b3-aba7a4a18c98",
      "name": "my-virtual-network-interface",
      "resource_type": "virtual_network_interface"
    },
    "vpc": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/5821d0c4-a089-4957-b5fa-03b7ac636c15",
      "id": "5821d0c4-a089-4957-b5fa-03b7ac636c15",
      "name": "my-vpc",
      "resource_type": "vpc"
    }
  }

APIでレプリカファイル共有のソースファイル共有を表示する

GET /shares/{replica_id}/source 要求を行い、レプリカ共有 ID を指定して、ソース・ファイル共有の詳細を取得します。

curl -X GET \
"$vpc_api_endpoint/v1/shares/$replica_id/source?version=2023-07-18&generation=2"\
-H "Authorization: $iam_token"\

正常な応答では、ソース・ファイル共有の詳細が提供されます。 複製の役割が sourceであることに注意してください。

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T22:58:49.000Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3",
    "id": "207721a9-aff9-4b16-9823-fe68096aeac3",
    "iops": 14400,
    "lifecycle_state": "stable",
    "mount_targets": [
      {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3/mount_targets/ce244454-0919-45e2-b14b-f4285afcd856",
        "id": "ce244454-0919-45e2-b14b-f4285afcd856",
        "name": "my-share-mount-target",
        "resource_type": "share_mount_target",
        "vpc": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
          "id": "c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
          "name": "my-vpc",
          "resource_type": "vpc"
        }
      }
    ],
    "name": "my-share-3",
    "profile": {
      "family": "defined-performance",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
      "name": "dp2",
      "resource_type": "share_profile"
    },
    "replication_role": "source",
    "replication_status": "active",
    "replication_status_reasons": [],
    "resource_group": {
      "crn": "crn:[...]",
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada915d32640909956",
      "id": "678523bcbe2b4eada915d32640909956",
      "name": "Default"
    },
    "resource_type": "share",
    "size": 4800,
    "snapshot_count": 10,
    "snapshot_size": 10,
    "user_tags": [],
    "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
      "name": "us-south-1",
      "resource_type": "zone"
    }
  }

Terraformでファイル共有とマウントターゲットを見る

Terraform を使用して、ファイル共有およびマウント・ターゲットに関する情報を表示できます。

Terraform を使用するには、Terraform CLI をダウンロードし、 IBM Cloud Provider プラグインを構成します。 詳しくは、 Terraform の概要 を参照してください。

VPC インフラストラクチャー・サービスは、デフォルトで us-south をターゲットとする特定のリージョン・エンドポイントを使用します。 VPC が別のリージョンに作成されている場合は、 provider.tf ファイル内のプロバイダー・ブロックで適切なリージョンをターゲットにしてください。

デフォルトの us-south 以外の地域をターゲットにする例を以下に示します。

provider "ibm" {
  region = "eu-de"
}

Terraform でのすべてのファイル共有の表示

アカウントに属するファイル共有のリストを読み取り専用データ・ソースとしてインポートします。 共有名またはリソース・グループ ID でフィルターに掛けることができます。

data "ibm_is_shares" "example" {
}

エクスポートされる属性には、共有の総数と共有のリストが含まれます。 ネストされた属性には、共有 ID、名前、作成日、サイズ、IOPS、CRN、アクセス・タグ、暗号化タイプと鍵、ライフサイクル状態、複製の役割と状況、マウント・ターゲット、およびその他の属性が含まれます。

詳しくは、 ibm_is_sharesを参照してください。

Terraform でのファイル共有情報の表示

ファイル共有の詳細を読み取り専用データ・ソースとしてインポートします。 ID または名前で共有を識別する必要があります。

data "ibm_is_share" "example" {
  share = ibm_is_share.example.id
}
data "ibm_is_share" "example1" {
  name = ibm_is_share.example.name
}

エクスポートされる属性には、ID、名前、作成日、サイズ、IOPS、CRN、アクセス・タグ、暗号化タイプ、暗号鍵、ライフサイクル状態、複製の役割と状況、マウント・ターゲット、およびその他の属性が含まれます。

詳しくは、 ibm_is_shareを参照してください。

Terraform でのファイル共有に関連付けられたマウント・ターゲットの表示

ファイル共有に関連付けられているマウント・ターゲットのリストを読み取り専用データ・ソースとしてインポートします。 ID によってファイル共有を識別します。

data "ibm_is_share_targets" "example" {
  share = ibm_is_share.example.id
}

エクスポートされる属性には、マウント・ターゲットとその ID、名前、作成日、マウント・パス、サブネット情報などのリストが含まれます。

詳しくは、 ibm_is_share_targetsを参照してください。

Terraform を使用したマウント・ターゲット情報の表示

マウント・ターゲットの詳細を読み取り専用データ・ソースとしてインポートします。 共有 ID とマウント・ターゲット ID を指定して、マウント・ターゲットを識別します。 両方の引数が必要です。

data "ibm_is_share_target" "example" {
  share        = ibm_is_share.example.id
  share_target = ibm_is_share_target.example.share_target
}

エクスポートされる属性には、ID、名前、作成日、マウント・パス、サブネット情報、およびその他の属性が含まれます。

詳しくは、 ibm_is_share_targetを参照してください。

次のステップ

ファイル共有をマウントします。 マウントは、サーバーのオペレーティング・システムが、ストレージ・デバイス上のファイルおよびディレクトリーを、ユーザーがサーバーのファイル・システムを介してアクセスできるようにするプロセスです。 詳しくは、以下のトピックを参照してください。

ファイル共有とデータを管理します。

  • ファイル共有の管理 ファイル共有の名前を変更できます。 その容量を増やし、その IOPS を変更することができます。 ファイル共有にマウント・ターゲットを追加できます。 マウント・ターゲットの名前変更または削除を行うことができます。 不要になったファイル共有は削除できます。
  • 複製を使用してファイル共有を作成します。 複製機能を使用すると、ファイル共有の読み取り専用コピーを別のゾーンに保持できます。 レプリカ共有は、指定したスケジュールでソース共有から更新されます。 複製により、データがアクセス不能になった場合やアプリケーションに障害が発生した場合に、1 次サイトのインシデントから復旧することができます。 複製は地理的拡張にも使用できます。