ファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの管理

File Storage for VPC の共有を管理するには、名前の変更、容量の拡張、IOPSおよび帯域幅の調整、マウントターゲットの追加、およびアクセサの共有バインディングの管理を行います。

File Storage for VPC サービスには、ロールベースのアクセス制御のためのIAMパーミッションが必要です。 たとえば、ファイル共有を作成するには、少なくとも「編集者」権限が必要です。 詳細については、VPC インフラストラクチャ サービスの IAM アクセスの管理 ファイル共有用。

通常のファイル共有とアクセサー共有の処理の違い

以下のセクションでは、ファイル共有およびマウント・ターゲットのさまざまなプロパティーを変更および更新する方法について説明します。 アクセサー共有の性質上、一部のプロパティー (例えば、ファイル共有プロファイル、アクセス制御モード、または許可された転送暗号化モード) は変更できません。 これらのプロパティーは、起点の共有から継承されます。 変更可能なアクセサー共有プロパティーの場合、これらのステップは通常の共有を更新する場合と同じです。 アクセス共有のスナップショットを作成することはできませんが、オリジン共有にスナップショットがある場合は、 .snapshot ディレクトリのスナップショットにアクセスできます。 このディレクトリは読み取り専用である。

コンソールでのファイル共有、アクセサー共有バインディング、マウントターゲットの管理

コンソールでは、以下を行うことができます。

コンソールでは、通常のファイル共有およびアクセサー共有を管理できます。 共有所有者のみが、アクセス制御モード、IOPS、およびプロファイルなどのプロパティーを変更できます。 アクセサー・アカウントは起点共有を編集できず、アクセサー共有のより小さいプロパティー・セットを変更できます。

スナップショットは、アクセス・コントロール・モードとしてセキュリティ・グループが設定されている共有でのみサポートされます。 共有のスナップショットをすべて削除しない限り、アクセス制御モードをVPCに変更することはできません。

コンソールでファイル共有の名前を変更する

  1. 「ファイル共有の詳細」 ページで、ファイル共有名の横にある 「編集」アイコン 「編集」アイコン をクリックします。

  2. ファイル共有の新しい名前を指定します。

有効なファイル共有名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 ファイル共有名の先頭は小文字にする必要があります。

コンソールでファイル共有のマウント先を名前変更する

  1. 「ファイル共有の詳細」 ページに移動します。
  2. 「アクション」アイコン 「アクション」アイコン をクリックします。
  3. **「名前変更」**を選択します。
  4. 新しい名前を入力し、**「名前変更」**をクリックします。

有効なマウント・ターゲット名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 マウント・ターゲット名の先頭は小文字にする必要があります。

コンソールでファイル共有プロファイルを更新する

これらの手順は、ゾーンファイル共有のベータリリースで使用された旧世代のファイル共有プロファイル(汎用、5-iops、10-iops、またはカスタム)用です。 2026年5月6日現在、これらのシェアプロファイルは[非推奨となって]いる{: tag-deprecated}。 現在の機能にアクセスするには、共有の IOPS プロファイルを dp2 に変更する必要があります。 dp2 または rfs プロファイルで作成されたファイル共有のプロファイルは変更できません。

ファイル共有のプロファイルは、現在のプロファイルから別の IOPS 層 プロファイル、 カスタム ・プロファイル、または高性能 dp2 プロファイルに変更できます。 ご請求は、お客様が選択されたプロファイルに基づいて調整されます。

  1. 「ファイル共有の詳細」 ページに移動します。
  2. 現在のプロファイルの横にある 「編集」アイコン 「編集」アイコン をクリックするか、 「アクション」 メニュー 「アクション」アイコン を使用して 「IOPS プロファイルの編集」 を選択します。 サイド・パネルには、現行プロファイル、ファイル共有サイズ、および最大 IOPS が表示されます。
  3. 「新規プロファイル」 の場合は、下矢印をクリックします。 新規 IOPS ティア、カスタム・プロファイル、または dp2を選択できます。 「カスタム IOPS」 または dp2 の場合、ファイル共有サイズに基づいて新しい最大 IOPS を指定します。 ファイル共有価格は、選択内容に基づいて自動的に計算されます。
  4. 保存して続行 」をクリックしてください。

