ファイル共有、共有バインディング、マウントターゲットの表示
すべてのファイル共有、そのバインディング、マウントターゲットをコンソールで表示したり、CLIやAPI、Terraformから情報を取得したりできる。 すべての共有、バインディング、およびマウント・ターゲットの情報を取得することも、特定のリソースの情報のみを取得することもできます。
コンソールでのファイル共有、共有バインディング、マウントターゲットの表示
コンソールですべてのファイル共有を表示する
-
IBM Cloud コンソールで、ナビゲーションメニュー アイコン
インフラストラクチャ
ストレージ > ファイル共有 をクリックします。
-
VPCのファイル共有一覧ページには、そのゾーンに作成されたすべてのファイル共有が表示されます。 「アクション」 メニュー
オプションは、ファイル共有を管理するために使用します。 以下の表は、リストページの情報について説明したものである。
フィールド | 値 |
---|---|
リージョン | ファイル共有のアカウントのリージョン。 別のリージョンを選択すると、そのリージョンの各ゾーンのファイル共有が表示されます。 |
名前 | ファイル共有の名前。 元のファイル共有またはレプリカ・ファイル共有にすることができます。 名前をクリックすると、そのファイル共有に関する詳細が表示されます。 |
ステータス | ファイル共有のステータスの一覧については、 ファイル共有のライフサイクルの状態を 参照してください。 |
マウント・ターゲット | ファイル共有に関連付けられているマウント・ターゲットの数。 マウント・ターゲットは、ファイル共有ごとに VPC 1 つにつき 1 つ作成できます。 |
サイズ | ファイル共有のサイズ (GB)。 |
IOPS プロファイル | ファイル共有に関連付けられているパフォーマンス・プロファイルが表示されます。 |
複製の役割 | ソース・ファイル共有との関係。 「Replica of」は、ファイル共有がリンクされているソース共有のレプリカであることを示す。 "ソース・オブ "は、リンクされているレプリカのソースを共有していることを示す。 「なし」は、ファイル共有が別の共有に複製されないことを示します。 |
クロスアカウントの役割 | この列の値は、なし、オリジン・シェア、_アクセサー・シェア_のいずれかである。 値が_なし_の場合、共有は他のアカウントや外部サービスと共有されません。 値が_オリジン共有_の場合、共有は他のアカウントや外部サービスと共有され、他のアカウントのアクセッサ共有にバインドされます。 値が_Accessor share_の場合、この共有はオリジン共有のデータにアクセスする目的でオリジン共有にバインドされます。 |
暗号化タイプ | ファイル共有の暗号化タイプ(プロバイダー管理か顧客管理か)を示す。 お客様管理の暗号化は、独自のルート鍵を使用してデータを保護します。 UI は、 Key Protect または Hyper Protect Crypto Servicesの鍵管理サービス (KMS) も識別します。 |
「アクション」メニューにアクセスするには、 をクリックします。 「アクション」メニューには、状態に応じてファイル共有を管理するためのオプションがあります。 _安定_状態のファイル共有では、共有の名前の変更、IOPSの編集、共有のCRNのコピー、レプリカの作成、ファイル共有の削除ができます。 すでにレプリカファイル共有へのレプリケーションを設定している場合、
Deleteと Create replicaは無効になります。 詳細については、レプリカファイル共有の作成。
コンソールでファイル共有の詳細を表示する
-
すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、ナビゲーションメニュー アイコン
インフラストラクチャ
ストレージ > ファイル共有 をクリックします。
-
ファイル共有の名前をクリックして、詳細ページを表示します。 ファイル共有の編集可能な名前とステータスが表示されます。 ファイル共有にユーザーまたはアクセス管理タグを適用した場合は、ステータスの横に表示されます。 「タグの追加」 をクリックして、新しい タグ を共有に適用します。
-
詳細ページにはいくつかのタブがある。 デフォルトでは「 概要 」タブが表示される。
-
概要- 次の表は、ファイル共有で利用可能な情報を説明したものです。
ファイル共有の詳細ページ フィールド 値 ファイル共有の詳細 名前 ファイル共有の名前。 「編集」アイコン をクリックして、名前を変更します。
ファイル共有 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 にマウント・ターゲットがあるすべてのファイル共有を確認できます。
-
以下のようにして VPC にアクセスします。
- ファイル共有の詳細のページで、マウント・ターゲットのリストにある対象の VPC のリンクをクリックします。
- UIから、ナビゲーションメニューアイコン
インフラストラクチャ
ネットワーク > VPC をクリックします。 リストで VPC の名前をクリックします。
-
VPC の詳細ページで、**「この VPC にあるファイル共有 (File shares in this VPC)」**にスクロールします。
コンソールでマウントターゲットの詳細を表示する
- すべてのファイル共有のリストにアクセスします。 IBM Cloud コンソールから、ナビゲーションメニュー アイコン
インフラストラクチャ
ストレージ > ファイル共有 をクリックします。
- ファイル共有の名前をクリックして、詳細ページを表示します。
- 「マウント・ターゲット」セクションまでスクロールして、マウント・ターゲットのリストを表示します。 リストには、マウント・ターゲットの名前と状況、およびマウント・ターゲットが属する VPC が含まれます。
- アクションアイコン
アクションをクリックして、アクションメニューを表示します。 「アクション」メニューには、「名前変更」、「ビュー・パス」、および「削除」の 3 つのオプションがあります。
- 「パスの表示」 をクリックして、マウント・コマンドにコピー・アンド・ペーストできるマウント・パス情報を表示します。
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
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を参照してください。
次のステップ
ファイル共有をマウントします。 マウントは、サーバーのオペレーティング・システムが、ストレージ・デバイス上のファイルおよびディレクトリーを、ユーザーがサーバーのファイル・システムを介してアクセスできるようにするプロセスです。 詳しくは、以下のトピックを参照してください。
- IBM Cloud ファイル共有マウント・ヘルパー・ユーティリティー
- Red Hat Linux でのファイル共有のマウント
- CentOS でのファイル共有のマウント
- Ubuntu でのファイル共有のマウント
- z/OS
ファイル共有とデータを管理します。
- ファイル共有の管理 ファイル共有の名前を変更できます。 その容量を増やし、その IOPS を変更することができます。 ファイル共有にマウント・ターゲットを追加できます。 マウント・ターゲットの名前変更または削除を行うことができます。 不要になったファイル共有は削除できます。
- 複製を使用してファイル共有を作成します。 複製機能を使用すると、ファイル共有の読み取り専用コピーを別のゾーンに保持できます。 レプリカ共有は、指定したスケジュールでソース共有から更新されます。 複製により、データがアクセス不能になった場合やアプリケーションに障害が発生した場合に、1 次サイトのインシデントから復旧することができます。 複製は地理的拡張にも使用できます。