コンソール、CLI、API、またはTerraformを使用して、 File Storage for VPC の共有、アクセサの共有バインディング、およびマウント先を確認します。
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 Allowed Access Protocols Availability Mode Bandwidth(Mbps) Storage Generation
r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279 my-regional-file-share stable - rfs 1000 defaults none none 0 0 - regional 1500 2
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-file-share stable us-south-2 dp2 10 defaults source none 2 1 - zonal - 1
r006-455b601c-8fc1-4476-8771-4708c49c8ef7 my-replica-file-share stable us-south-1 dp2 10 defaults replica none 2 1 - zonal - 1
r006-ee1f6fc0-6fa3-4821-ad70-f6589e30c566 my-accessor-share stable - rfs 3000 defaults none accessor 0 0 - regional 1 2
r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09 my-origin-share stable - rfs 3000 defaults none origin 0 0 - regional 1 2
コマンド・オプションについて詳しくは、「 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-file-share
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,ipsec
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-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-file-share share
Snapshot count 0
Snapshot size 0
Source snapshot -
Allowed Access Protocols nfs4
Availability Mode zonal
Bandwidth(Mbps) 1
Storage Generation 1
ソース共有の名前を使用して、その詳細を取得できます。 以下の例を参照してください。
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 ipsec,none
Zone us-south-2
Profile dp2
Size(GB) 10
IOPS 100
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
6edefe513d934fdd872e78ee6a8e73ef defaults
Created 2024-06-25T15:42:53+00:00
Latest job Job status Job status reasons
succeeded -
Replication share ID Name Resource type
r006-455b601c-8fc1-4476-8771-4708c49c8ef7 my-replica-file-share share
Replication role source
Replication status active
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-6cedac18-ffe5-4a89-9e7a-5c8683d17279
Name my-regional-file-share
CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279
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 found
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
コマンド・オプションについて詳しくは、「 ibmcloud is share」を参照してください。
CLI からのファイル共有の共有バインディングの表示
CLIからオリジン共有にリンクされているアクセサ共有バインディングを表示するには、ibmcloud is share-accessor-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 Accessor resource type
r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f stable 2025-08-26T21:03:40+00:00 crn:v1:bluemix:public:is::a/a1234567::share:r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09 share
Viktoria_Muirhead@cloudshell:~$
CLI からのファイル共有の特定の共有バインディングの表示
CLIからオリジン共有にリンクされている特定のアクセサー共有バインディングを表示するには、ibmcloud is share-accessor-binding コマンドを使用します。 以下の例を参照してください。
ibmcloud is share-accessor-binding my-origin-share r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Get accessor binding r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f for the share ID my-origin-share under account Test Account as user test.user@ibm.com...
ID r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Created 2025-08-26T21:03:40+00:00
Href https://us-south.iaas.cloud.ibm.com/v1/shares/r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09/accessor_bindings/r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Resource type share_accessor_binding
Lifecycle state stable
Accessor Resource type CRN Name
share crn:v1:bluemix:public:is::a/a1234567::share:r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09 my-accessor-share
CLI からファイル共有のマウント先を表示する
ファイル共有用に作成されたすべてのマウント・ターゲットを表示するには、 ibmcloud is share-mount-targets コマンドを実行してファイル共有 ID を指定します。
ibmcloud is share-mount-targets r006-e1a89008-f23b-42f8-8e44-5b31ddf0aac7
Listing share mount target of r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID Name VPC Lifecycle state Transit Encryption
r006-fdbffc45-618c-49f1-bb08-ec530d7be378 my-source-mount-target my-vpc stable none
コマンド・オプションについて詳しくは、「 ibmcloud is share-mount-targets」を参照してください。
CLI からのマウント・ターゲットの詳細の表示
マウント・ターゲットに関する詳細情報を表示するには、 ibmcloud is share-mount-target コマンドを実行し、共有 ID または共有名をマウント・ターゲットの名前または ID と共に指定します。 以下の例を参照してください。
ibmcloud is share-mount-target r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-mount-target
Getting mount target ID my-source-mount-target for share ID r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a under account Test Account as user test.user@ibm.com...
ID r006-fdbffc45-618c-49f1-bb08-ec530d7be378
Name my-source-mount-target
VPC ID Name
r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b my-vpc
Access control mode security_group
Resource type share_mount_target
Virtual network interface ID Name
r006-3b0c00fa-0ce3-4ff8-9a5d-c7a645fbe530 my-source-vni
Lifecycle state stable
Mount path 10.240.64.6:/5975a795_e5e7_474c_82d3_46c1d4159c6a
Transit Encryption none
Created 2023-10-19T15:42:54+00:00
コマンド・オプションについて詳しくは、「 ibmcloud is share-mount-target」を参照してください。
API を使用したファイル共有、共有バインディング、およびマウント・ターゲットの表示
以下のサンプル要求に示すように、 VPC API で /shares メソッドを呼び出すことにより、共有とマウント・ターゲットをプログラマチックに表示できます。
generation パラメーターを指定し、 generation=2 を指定する必要があります。 詳細については、『 Virtual Private Cloud API リファレンス 』の 「Generation」 の項を参照してください。
API を使用した複製状況および lifecycle_state の表示
lifecycle_state
- このプロパティーは、 ファイル共有の取得 メソッドを使用して、リソースの現在の状態を提供します。
lifecycle_state が提供する値は汎用的なものであり、ファイル共有だけでなく、さまざまなリソースに適用されることを意図しています。 lifecycle_state は、ファイル共有が「安定」、「更新中」、「削除中」、または「一時停止中」のいずれの状態にあるかを示します。
Stable であることが想定されています。 詳しくは、 ファイル共有状況 を参照してください。
replication_status
API を使用してすべてのファイル共有を表示する
領域のすべてのファイル共有をリストするには、GET /shares 要求を行います。
curl -X GET "$vpc_api_endpoint/v1/shares?version=2023-07-18?limit=50&generation=2" -H "Authorization: Bearer $iam_token"
正常な応答は、次の例のようになります。
{
"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"
}
}
]
}
この例では、'limit クエリーパラメーターが50ファイル共有の制限を指定しているが、応答例には1つしか含まれていない。 access_control_mode プロパティーの値は vpc です。これは、VPC 内のすべての仮想サーバー・インスタンスにファイル共有をマウントできることを意味します。 このアクセス制御モードは[非推奨で]ある{: tag-deprecated}。 移行ガイドに従って、共有のアクセス・コントロール・モードを
security-group に更新してください。
API を使用して単一のファイル共有を表示する
単一のファイル共有に関する詳細を取得するには、GET /shares/{share_id} 要求を行います。
curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-04-01&generation=2"\
-H "Authorization: Bearer $iam_token"
正常な応答は、次の例のようになります。 この例では、共有は「dp2 プロファイルで作成されている。 access_ control_mode プロパティーの値は security_group です。これは、共有へのアクセスがセキュリティー・グループのルールによって決定されることを意味します。
{
"access_control_mode": "security_group",
"accessor_binding_role": "none",
"accessor_bindings": [],
"allowed_access_protocol": "nsf4",
"allowed_transit_encryption_modes": [
"none",
"ipsec"
],
"availability_mode": "zonal",
"bandwidth": 100,
"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,
"storage_generation": 1,
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
"name": "us-south-2"
}
}
以下の例は、APIで地域ファイルの情報を取得したときに返されるレスポンスである。
curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-07-23&generation=2"\
-H "Authorization: Bearer $iam_token"
正常な応答は、次の例のようになります。
{
"access_control_mode": "security_group",
"accessor_binding_role": "none",
"accessor_bindings": [],
"allowed_access_protocol": "nsf4",
"allowed_transit_encryption_modes": [
"none",
"stunnel"
],
"availability_mode": "regional",
"bandwidth": 100,
"created_at": "2025-06-24T09:17:14.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33f1",
"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-1388705d33ef1",
"iops": 100,
"latest_job": {
"status": "succeeded",
"status_reasons": [],
"type": "replication_init"
},
"lifecycle_reasons": [],
"lifecycle_state": "stable",
"mount_targets": [],
"name": "my-regional-share-us-south",
"profile": {
"family": "defined_performance",
"href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/rfs",
"name": "rfs",
"resource_type": "share_profile"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"resource_type": "share",
"size": 100,
"snapshot_count": 0,
"snapshot_size": 0,
"storage_generation": 2,
"user_tags": []
}
API とのファイル共有の共有バインディングをリストします
単一ファイル共有のバインディングのリストを取得するには、 GET /shares/{id}/bindings 要求を実行します。 この要求は、共有のすべてのバインディングをリストします。 各バインディングは、アクセサー共有の作成時に暗黙的に作成されます。
curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings?version=2024-03-20&generation=2"\
-H "Authorization: Bearer $iam_token"
正常な応答は、次の例のようになります。
{
"bindings": [
{
"accessor": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
"id": "r006-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/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r006-df760133-3513-47e7-b980-26cca666561b",
"id": "r006-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/r006-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: Bearer $iam_token"
正常な応答は、次の例のようになります。
{
"accessor": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
"id": "r006-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/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r006-df760133-3513-47e7-b980-26cca666561b",
"id": "r006-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: Bearer $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: Bearer $iam_token"
正常な応答は、次の例のようになります。 この例では、 転送中のデータ暗号 化が有効になっている。
{
"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": "ipsec",
"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: Bearer $iam_token"\
正常な応答では、ソース・ファイル共有の詳細が提供されます。 複製の役割が sourceであることに注意してください。
{
"access_control_mode": "security_group",
"created_at": "2023-07-18T22:58:49.000Z",
"crn": "crn:[...]",
"encryption": "none",
"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"
}
}
> インフラストラクチャ
> ストレージ > ファイル ストレージ共有をクリックします。
オプションは、ファイル共有を管理するために使用します。 次の表は、一覧ページに掲載されている情報について説明したものです。
クリックし、表示する列を選択します。
をクリックして、名前を変更します。