コンソールで許可されたトランジット暗号化モードを更新する

共有の所有者は、許可されたトランジット暗号化モードを変更することができます。 ただし、このプロパティーを変更する前に、すべてのバインディングを削除する必要があります。 バインディングを削除すると、起点ファイル共有とアクセサー共有の間のネットワーク・パスが切断され、アクセサー共有に接続されているマウント・ターゲットが失敗状態になります。 詳しくは、 他のアカウントからのファイル共有へのアクセス権限の削除 を参照してください。

  1. ファイル共有のリストからファイル共有を選択します。
  2. 「ファイル共有の詳細」ページで、許可されている伝送暗号化モードを見つけます。
  3. 現行値を変更するには、 「編集」アイコン 「編集」アイコン をクリックします。

CLI からのファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの管理

CLI を使用すると、以下のことが可能です:

スナップショットは、アクセス・コントロール・モードとしてセキュリティ・グループが設定されている共有でのみサポートされます。 共有のスナップショットをすべて削除しない限り、アクセス制御モードをVPCに変更することはできません。

CLI からファイル共有の名前を変更する

  1. ibmcloud is shares コマンドを使用して領域内のファイル共有をリストすることにより、名前変更するファイル共有を見つけます。 ファイル共有の名前とIDを控えておく。

    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   tier-3iops 40         defaults         none               -                       -                -
    
  2. ibmcloud is share-update コマンドを実行し、 --name オプションを使用して新しいファイル共有名を指定します。

    ibmcloud is share-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 --name my-renamed-share
    
    Updating file share r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 under account Test Account as user test.user@ibm.com...
    ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Name                         my-renamed-share
    CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Lifecycle state              stable
    Access control mode          vpc
    Zone                         us-south-2
    Profile                      dp2
    Size(GB)                     100
    IOPS                         100
    Encryption                   ipsec
    Mount Targets                ID                          Name
                                 No mounted targets found.
    Resource group               ID                                 Name
                                 6edefe513d934fdd872e78ee6a8e73ef   defaults
    Created                      2023-08-01T17:02:01+00:00
    Encryption key               crn:v1:bluemix:public:kms:eu-de:a/a1234567:key:f602ae93-b915-49bc-a0e1-af29c73e7788
    Latest job                   Job status   Job status reasons
                                 -            -
    Replication cron spec        00 11 * * 0
    Replication role             replica
    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
    

有効なファイル共有名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 ファイル共有名の先頭は小文字にする必要があります。

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

CLI からファイル共有のマウント先を名前変更する

  1. ibmcloud is shares コマンドを使用して、地域内のファイル共有をリストします。 名前変更するマウント・ターゲットが含まれているファイル共有の名前と ID をメモします。

  2. 共有の名前または ID を使用して、 ibmcloud is share-mount-targets コマンドでそのマウント・ターゲットを見つけます。

    ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    
    Listing 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
    
  3. マウント・ターゲットの名前を変更するには、ファイル共有の名前または 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 プロファイルで作成されたファイル共有のプロファイルは変更できません。

  1. 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   tier-3iops 40         defaults         none               -                       -                -
    
  2. --profile パラメーターを指定した share-update コマンドを使用して、新規ファイル共有プロファイルを名前で指定します。

    ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000
    
    Updating 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,noneipsec、または none です。
  • 地域ファイル共有の場合、許可される値は stunnel,nonestunnel、または 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を使用すると、以下のことが可能になります:

File Storage for VPC API メソッドについて詳しくは、 API リファレンス の以下のセクションを参照してください。

スナップショットは、アクセス・コントロール・モードとしてセキュリティ・グループが設定されている共有でのみサポートされます。 共有のスナップショットをすべて削除しない限り、アクセス制御モードをVPCに変更することはできません。

API を使用してファイル共有の名前を変更する

PATCH /shares/$share_id 呼び出しを行って、特定のファイル共有の名前を変更します。 以下の例を参照してください。

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
  -H "Authorization: Bearer ${API_TOKEN}"\
  -d '{"name": "share-renamed1"}'

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

