查看文件共享,共享绑定和安装目标
使用控制台、CLI、API 或 Terraform 查看 File Storage for VPC 共享、访问者共享绑定和挂载目标。
在控制台中查看文件共享、共享绑定和挂载目标
在控制台中查看所有文件共享
-
在 IBM Cloud 控制台中,单击导航菜单图标
> 基础架构
> 存储 > 文件存储共享。
-
“VPC 的文件共享”列表页面显示在该区域中创建的所有文件共享。 操作 菜单
选项用于管理文件共享。 下表描述了列表页面上的信息。
| 字段 | 值 |
|---|---|
| 区域 | 文件共享的帐户区域。 选择其他区域以查看该区域中的区域的文件共享。 |
| 名称 | 文件共享名称。 它可以是原始文件共享或副本文件共享。 单击名称以查看有关该文件共享的详细信息。 |
| 状态 | 有关文件共享的状态列表,请参阅 文件共享生命周期状态。 |
| 资源组 | 字段显示文件共享所属资源组的名称。 |
| 地区 | 该字段显示文件共享所在的区域。 |
| 安装目标 | 与文件共享关联的安装目标数。 每个VPC、每个文件共享最多可有一个挂载目标。 |
| 快照 | 此字段显示文件共享的快照数量。 此栏默认为隐藏。 单击 |
| 大小 | 文件共享的大小 (以 GB 为单位)。 |
| 跨账户作用 | 此列中的值可以是 None、Origin share 或 Accessor share。 如果值为 None,则不会与其他账户或外部服务共享共享。 如果值为 Origin share,则共享将与另一个账户或外部服务共享,并与另一个账户中的访问者共享绑定。 如果值为 Accessor share,则该共享与源共享绑定,目的是访问源共享的数据。 |
| 复制角色 | 源和副本文件共享之间的关系。 “副本”指示文件共享源共享 (已链接) 的副本。 “源”表示共享副本的源 (已链接)。 “无”表示文件共享不会与另一个共享进行复制。 |
| 复制状态 | 此栏默认为隐藏。 单击 |
| 加密类型 | 它显示文件共享 (提供者管理或客户管理) 的加密类型。 客户管理的加密 使用您自己的根密钥来保护数据。 该用户界面还会标识密钥管理服务(KMS)。 |
您可以通过单击 来访问“操作”菜单。 “操作”菜单具有用于管理文件共享的选项,具体取决于其状态。
- 对于处于_稳定_状态的区域文件共享,您可以选择重命名共享、编辑 IOPS、复制共享的 CRN、创建副本或删除文件共享。 如果您已将复制设置为副本文件共享,则删除和创建副本操作将被禁用。 有关详细信息,请参阅 创建副本文件共享。
- 对于区域文件共享,操作菜单包含重命名、编辑大小和带宽、复制 CRN、创建快照和删除操作。
在控制台中查看文件共享的详细信息
-
转至所有文件共享的列表。 从 IBM Cloud 控制台,单击导航菜单图标
> 基础架构
> 存储 > 文件存储共享。
-
单击文件共享的名称以查看详细信息页面。 将显示文件共享的可编辑名称和状态。 如果您对文件共享应用了用户或访问管理标记,它们会列在状态旁边。 单击 添加标记 以将新的 标记 应用于共享。
-
详细信息页面有几个选项卡。 默认显示 “概览”选项卡。
- 概述- 下表描述了文件共享的可用信息。
文件共享详细信息页面 字段 值 文件共享详细信息 名称 文件共享名称。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以更改名称。 文件共享标识 创建文件共享时生成的 UUID。 资源组 与帐户中的文件共享关联的资源组。 创建日期 创建文件共享的日期。 地区 文件共享的位置(例如 us-south-2 )。 复制角色 源文件共享或副本。 加密 指定提供者管理的加密或 客户管理的加密。 当文件共享使用客户管理密钥加密时,还会显示加密实例、加密密钥名称和加密密钥 CRN。 挂载目标访问模式
已弃用只有当文件共享采用已弃用的 VPC 访问模式时,才会显示此字段。 点击 “编辑”图标 ”以切换访问模式。 如需了解更多信息,请参阅 迁移指南。
CRN 文件共享的可复制云资源名称。 允许在传输模式下进行加密 此值显示当客户机访问文件共享时是否需要传输中的加密。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以更改允许的值。 可能的值是 User managed,和None。 对于采用已弃用的 VPC 访问模式的文件共享,此字段不适用。
选择可用性 拥有特殊权限可预览新区域文件共享服务的客户,可从 IPsec、Stunnel 和“无”中进行选择。跨账户作用 可能的值包括“无”、“起源”、“访问者”。 对于采用已弃用的 VPC 访问模式的文件共享,此字段不适用。 快照计数 该值表示文件共享的快照数量。 对于采用已弃用的 VPC 访问模式的文件共享,此字段不适用。 所有快照中已更改数据的大小 它代表所有快照中的计费数据量。 对于采用已弃用的 VPC 访问模式的文件共享,此字段不适用。 概要文件详细信息 Profile 定义文件共享性能的共享 配置文件 的名称。 在大多数情况下,dp2 配置文件。 大小 文件共享容量(单位:GB)。 最大 IOPS 指定共享的最大 IOPS。 此字段显示为分区共享。 带宽 为共享指定的最大带宽限制。 此字段显示为区域共享。 安装目标 与文件共享关联的安装目标数。 每个VPC、每个文件共享最多可有一个挂载目标。 您可以为其他 VPC 创建更多安装目标。 单击 <img src="../icons/action-menu-icon.svg" alt=""操作" 图标"> 以重命名或删除安装目标,或者查看安装路径。 名称 安装目标的名称。 状态 VPC 上安装目标的状态。 虚拟私有云
已弃用如果文件共享采用已弃用的 VPC 访问模式,则会显示此字段。 单击名称可转到该 VPC 的详细信息页面,您可以在该页面上查看在该 VPC 中具有挂载目标的 文件共享列表。 Subnet 文件共享具有安全组访问模式时,将显示此字段。 单击子网的名称以查看其详细信息。 Security group 文件共享具有安全组访问模式时,将显示此字段。 这是共享是其成员的安全组的数量。 预留的 IP 文件共享具有安全组访问模式时,将显示此字段。 连接到安装目标的虚拟网络接口的 IP 地址 传输中加密 文件共享具有安全组访问模式时,将显示此字段。 该值可以启用或禁用。 访问者共享绑定 如果该共享在其他 VPC 中包含访问共享,则会显示此部分。 绑定标识 此字段显示将源共享连接到存取器共享的绑定的标识。 帐户标识 有权通过存取器共享访问共享数据的帐户的标识。 存取器标识 此字段显示在另一个 VPC 中创建存取器共享的帐户标识。 状态 它显示存取器文件共享的生命周期状态。 需要 status Stable创建日期 访问者股份的创建日期和时间。 文件共享复制关系 显示源和副本文件共享的名称,位置和状态
- 如果未创建副本文件共享,请单击 创建副本 以 创建一个。
- 要中断复制关系,请单击 除去复制关系。 然后,副本文件共享成为独立的读/写文件共享。
复制频率 将鼠标悬停在信息图标上,以查看 cron 复制调度的说明。 状态 复制状态; 例如,已暂挂 或 可用。 上次同步开始时间 上次复制开始的日期和时间。 上次同步完成时间 上次复制结束的日期和时间。 传输速率 它显示在上次同步期间将数据从源文件共享复制到其副本的速度。 转账金额 上次同步期间从源文件共享复制到其副本的数据量。 复制角色 源或副本文件共享。 文件共享名称 单击文件共享名称以查看其详细信息。 地区 它显示文件共享的区域信息。 状态 它显示文件共享的生命周期状态。 需要 status Stable。-
快照- 在“快照”选项卡上,您可以查看与所有快照相关的摘要,以及针对该文件共享所创建的快照列表。
- 快照摘要提供的信息包括快照数量、快照中捕获的总体数据量以及复制角色。
- 快照列表显示文件共享的快照。 您可以看到名称、拍摄快照时文件共享的大小以及快照的状态。 您可以单击“创建” 捕获新快照。 单击操作图标
,显示操作菜单。 操作菜单有 2 个选项:还原和删除。
-
监控- 在监控选项卡上,可以看到共享使用情况、总带宽和总 IOPS 的三个图表。 即使没有IBM Cloud Monitoring实例,您也可以免费使用这些图表。 您可以自定义日期范围,以查看一段时间内的数据。
监控这些利用率指标可帮助您确定应用程序或工作负载完成了多少工作。 您可以使用此信息来确定是否需要调整 IOPS 值。 监控共享的可用容量可帮助您确定是否需要更多存储空间,以免空间不足成为向共享或复制写入数据的问题。 查看这些指标可以帮助您预测账单期末费用的任何变化。
这些指标不会实时更新。 新文件共享的数据可能需要 1 小时或 1 小时 15 分钟才能显示在控制台的图表中。 使用情况的变化需要 15 至 30 分钟才能反映在图表中。
如果您有 IBM Cloud Monitoring 服务实例,请单击“启动监控”打开 Sysdig Web UI,以使用其中的度量仪表板。 有关如何设置 IBM Cloud Monitoring 实例的详细信息,请参阅 Monitoring metrics for File Storage for VPC。
在控制台中查看 VPC 的所有文件共享
您可以通过查看 VPC 详细信息页面来查看具有 VPC 的安装目标的所有文件共享。
-
转至 VPC:
- 从 文件共享详细信息页面 中,单击安装目标列表中的 VPC 链接。
- 从用户界面,单击 导航菜单 图标
> 基础架构
> 网络 > VPC。 单击列表中 VPC 的名称。
-
在 VPC 详细信息页面上,滚动到 此 VPC 中的文件共享。
在控制台中查看挂载目标详细信息
- 转至所有文件共享的列表。 从 IBM Cloud 控制台,单击导航菜单图标
> 基础架构
> 存储 > 文件存储共享。
- 单击文件共享的名称以查看详细信息页面。
- 滚动到“安装目标”部分以查看安装目标的列表。 该列表包含安装目标的名称和状态以及安装目标所属的 VPC。
- 单击 操作 图标
以显示“操作”菜单。 “操作”菜单具有 3 选项:“重命名”,“查看路径”和“删除”。
- 单击 查看路径 以查看可以在安装命令中复制和粘贴的安装路径信息。
从 CLI 查看文件共享,共享绑定和安装目标
在使用 CLI 之前,您必须先安装 IBM Cloud CLI 以及 VPC CLI 插件。 有关更多信息,请参阅 CLI 先决条件。
从 CLI 查看所有文件共享
您可以使用 ibmcloud is shares 命令列出区域中的所有文件共享。
ibmcloud is shares
Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID Name Lifecycle state Zone Profile Size(GB) Resource group Replication role Accessor binding role Snapshot count Snapshot size 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 命令并按标识或名称指定文件共享。
以下示例按标识标识文件共享。 此共享是基于 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 命令并指定文件共享标识。
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 命令并使用安装目标名称或标识指定共享标识或名称。 请参阅以下示例。
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。 如需了解更多信息,请参阅《 虚拟私有云 API 参考指南 》中的 “生成”部分。
使用 API 查看复制状态和 lifecycle_state
lifecycle_statereplication_status- 此属性通过 检索文件共享 方法提供文件的当前复制状态。
replication_status返回的值特定于文件共享。 有关更多信息,请参阅 Virtual Private Cloud API 内容。
- 此属性通过 检索文件共享 方法提供文件的当前复制状态。
使用 API 查看所有文件共享
发出 GET /shares 请求以列出区域的所有文件共享。
curl -X GET "$vpc_api_endpoint/v1/shares?version=2023-07-18?limit=50&generation=2" -H "Authorization: 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 个文件共享的限制,尽管示例响应只包含一个文件共享。 access_control_mode 属性值为 vpc,这意味着可以在 VPC 中的所有虚拟服务器实例上安装文件共享。 这种访问控制模式已被弃用。 请按照 迁移指南 将共享的访问控制模式更新为 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 中标识符指定的单个绑定。
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 请求并指定副本共享标识以检索源文件共享详细信息。
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"
}
}
使用 Terraform 查看文件共享和安装目标
您可以使用 Terraform 来查看有关文件共享和安装目标的信息。
要使用 Terraform,请下载 Terraform CLI 并配置 IBM Cloud Provider 插件。 有关更多信息,请参阅 Terraform 入门。
VPC 基础架构服务使用特定区域端点,缺省情况下该端点以 us-south 为目标。 如果 VPC 是在另一个区域中创建的,请确保将 provider.tf 文件中的提供程序块中的相应区域作为目标。
请参阅以下以非缺省 us-south 区域为目标的示例。
provider "ibm" {
region = "eu-de"
}
使用 Terraform 查看所有文件共享
导入属于作为只读数据源的帐户的文件共享的列表。 您可以按共享名称或资源组标识进行过滤。
data "ibm_is_shares" "example" {
}
导出的属性包括共享总数和共享列表。 嵌套属性包括共享标识,名称,创建日期,大小,IOPS,CRN,访问标记,加密类型和密钥,生命周期状态,复制角色和状态,安装目标和其他属性。
有关更多信息,请参阅 ibm_is_shares。
使用 Terraform 查看文件共享信息
将文件共享的详细信息作为只读数据源导入。 您必须按标识或名称标识共享。
data "ibm_is_share" "example" {
share = ibm_is_share.example.id
}
data "ibm_is_share" "example" {
name = ibm_is_share.example.name
}
导出的属性包括标识,名称,创建日期,大小,IOPS,CRN,访问标记,加密类型,加密密钥,生命周期状态,复制角色和状态,安装目标和其他属性。
有关更多信息,请参阅 ibm_is_share。
查看与 Terraform 的文件共享关联的安装目标
导入与作为只读数据源的文件共享相关联的安装目标的列表。 按文件共享的标识来标识该文件共享。
data "ibm_is_share_mount_targets" "example" {
share = ibm_is_share.example.id
}
导出的属性包括挂载目标列表及其 ID、名称、创建日期、挂载路径和子网信息。
有关详细信息,请参阅 ibm_is_share_ mount _targets。
使用 Terraform 查看安装目标信息
将安装目标的详细信息作为只读数据源导入。 通过指定共享标识和安装目标标识来标识安装目标。 这两个参数都是必需的。
data "ibm_is_share_mount_target" "example" {
share = ibm_is_share.example.id
mount_target = ibm_is_share_mount_target.example.mount_target
}
导出的属性包括标识,名称,创建日期,安装路径,子网信息和其他属性。
更多信息,请参阅 ibm_is_share_ mount _target。
后续步骤
安装文件共享。 挂载是指服务器操作系统通过服务器文件系统将存储设备上的文件和目录提供给用户访问的过程。 有关更多信息,请参阅以下主题:
- IBM Cloud File Share Mount Helper 实用程序
- 在 Red Hat Linux 上安装文件共享。
- 在 CentOS中安装文件共享。
- 在 Ubuntu 上安装文件共享。
- 在 z/OS上安装文件共享
管理文件共享和数据。
- 管理文件共享。 您可以重命名文件共享。 您可以增加其容量并修改其 IOPS。 可以将安装目标添加到文件共享。 您可以重命名或删除安装目标。 当不再需要文件共享时,您可以将其删除。
- 创建与复制的文件共享。 通过复制功能,您可以将文件共享的只读副本保留在另一个区域中。 将根据您指定的调度从源共享更新副本共享。 当数据变为不可访问或应用程序发生故障时,复制提供了一种从主站点上的事件恢复的方法。 复制还可用于地理扩展。