ファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの管理
File Storage for VPC の共有を管理するには、名前の変更、容量の拡張、IOPSおよび帯域幅の調整、マウントターゲットの追加、およびアクセサの共有バインディングの管理を行います。
File Storage for VPC サービスには、ロールベースのアクセス制御のためのIAMパーミッションが必要です。 たとえば、ファイル共有を作成するには、少なくとも「編集者」権限が必要です。 詳細については、VPC インフラストラクチャ サービスの IAM アクセスの管理 ファイル共有用。
コンソールでのファイル共有、アクセサー共有バインディング、マウントターゲットの管理
コンソールでは、以下を行うことができます。
- ファイル共有の名前を変更します。
- ファイル共有のマウント先を名前変更します。
- ファイル共有プロファイルを更新します (アクセサー共有には適用されません)。
- Update allowed transit encryption modes (アクセサー共有には適用されません)。
- ファイル共有の容量を増やす
- ゾーンファイル共有のIOPSを調整する
- 地域ファイル共有の帯域幅制限の調整
- ファイル共有にユーザータグを追加します。
- ファイル共有のマウント先を削除します。
- ファイル共有を削除します。
コンソールでは、通常のファイル共有およびアクセサー共有を管理できます。 共有所有者のみが、アクセス制御モード、IOPS、およびプロファイルなどのプロパティーを変更できます。 アクセサー・アカウントは起点共有を編集できず、アクセサー共有のより小さいプロパティー・セットを変更できます。
スナップショットは、アクセス・コントロール・モードとしてセキュリティ・グループが設定されている共有でのみサポートされます。 共有のスナップショットをすべて削除しない限り、アクセス制御モードをVPCに変更することはできません。
コンソールでファイル共有のマウント先を名前変更する
- 「ファイル共有の詳細」 ページに移動します。
- 「アクション」アイコン
をクリックします。
- **「名前変更」**を選択します。
- 新しい名前を入力し、**「名前変更」**をクリックします。
有効なマウント・ターゲット名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 マウント・ターゲット名の先頭は小文字にする必要があります。
コンソールでファイル共有プロファイルを更新する
これらの手順は、ゾーンファイル共有のベータリリースで使用された旧世代のファイル共有プロファイル(汎用、5-iops、10-iops、またはカスタム)用です。 2026年5月6日現在、これらのシェアプロファイルは[非推奨となって]いる{: tag-deprecated}。 現在の機能にアクセスするには、共有の IOPS プロファイルを dp2 に変更する必要があります。 dp2 または rfs プロファイルで作成されたファイル共有のプロファイルは変更できません。
ファイル共有のプロファイルは、現在のプロファイルから別の IOPS 層 プロファイル、 カスタム ・プロファイル、または高性能 dp2 プロファイルに変更できます。 ご請求は、お客様が選択されたプロファイルに基づいて調整されます。
- 「ファイル共有の詳細」 ページに移動します。
- 現在のプロファイルの横にある 「編集」アイコン
をクリックするか、 「アクション」 メニュー
を使用して 「IOPS プロファイルの編集」 を選択します。 サイド・パネルには、現行プロファイル、ファイル共有サイズ、および最大 IOPS が表示されます。
- 「新規プロファイル」 の場合は、下矢印をクリックします。 新規 IOPS ティア、カスタム・プロファイル、または dp2を選択できます。 「カスタム IOPS」 または dp2 の場合、ファイル共有サイズに基づいて新しい最大 IOPS を指定します。 ファイル共有価格は、選択内容に基づいて自動的に計算されます。
- 「 保存して続行 」をクリックしてください。
コンソールで許可されたトランジット暗号化モードを更新する
共有の所有者は、許可されたトランジット暗号化モードを変更することができます。 ただし、このプロパティーを変更する前に、すべてのバインディングを削除する必要があります。 バインディングを削除すると、起点ファイル共有とアクセサー共有の間のネットワーク・パスが切断され、アクセサー共有に接続されているマウント・ターゲットが失敗状態になります。 詳しくは、 他のアカウントからのファイル共有へのアクセス権限の削除 を参照してください。
- ファイル共有のリストからファイル共有を選択します。
- 「ファイル共有の詳細」ページで、許可されている伝送暗号化モードを見つけます。
- 現行値を変更するには、 「編集」アイコン
をクリックします。
CLI からのファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの管理
CLI を使用すると、以下のことが可能です:
- ファイル共有の名前を変更します。
- ファイル共有のマウント先を名前変更します。
- ファイル共有プロファイルを更新します (アクセサー共有には適用されません)。
- Update allowed transit encryption modes (アクセサー共有には適用されません)。
- ファイル共有の容量を増やす
- ゾーンファイル共有のIOPSを調整する
- 地域ファイル共有の帯域幅制限の調整
- ファイル共有にユーザータグを追加します。
- ファイル共有のマウント先を削除します。
- ファイル共有を削除します。
スナップショットは、アクセス・コントロール・モードとしてセキュリティ・グループが設定されている共有でのみサポートされます。 共有のスナップショットをすべて削除しない限り、アクセス制御モードをVPCに変更することはできません。
CLI からファイル共有のマウント先を名前変更する
-
ibmcloud is sharesコマンドを使用して、地域内のファイル共有をリストします。 名前変更するマウント・ターゲットが含まれているファイル共有の名前と ID をメモします。 -
共有の名前または ID を使用して、
ibmcloud is share-mount-targetsコマンドでそのマウント・ターゲットを見つけます。ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 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 -
マウント・ターゲットの名前を変更するには、ファイル共有の名前または ID、およびマウント・ターゲットの名前を指定して
share-mount-target-updateコマンドを実行します。--nameオプションを使用して、新規マウント・ターゲット名を指定します。ibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
有効なマウント・ターゲット名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 マウント・ターゲット名の先頭は小文字にする必要があります。
コマンド・オプションについて詳しくは、「 ibmcloud is share-mount-target-update」を参照してください。
CLI でのファイル共有プロファイルの更新
これらの手順は、ゾーンファイル共有のベータリリースで使用された旧世代のファイル共有プロファイル(汎用、5-iops、10-iops、またはカスタム)用です。 2026年5月6日現在、これらのシェアプロファイルは[非推奨となって]いる{: tag-deprecated}。 現在の機能にアクセスするには、共有の IOPS プロファイルを dp2 に変更する必要があります。 dp2 または rfs プロファイルで作成されたファイル共有のプロファイルは変更できません。
-
ibmcloud is sharesコマンドを使用して領域内のファイル共有をリストすることにより、更新するファイル共有を見つけます。ibmcloud is sharesListing 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 r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f my-old-file-share stable us-south-1 tier-3iops 40 defaults none - - - -
--profileパラメーターを指定したshare-updateコマンドを使用して、新規ファイル共有プロファイルを名前で指定します。ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com... ID r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f Name my-old-file-share CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f Lifecycle state updating Access control mode vpc Zone us-south-1 Profile dp2 Size(GB) 1000 IOPS 3000 User Tags env:dev,env:prod Encryption provider_managed Mount Targets ID Name r006-c9d82a15-7ead-4388-abc8-88e81c12ed28 my-target121 Resource group ID Name 6edefe513d934fdd872e78ee6a8e73ef defaults Created 2023-03-27T20:43:36+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
コマンド・オプションについて詳しくは、「 ibmcloud is share-update」を参照してください。
CLIから許可されたトランジット暗号化モードを更新する
共有のオーナーは、許可されるトランジット暗号化モードを以下の値で更新できる。
- ゾーン・ファイル共有の場合、許可される値は
ipsec,none、ipsec、またはnoneです。 - 地域ファイル共有の場合、許可される値は
stunnel,none、stunnel、またはnoneである。
ただし、このプロパティを変更する前に、すべてのバインディングと マウントターゲットを削除する必要がある。 バインディングを削除すると、起点ファイル共有とアクセサー共有の間のネットワーク・パスが切断され、アクセサー共有に接続されているマウント・ターゲットが失敗状態になります。 詳細については、 他のアカウントからファイル共有へのアクセスを削除するを 参照してください。
ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes ipsec
Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name my-origin-share
CRN crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state stable
Access control mode security_group
Accessor binding role origin
Allowed transit encryption modes ipsec
Origin share CRN Name Remote account Remote region
crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed my-origin-share a7654321 -
Zone us-south-2
Profile dp2
Size(GB) 1000
IOPS 1000
Encryption provider_managed
Mount Targets ID Name
No mounted targets found.
Resource group ID Name
db8e8d865a83e0aae03f25a492c5b39e Default
Created 2024-06-25T22:15:15+00:00
Replication role none
Replication status none
Replication status reasons Status code Status message
- -
Allowed Access Protocols nfs4
Availability Mode zonal
Bandwidth(Mbps) 1
Storage Generation 1
API を使用したファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの管理
このAPIを使用すると、以下のことが可能になります:
- ファイル共有の名前を変更します。
- ファイル共有のマウント先を名前変更します。
- ファイル共有プロファイルを更新します (アクセサー共有には適用されません)。
- API を使用した許可された伝送暗号化モードの更新 (アクセサー共有には適用されません)。
- ファイル共有の容量を増やす
- ゾーンファイル共有のIOPSを調整する
- 地域ファイル共有の帯域幅制限の調整
- ファイル共有にユーザータグを追加します。
- ファイル共有のマウント先を削除します。
- ファイル共有を削除します。
File Storage for VPC API メソッドについて詳しくは、 API リファレンス の以下のセクションを参照してください。
スナップショットは、アクセス・コントロール・モードとしてセキュリティ・グループが設定されている共有でのみサポートされます。 共有のスナップショットをすべて削除しない限り、アクセス制御モードをVPCに変更することはできません。
API を使用してファイル共有のマウント先を名前変更する
PATCH /shares/$share_id/mount_targets/$target_id を呼び出して、ファイル共有のマウント先をリネームします。 以下の例を参照してください。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}" \
-d '{"name": "target-renamed1"}
正常な応答は、次の例のようになります。
{
"access_control_mode": "vpc",
"created_at": "2023-07-18T23:31:59Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"lifecycle_state": "stable",
"mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
"name": "target-renamed1",
"resource_type": "share_target",
"transit_encryption": "none",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
"id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
"name": "vpc-name1",
"resource_type": "vpc"
}
}
有効なマウント・ターゲット名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 マウント・ターゲット名の先頭は小文字にする必要があります。
API を使用したファイル共有プロファイルの更新
これらの手順は、ゾーンファイル共有のベータリリースで使用された旧世代のファイル共有プロファイル(汎用、5-iops、10-iops、またはカスタム)用です。 2026年5月6日現在、これらのシェアプロファイルは[非推奨となって]いる{: tag-deprecated}。 現在の機能にアクセスするには、共有の IOPS プロファイルを dp2 に変更する必要があります。 dp2 または rfs プロファイルで作成されたファイル共有のプロファイルは変更できません。
PATCH /shares/{share_ID} 呼び出しを行い、 profile プロパティーにプロファイル名を指定します。 以下の例では、プロファイルを dp2 プロファイルに変更します。
curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{"profile": {"name": "dp2"}}'
API を使用した許可された伝送暗号化モードの更新
共有のオーナーは、許可されるトランジット暗号化モードを以下の値で更新できる。
- ゾーン・ファイル共有の場合、許可される値は
ipsec,none、ipsec、またはnoneです。 - 地域ファイル共有の場合、許可される値は
stunnel,none、stunnel、またはnoneである。
ただし、このプロパティを変更する前に、すべてのバインディングとマウントターゲットを削除する必要がある。 バインディングを削除すると、起点ファイル共有とアクセサー共有の間のネットワーク・パスが切断され、アクセサー共有に接続されているマウント・ターゲットが失敗状態になります。 詳しくは、 他のアカウントからのファイル共有へのアクセス権限の削除 を参照してください。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}"
-d '{"allowed_transit_encryption_modes": "ipsec"}'
Terraform を使用したファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの管理
Terraform を使用して、以下を行うことができます。
- 名前、サイズ、プロファイル、タグなどのファイル共有属性の変更
- レプリカ関係を追加 または 削除 します。
- マウント・ターゲットの名前を変更します。
- ファイル共有またはマウント・ターゲットを削除します。
Terraform を使用したマウント・ターゲットの属性の更新
ibm_is_share_mount_target リソースを更新して、マウント・ターゲットの名前を変更します。 以下のリソースを適用すると、マウント・ターゲットの名前が my-new-share-target に変更されます。
resource "ibm_is_share_mount_target" "is_share_target" {
access_protocol = "nfs4"
name = "my-new-share-target"
share = is_share.is_share.id
subnet = ibm_is_subnet.example.id
}`
引数および属性について詳しくは、 ibm_is_share_targetを参照してください。
ファイル共有へのアクセス管理タグの追加
アクセス管理タグは、アクセス制御リソース関係を編成するためにファイル共有に追加できるメタデータです。 最初にタグを作成してから、既存のファイル共有に追加するか、ファイル共有を作成するときに追加します。 同じアクセス管理タグを複数のファイル共有に適用できます。 Cloud Identity and Access Management (IAM) でタグへのアクセス権限を割り当てることができます。 オプションで、IAM アクセス・グループを作成し、ユーザーを管理することができます。
ステップ 1 - コンソールで IAM のアクセス管理タグを作成する
コンソールで、以下のようにします。
- 「管理」 > 「 アカウント」 にアクセスし、「 タグ 」を選択してください。
- 「アクセス管理タグ」 タブをクリックします。 フィールドにタグ名を追加します。 アクセス管理タグには
key:value形式が必要です。 - 「タグの作成」 をクリックします。
ステップ 1 - CLI から IAM アクセス管理タグを作成する
コマンドラインから「 ibmcloud resource tag-create 」コマンドを入力して、 アカウントにアクセス管理タグを作成します。 次の例では、「 project:myproject 」という名前のタグを作成します:
ibmcloud resource tag-create --tag-names project:myproject
詳しくは、ibmcloud resource コマンドのリファレンスを参照してください。
ステップ 1 - API を使って IAM アクセス管理タグを作成する
Global Search and Tagging APIを使っ て、アクセス管理タグを作成 するために「POST/ tags リクエストを行う。 tag_names プロパティにタグを指定する。
例については、APIを使用したアクセス管理タグの作成 を参照のこと。
ステップ1 - TerraformでIAMアクセス管理タグを作成する
main.tf ファイルに引数を作成する。 次の例では、リソース ID が ibm_is_share.example.crn である ibm リソースに追加される、アクセス管理タグ「 ibm_tag 」を作成します。
resource "ibm_resource" "ibm" {
resource_id = ibm_is_share.example.crn
tags = [ "ibm_tag" ]
}
ステップ 2-ファイル共有へのアクセス管理タグの追加
既存のファイル共有にアクセス管理タグを追加するか、 ファイル共有の作成 時にアクセス管理タグを追加します。 既存のファイル共有の場合:
- IBM Cloud コンソールで、リソース・リストに移動し、 「ストレージ」 リソースの下のファイル共有を選択します。
- 「アクセス管理タグ」 フィールドに、以前に作成したアクセス管理タグの名前を入力します。 入力すると、タグが表示されます。
- 変更内容を保存します。
ステップ 3-アクセス・グループの作成とユーザーへのアクセス権限の割り当て
アクセス管理タグを作成してファイル共有に適用した後、以下のステップを実行してアクセス権限を割り当て、ユーザーを追加します。
- アクセス・グループを作成します。 アクセスグループは、そのグループのメンバーにロールや権限を付与するポリシーに割り当てられます。 ファイル・サービスの特定のアクセス管理タグへのアクセス権限を割り当てます。 アクセス・グループについて詳しくは、アクセス・グループのセットアップを参照してください。
- アクセス・ポリシーをグループに割り当てます。
- アクセス・グループにユーザーを追加します。
VPC インフラストラクチャーの特定のリソースを参照し、リソース・タイプとして File Storage for VPC を指定すると、ファイル・サービスのアクセス管理タグを確認できます。
他のアカウントからのファイル共有へのアクセスの削除
ファイル共有へのアクセス権限の取り消しは、2 ステップのプロセスです。
- アカウント間の IAM 許可を削除します。 IAM 許可を削除すると、他のアカウントまたはサービスがアクセサー共有およびマウント・ターゲットを作成できなくなります。
- 起点共有とアクセサー共有を接続する共有バインディングを削除します。 このアクションにより、他のアカウントのマウント・ターゲットが
failed状態になります。
仮想サーバー・インスタンスでのファイル共有のマウントおよびアンマウント
マウントとは、サーバーのオペレーティング・システムが、サーバーのファイル・システムを通じて、ユーザーがストレージ・デバイス上のファイルやディレクトリにアクセスできるようにするプロセスである。 仮想サーバー・インスタンスにファイル共有をマウントするには、マウント・パスの情報を確認します。 ファイル共有のマウント先を作成すると、マウントパスが作成されます。 Linux のいくつかのオペレーティングシステムへのインストールについては、以下の情報をご参照ください。 その他の Linux ディストリビューションでも同じような手順になります。
ファイル共有の監視
コンソール、CLI、またはAPIを使用して、ファイル共有のステータスと健全性を確認できます。 IBM Cloud コンソールで、共有の総帯域幅、総 IOPS、マウントターゲット数、および容量使用率を経時的に監視できます。 IBM Cloud® Activity Tracker Event Routingを使用して、ファイル共有の監査イベントをルーティングする方法を設定できます。 また、IBM Cloud Logs Routingをログの処理用に設定することもできます。 詳細については、 ファイル共有の健全性状態、ライフサイクル ステータス、およびイベントを監視する を参照してください。
ファイル共有は、IBM Cloud® Monitoring と統合して、共有のパフォーマンスと健全性を運用面で可視化できます。 Sysdig Web UIでは、帯域幅、IOPS、容量のメトリクスをより詳細に表示したり、ダッシュボードをカスタマイズしたり、アラートを設定したりすることができます。 詳しくは、File Storage for VPC のメトリックのモニターを参照してください。
ファイル共有、アクセサー共有バインディング、マウントターゲットの削除
ファイル共有を削除する前に、そのファイル共有がすべての仮想サーバーインスタンスから アンマウントされている こと、およびそのファイル共有に属するすべてのマウント先が削除されていることを確認してください。 ファイル共有が別のアカウントと共有されている場合は、共有を削除する前にアクセサー・バインディングを削除してください。 また、ファイル共有にレプリカ・ファイル共有がある場合は、複製関係を削除する必要があります。 詳しくは、 コンソールでレプリケーション関係を削除するCLIRでレプリケーション関係を削除するAPIRでレプリケーション関係を削除するTerraformでレプリケーション関係を削除するを参照してください。
ファイル共有を削除する前にデータを消去する
ファイル共有を削除すると、 IBM により、物理ディスク上のデータにアクセスできなくなり、最終的には完全に消去されることが保証されます。 NIST 800-88「メディアの消去に関するガイドライン」などの追加のコンプライアンス要件がある場合は、ファイル共有を削除する前に、データの消去手順を実行する必要があります。 詳細については、 NIST 800-88「メディアの消去に関するガイドライン 」を参照してください。
削除前にファイル共有を消去処理することで、たとえ IBM の管理外でそのメディアが入手されたとしても、物理ディスク上の残留データが発見されたり復元されたりすることがないよう保証されます。
コンソールでファイル共有、アクセサー共有バインディング、マウントターゲットを削除する
以下の手順は、不要になったファイル共有を削除する前に、共有バインディングとマウントターゲットが削除されていることを確認するのに役立ちます。
ファイル共有にスナップショットがある場合、これらのスナップショットはファイル共有と一緒に削除されます。
コンソールでファイル共有の共有バインディングを削除する
- ファイル共有のリストからファイル共有を選択します。
- 「ファイル共有の詳細」ページで、「アクセサー共有バインディング」セクションまでスクロールして、削除するバインディングを見つけます。
- バインディングの行の最後にある 「アクション」 アイコン
をクリックし、 「削除」 を選択します。
コンソールでファイル共有のマウント先を削除する
- ファイル共有のリストからファイル共有を選択します。
- 「ファイル共有の詳細」ページで、削除したいマウント先を選択します。
- 「アクション」アイコン
をクリックし、 「削除」 を選択します。
コンソールでファイル共有を削除する
ファイル共有は、「 stable 」状態または「 failed 」状態である必要があります。
- ファイル共有のリストからファイル共有を選択します。
- 行の末尾にある 「アクション」 アイコン
をクリックし、 「削除」 を選択します。
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
r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f my-old-file-share stable us-south-1 dp2 40 defaults none - - -
ibmcloud is shareコマンドを使用して、ファイル共有の詳細を取得し、接続されているマウント・ターゲットおよび複製情報を確認します。
ibmcloud is share my-file-share-2
Getting file share my-file-share-2 under account Test Account as user test.user@ibm.com...
ID r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940
Name my-file-share-2
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940
Lifecycle state stable
Access control mode vpc
Zone us-south-1
Profile dp2
Size(GB) 40
IOPS 2000
User Tags env:dev,env:prod
Encryption provider_managed
Mount Targets ID Name
r006-36d67ada-ca83-44be-adad-dc58e7c38dc5 my-new-mount-target
Resource group ID Name
db8e8d865a83e0aae03f25a492c5b39e Default
Created 2023-10-18T23:52:45+00:00
Replication role none
Replication status none
Replication status reasons Status code Status message
- -
Snapshot count 0
Snapshot size 0
Source snapshot -
CLI からのファイル共有の共有バインディングの削除
share-binding-delete コマンドを実行し、名前または ID のいずれかで発信元ファイルの共有とバインディングを指定します。 プロンプトが出されたら、 y と入力します。 ファイル共有に複数のバインディングが関連付けられている場合は、すべてのバインディングが削除されるまでこのステップを繰り返します。 以下の例を参照してください。
ibmcloud is share-bindings-delete my-origin-share r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
This will delete accessor binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for share ID my-origin-share and cannot be undone. Continue [y/N] ?> y
Deleting binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for share ID my-origin-share under account Test Account as user test.user@ibm.com...
OK
Binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 is deleted.
CLI からファイル共有のマウント先を削除する
share-mount-target-delete コマンドを実行し、名前または ID のいずれかでファイル共有とマウント・ターゲットを指定します。 プロンプトが出されたら、 y と入力します。 複数のマウント・ターゲットがファイル・シェアに接続されている場合は、すべてのマウント・ターゲットが削除されるまでこのステップを繰り返します。
ibmcloud is share-mount-target-delete my-file-share-2 my-new-mount-target
This will delete mounted target my-new-mount-target for share ID my-file-share-2 and cannot be undone. Continue [y/N] ?> y
Deleting mounted target my-new-mount-target for share ID my-file-share-2 under account Test Account as user test.user@ibm.com...
OK
Share mount target my-new-mount-target is deleted.
コマンド・オプションについて詳しくは、「 ibmcloud is share-mount-target-delete」を参照してください。
CLI からファイル共有を削除する
ファイル共有は、「 stable 」または「 failed 」の状態である必要があります。 ファイル共有を削除するには、 share_delete コマンドを実行し、名前または ID を指定してファイル共有を指定します。
ibmcloud is share-delete my-file-share-2
This will delete file share my-file-share-2 and cannot be undone. Continue [y/N] ?> y
Deleting file share my-file-share-2 under account Test Account as user test.user@ibm.com...
OK
File share my-file-share-2 is deleted.
コマンド・オプションについて詳しくは、「 ibmcloud is share-delete」を参照してください。
ファイル共有にスナップショットがある場合、これらのスナップショットはファイル共有と一緒に削除されます。
API を使用したファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの削除
以下の手順は、不要になったファイル共有を削除する前に、共有バインディングとマウントターゲットが削除されていることを確認するのに役立ちます。
API を使用したファイル共有の共有バインディングの削除
以下のサンプル要求に示すように、 VPC API で /shares メソッドを呼び出すことによって、共有バインディングをプログラマチックに削除できます。
curl -X DELETE "$vpc_api_endpoint/v1/shares/v1/shares/$share_id/bindings/$binding_id?version=2024-06-21&generation=2"
API を使用してファイル共有のマウント先を削除する
DELETE /shares/{share_ID}/mount_targets/{target_id} を呼び出して、ファイル共有のマウント先を削除します。 ファイル共有は stable 状態でなければなりません。 既存のマウント・ターゲットがそのファイル・シェアに関連付けられている場合、またはレプリカ操作が進行中の場合は、ファイル・シェアを削除できません。
以下の例を参照してください。
curl -X DELETE \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}"
成功した応答には、削除の受け入れの確認と、ターゲット情報を含む応答が含まれます。
次の例は、'access_control_mode が 'security_group であるマウントターゲットを示している。 応答には、セキュリティー・グループとサブネットが示されます。 マウントターゲットの仮想ネットワークインターフェースに使用された予約IPアドレスの詳細は、「primary_ip セクションで確認できる。 デフォルトでは、マウント・ターゲットが削除されると、仮想ネットワーク・インターフェースがマウント・ターゲットとともに削除されます。
マウントターゲットのステータスが削除中であることを示す。
{
"access_control_mode": "security_group",
"created_at": "2022-08-08T01:59:46.000Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"lifecycle_reasons": [],
"lifecycle_state": "deleting",
"mount_path": "domain.com:/vol_xyz_2891fd0a_63aa_4deb_9ed5_1159e37cb5aa",
"name": "target-name1",
"primary_ip": {
"address": "10.10.12.64",
"href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5/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/2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5",
"id": "2302-ea5fe79f-52c3-4f05-86ae-9540a10489f5",
"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/4727d842-f94f-4a2d-824a-9bc9b02c523b",
"id": "4727d842-f94f-4a2d-824a-9bc9b02c523b",
"name": "my-virtual-network-interface",
"resource_type": "virtual_network_interface"
},
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/8c95b3c1-fe3c-45c-97a6-e43d14088287",
"id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
"name": "vpc-name1",
"resource_type": "vpc"
}
}
マウント・ターゲットの削除はバックグラウンドで実行されます。 削除を確認するには、マウント・ターゲットの情報を表示してみてください。 404 Not Found というエラーが表示された場合、マウント先が正常に削除されました。
API でのファイル共有の削除
ファイル共有は、「 stable 」または「 failed 」の状態である必要があります。
ファイル共有を削除するには、DELETE /shares/$share_id 呼び出しを行います。 ファイル共有は、「 stable 」状態、または「 failed 」状態(つまり、プロビジョニングに失敗した場合)である必要があります。 既存のマウント・ターゲットがそのファイル・シェアに関連付けられている場合、またはレプリカ操作が進行中の場合は、ファイル・シェアを削除できません。
以下の例を参照してください。
curl -X DELETE \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}"
応答が正常に行われた場合、削除が承認されたことが確認され、ファイルの共有情報が表示されます。 ファイル共有のステータスが「 pending_deletion 」に更新されました。 以下の例を参照してください。
{
"access_control_mode": "vpc",
"created_at": "2022-08-08T23:31:59Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
"id": "0995b8c6-c323-4e59-9ea9-fa14dd66bba8",
"iops": 3000,
"lifecycle_state": "pending_deletion",
"name": "share-name1",
"profile": {
"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/bfb4a7c7-00d8-400b-98ba-5a67e5851970",
"id": "bfb4a7c7-00d8-400b-98ba-5a67e5851970",
"name": "Default"
},
"resource_type": "share",
"size": 100,
"snapshot_count": 10,
"snapshot_size": 10,
"user_tags": [],
"mount_targets": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
}
ファイル共有はバックグラウンドで削除されます。 削除を確認するには、マウント・ターゲットの情報を表示してみてください。 404 Not Found というエラーが表示された場合、マウント先が正常に削除されました。 ファイル共有にスナップショットがある場合、これらのスナップショットはファイル共有と一緒に削除されます。
DELETE /shares/$share_id 呼び出しには、オプションで、 ETag ハッシュ・ストリングを指定する If-Match ヘッダーを含めることができます。 GET /shares/{share_id} 呼び出しを行い、応答ヘッダーから ETag ハッシュ・ストリングをコピーします。 詳しくは、ファイル共有のユーザー・タグを参照してください。
Terraformでファイル共有やマウントターゲットを削除する
terraform destroy コマンドを使用すると、ファイル共有などのリモートオブジェクトを簡単に削除できます。 以下の例は、共有を削除するための構文を示しています。 ibm_is_share.example.id は、共有の実際の ID に置き換えます。 マウントターゲットを削除するには、同じコマンドでそれらのIDを使用する。
terraform destroy --target ibm_is_share.example.id
ファイル共有にスナップショットがある場合、これらのスナップショットはファイル共有と一緒に削除されます。
詳しくは、 terraform destroyを参照してください。
Terraformを使ってアクセサ共有バインディングを削除したい場合は、 ibm_is_share_delete_accessor_binding リソースを使います。
resource "ibm_is_share_delete_accessor_binding" "example" {
share = ibm_is_share.example.id
accessor_binding = data.ibm_is_share_accessor_bindings.example.accessor_bindings.0.id
}
引数と属性の詳細については、 ibm_is_share_delete_accessor_binding を参照してください。