{
  "access_control_mode": "vpc",
  "created_at": "2023-07-17T23: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": "stable",
  "name": "share-renamed1",
  "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,
  "mount_targets": [],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

有効なファイル共有名には、英小文字および数字 (a-z、0-9) とハイフン (-) を組み合わせて最大 63 文字まで含めることができます。 ファイル共有名の先頭は小文字にする必要があります。

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,noneipsec、または none です。
  • 地域ファイル共有の場合、許可される値は stunnel,nonestunnel、または 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 リソースを更新して、ファイル共有の属性 (名前、サイズ、プロファイル、タグなど) を変更します。 以下の例を適用すると、共有の名前が new_name に更新されます。

resource "ibm_is_share" "example" {
  name    = "new_name"
  size    = 300
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
}

ファイル共有およびマウント先として有効な名前は、小文字の英数字(a-z、0-9)とハイフン(-)を組み合わせて構成でき、最大63文字までです。 ファイル共有名の先頭は小文字にする必要があります。

プロファイル、許可されるトランジット暗号化モード、静止時の暗号化など、一部の属性はアクセサー共有では編集できません。

共有のオーナーは、許可されるトランジット暗号化モードを以下の値で更新できる。

  • ゾーン・ファイル共有の場合、許可される値は ipsec,noneipsec、または none です。
  • 地域ファイル共有の場合、許可される値は stunnel,nonestunnel、または none である。

ただし、このプロパティを変更する前に、すべてのバインディングと マウントターゲットを削除する必要がある。 バインディングを削除すると、起点ファイル共有とアクセサー共有の間のネットワーク・パスが切断され、アクセサー共有に接続されているマウント・ターゲットが失敗状態になります。 詳細については、 他のアカウントからファイル共有へのアクセスを削除するを 参照してください。

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

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を参照してください。

ファイル共有にユーザータグを追加する

UI、CLI、API、および Terraform を使用して、新規または既存のファイル共有にユーザー・タグを追加したり、ファイル共有のタグを変更および削除したりすることができます。 リソース・リストからタグでフィルタリングすることで、アカウント全体のタグを表示できます。 レプリカ・ファイル共有にユーザー・タグを追加することもできます。

同じ操作で最大 100 個のタグを付加または切り離すことができます。 タグを編集すると、新しいタグによって既存のタグが上書きされます。 タグを管理しやすい状態にするため、リソースを効果的に扱うために必要な分だけ、ユーザータグを作成してください。

グローバル・タグ付け API を使用して、 IBM Cloud でタグを管理できます。 この API を使用して、タグの作成、削除、検索、添付、または切り離しを行うことができます。 アカウントのタグの管理について詳しくは、タグの操作を参照してください。

コンソールでファイル共有にユーザータグを追加する

コンソールから、ファイル共有にユーザータグを追加することができます。

  1. ファイル共有の一覧に移動します。 IBM Cloud コンソールで、 ナビゲーション メニューアイコン> インフラストラクチャVPC アイコン> ストレージ > ファイル ストレージ共有をクリックします。
  2. ファイル共有を選択して、その詳細を表示します。
  3. ファイル共有の詳細ページでは、ファイル共有名の横にユーザータグが表示されます。 「編集」アイコン 「編集」アイコン をクリックして、タグを編集します。
  4. [ タグの編集 ] ウィンドウで、[ユーザータグ] テキストボックスにタグを入力します。
  5. 保存 をクリックします。

CLI からのファイル共有ユーザー・タグの追加または変更

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

ibmcloud is share-create コマンドを使用してファイル共有をプロビジョンするときに、タグを追加できます。 --user-tags オプションは、ファイル共有のタグを指定します。 詳しくは、 CLI からのマウント・ターゲットを使用したファイル共有の作成 を参照してください。

ibmcloud is share-update コマンドを使用してファイル共有を更新するときに、タグを追加および削除できます。

  1. ibmcloud is shares コマンドを使用して地域内のファイル共有をリストすることで、CLI から共有を見つけます。

    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
    
  2. ibmcloud is share コマンドを使用して、ファイル共有の詳細を取得します。

    ibmcloud is share my-file-share
    
    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
    ID                           r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Name                         my-file-share
    CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03
    Lifecycle state              stable
    Access control mode          security_group
    Accessor binding role        none
    Zone                         us-south-2
    Profile                      dp2
    Size(GB)                     1000
    IOPS                         1000
    Encryption                   provider_managed
    Mount Targets                ID                                          Name
                                 r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target
    Resource group               ID                                 Name
                                 db8e8d865a83e0aae03f25a492c5b39e   Default
    Created                      2023-10-18T22:15:15+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 コマンドが返す情報を示しています。

    ibmcloud is share my-regional-file-share
    
    Getting file share my-file-share under account Test Account as user test.user@ibm.com...
    ID                                 r006-9ae55188-610e-4cf9-9350-d0b675026ff8
    Name                               my-regional-file-share
    CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-9ae55188-610e-4cf9-9350-d0b675026ff8
    Lifecycle state                    stable
    Access control mode                security_group
    Accessor binding role              none
    Allowed transit encryption modes   stunnel,none
    Zone                               -
    Profile                            rfs
    Size(GB)                           1000
    IOPS                               35000
    Encryption                         provider_managed
    Mount Targets                      ID                          Name
                                       No mounted targets foun
    Resource group                     ID                                 Name
                                       db8e8d865a83e0aae03f25a492c5b39e   Default
    Created                            2025-07-22T22:15:15+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           nsf4
    Availability Mode                  regional
    Bandwidth(Mbps)                    125
    Storage Generation                 2
    
  3. --user-tags オプションを指定した ibmcloud is share-update コマンドを使用して、ファイル共有にタグを追加します。 ファイル共用に以前にタグがあった場合、それらのタグは、コマンドで指定されたタグによって上書きされます。

次の例では、ファイル共有に2つのユーザータグを追加しています。

ibmcloud is share-update my-file-share --user-tags daily-backup-plan,docs:test
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-file-share
CRN                          crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state              stable
Access control mode          security_group
Accessor binding role        none
Zone                         us-south-2
Profile                      dp2
Size(GB)                     1500
IOPS                         2000
User Tags                    daily-backup-plan,docs:test
Encryption                   provider_managed
Mount Targets                ID                                          Name
                             r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61   my-cli-share-mount-target-1
Resource group               ID                                 Name
                             db8e8d865a83e0aae03f25a492c5b39e   Default
Created                      2023-10-18T22:15:15+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

APIによるファイル共有ユーザータグの追加と変更

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

ファイル共有の作成時にユーザー・タグを追加する

POST /shares 要求を行い、user_tags プロパティーを指定します。 この例では、3 つのユーザー・タグ env:test1env:test2、および env:prodを使用して共有を作成します。

curl -X POST \
"$vpc_api_endpoint/v1/shares?version=2023-08-08&generation=2"\
    -H "Authorization: Bearer $iam_token"\
    -H 'Content-Type: application/json'\
    -d '{
        "name": "share-name1",
        "size": 2300,
        "iops": 6000,
        "profile": {"name": "dp2"},
        "user_tags": [
           "env:test1",
           "env:test2",
           "env:prod"
        ],
        "zone": {"name": "us-south-1"}
      }'

既存のファイル共有のユーザータグを変更する

PATCH /shares リクエストを実行して、既存のファイル共有に新しいユーザータグを追加し、 user_tags プロパティでユーザータグを指定します。 ファイル共有にタグがなかった場合は、要求内の新規タグが追加されます。 ファイル共有に以前にタグがあった場合、新しいタグによって以前のタグが上書きされます。

次の例は、IDで識別されるファイル共有を変更する。 共有の名前が変更され、ユーザータグが追加されます。

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 '{
    "name": "myshare-patch-1",
    "user_tags": [
      "ut8",
      "ut9"
    ],
  }'

成功した応答は次の例のようになる:

{
    "access_control_mode": "vpc",
    "created_at": "2023-01-28T22:31:50Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south-1.cloud.ibm.com/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3",
    "id": "432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3",
    "initial_owner": {
      "gid": 0,
      "uid": 0
    },
    "iops": 3000,
    "lifecycle_state": "stable",
    "name": "myshare-patch-1",
    "profile": {
      "href": "https://us-south-1.cloud.ibm.com/v1/share/profiles/tier-3iops",
      "name": "tier-3iops",
      "resource_type": "share_profile"
    },
    "replication_role": "none",
    "replication_status": "none",
    "replication_status_reasons": [],
    "resource_group": {
      "crn": "crn": "crn:[...]",
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/86ccf0a1315646d4bc719fe34ff4d1e3",
      "id": "86ccf0a1315646d4bc719fe34ff4d1e3",
      "name": "Default"
    },
    "resource_type": "share",
    "size": 100,
    "mount_targets": [],
    "user_tags": [
      "ut8",
      "ut9"
    ],
    "zone": {
      "href": "https://us-south-1.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
      "name": "us-south-1"
    }
  }

ETag による検証を用いたファイル共有のユーザータグの変更

ファイル共有に対する更新が有効であることを確認するには、 ETag ハッシュ・ストリング値を取得し、それを PATCH /shares/{share_id} 呼び出しの If-Match ヘッダーに指定します。 これにより、最後に観測された状態と PATCH の呼び出し時の状態の間で、シェアオブジェクトに変更が生じていないことが確認されます。

ファイル共有に追加されている既存のユーザータグを変更するには、まず GET /shares/{share_id} を呼び出し、レスポンスヘッダーの ETag プロパティからハッシュ値をコピーします。 次に、 PATCH /shares/{share_id} 要求で If-Match ヘッダーを使用して ETag 値を送信します。 Etag の値を指定すると、 If-Match の値がファイル共有の現在の Etag と一致しない場合、そのファイル共有に対する更新や削除は失敗するようになります。 以下の手順を実行します。

  1. GET /shares/{share_id} リクエストを送信し、レスポンスヘッダーの ETag プロパティからハッシュ文字列をコピーしてください。 手順 2 で、 PATCH /shares/{share_id} リクエスト内で If-Match を指定して、共有のユーザータグを変更する際は、ハッシュ文字列の値を使用してください。
curl -sSL -D GET\ "https://us-south.cloud.ibm.com/v1/shares/{share_id}?version=2023-08-08&generation=2"\
-H "Authorization: Bearer $TOKEN" -o /dev/null

レスポンスヘッダーは、次のような例に似ています:

HTTP/2 200
date: Mon, 09 January 2023 17:48:03 GMT
content-type: application/json; charset=utf-8
content-length: 1049
cf-ray: 69903d250c4966ef-DFW
cache-control: max-age=0, no-cache, no-store, must-revalidate
expires: -1
strict-transport-security: max-age=31536000; includeSubDomains
cf-cache-status: DYNAMIC
expect-ct: max-age=604800, report-uri="[uri...]"
pragma: no-cache
x-content-type-options: nosniff
x-request-id: 1fbe2384-6828-4503-ae7d-050426d1b11b
x-xss-protection: 1; mode=block
server: cloudflare
etag: W/xxxyyyzzz123
  1. PATCH /shares/{share_id} 要求を行います。 ヘッダーの If-Match プロパティーに ETag ハッシュ・ストリングを指定します。 user_tags プロパティでユーザータグを指定します。

この例では、ファイル共有ユーザー・タグを env:test および env:prodに更新します。 ETag プロパティ(W/xxxyyyzzz123 )から取得したハッシュ文字列の値は、呼び出しの If-Match ヘッダーで指定されます。

curl -X PATCH\
"$vpc_api_endpoint/v1/shares/50fda9c3-eecd-4152-b473-a98018ccfb10?version=2023-08-08&generation=2"\
   -H "Authorization: Bearer $iam_token"\
   -H "If-Match: W/xxxyyyzzz123"\
   -d `{
      "user_tags": [
         "env:test2",
         "env:prod2"
      ]
   }'

Terraformでファイル共有のユーザータグを追加・変更する

ファイル共有にユーザータグを適用するには、'ibm_is_share リソースを使用して、'main.tf ファイルに引数を作成する。 次の例では、共有「my-new-share」と、共有に付けるタグ「dev:test」を指定しています。 適用されると、タグが共有に追加されます。

resource "ibm_is_share" "example" {
  name    = "my-new-share"
  size    = 200
  iops    = 5000
  profile = "dp2"
  zone    = "us-south-2"
  tags    = ["dev:test"]
}

ファイル共有へのアクセス管理タグの追加

アクセス管理タグは、アクセス制御リソース関係を編成するためにファイル共有に追加できるメタデータです。 最初にタグを作成してから、既存のファイル共有に追加するか、ファイル共有を作成するときに追加します。 同じアクセス管理タグを複数のファイル共有に適用できます。 Cloud Identity and Access Management (IAM) でタグへのアクセス権限を割り当てることができます。 オプションで、IAM アクセス・グループを作成し、ユーザーを管理することができます。

ステップ 1 - コンソールで IAM のアクセス管理タグを作成する

コンソールで、以下のようにします。

  1. 「管理」 > 「 アカウント」 にアクセスし、「 タグ 」を選択してください。
  2. 「アクセス管理タグ」 タブをクリックします。 フィールドにタグ名を追加します。 アクセス管理タグには key:value 形式が必要です。
  3. 「タグの作成」 をクリックします。

ステップ 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-ファイル共有へのアクセス管理タグの追加

既存のファイル共有にアクセス管理タグを追加するか、 ファイル共有の作成 時にアクセス管理タグを追加します。 既存のファイル共有の場合:

  1. IBM Cloud コンソールで、リソース・リストに移動し、 「ストレージ」 リソースの下のファイル共有を選択します。
  2. 「アクセス管理タグ」 フィールドに、以前に作成したアクセス管理タグの名前を入力します。 入力すると、タグが表示されます。
  3. 変更内容を保存します。

ステップ 3-アクセス・グループの作成とユーザーへのアクセス権限の割り当て

アクセス管理タグを作成してファイル共有に適用した後、以下のステップを実行してアクセス権限を割り当て、ユーザーを追加します。

  1. アクセス・グループを作成します。 アクセスグループは、そのグループのメンバーにロールや権限を付与するポリシーに割り当てられます。 ファイル・サービスの特定のアクセス管理タグへのアクセス権限を割り当てます。 アクセス・グループについて詳しくは、アクセス・グループのセットアップを参照してください。
  2. アクセス・ポリシーをグループに割り当てます
  3. アクセス・グループにユーザーを追加します

VPC インフラストラクチャーの特定のリソースを参照し、リソース・タイプとして File Storage for VPC を指定すると、ファイル・サービスのアクセス管理タグを確認できます。

他のアカウントからのファイル共有へのアクセスの削除

ファイル共有へのアクセス権限の取り消しは、2 ステップのプロセスです。

  1. アカウント間の IAM 許可を削除します。 IAM 許可を削除すると、他のアカウントまたはサービスがアクセサー共有およびマウント・ターゲットを作成できなくなります。
  1. 起点共有とアクセサー共有を接続する共有バインディングを削除します。 このアクションにより、他のアカウントのマウント・ターゲットが 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 の管理外でそのメディアが入手されたとしても、物理ディスク上の残留データが発見されたり復元されたりすることがないよう保証されます。

コンソールでファイル共有、アクセサー共有バインディング、マウントターゲットを削除する

以下の手順は、不要になったファイル共有を削除する前に、共有バインディングとマウントターゲットが削除されていることを確認するのに役立ちます。

ファイル共有にスナップショットがある場合、これらのスナップショットはファイル共有と一緒に削除されます。

コンソールでファイル共有の共有バインディングを削除する

  1. ファイル共有のリストからファイル共有を選択します。
  2. 「ファイル共有の詳細」ページで、「アクセサー共有バインディング」セクションまでスクロールして、削除するバインディングを見つけます。
  3. バインディングの行の最後にある 「アクション」 アイコン 「アクション」アイコン をクリックし、 「削除」 を選択します。

コンソールでファイル共有のマウント先を削除する

  1. ファイル共有のリストからファイル共有を選択します。
  2. 「ファイル共有の詳細」ページで、削除したいマウント先を選択します。
  3. 「アクション」アイコン 「アクション」アイコン をクリックし、 「削除」 を選択します。

コンソールでファイル共有を削除する

ファイル共有は、「 stable 」状態または「 failed 」状態である必要があります。

  1. ファイル共有のリストからファイル共有を選択します。
  2. 行の末尾にある 「アクション」 アイコン 「アクション」アイコン をクリックし、 「削除」 を選択します。

CLI からのファイル共有、アクセサー共有バインディング、およびマウント・ターゲットの削除

以下の手順は、不要になったファイル共有を削除する前に、共有バインディングとマウントターゲットが削除されていることを確認するのに役立ちます。

  1. 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               -                       -                -
  1. 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 を参照してください。