查看文件共享,共享绑定和安装目标

使用控制台、CLI、API 或 Terraform 查看 File Storage for VPC 共享、访问者共享绑定和挂载目标。

在控制台中查看文件共享、共享绑定和挂载目标

在控制台中查看所有文件共享

  1. IBM Cloud 控制台中,单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 文件存储共享

  2. “VPC 的文件共享”列表页面显示在该区域中创建的所有文件共享。 操作 菜单 "操作" 图标 选项用于管理文件共享。 下表描述了列表页面上的信息。

文件共享列表页面。
字段
区域 文件共享的帐户区域。 选择其他区域以查看该区域中的区域的文件共享。
名称 文件共享名称。 它可以是原始文件共享或副本文件共享。 单击名称以查看有关该文件共享的详细信息。
状态 有关文件共享的状态列表,请参阅 文件共享生命周期状态
资源组 字段显示文件共享所属资源组的名称。
地区 该字段显示文件共享所在的区域。
安装目标 与文件共享关联的安装目标数。 每个VPC、每个文件共享最多可有一个挂载目标。
快照 此字段显示文件共享的快照数量。 此栏默认为隐藏。 单击设置图标,选择要查看的列。
大小 文件共享的大小 (以 GB 为单位)。
跨账户作用 此列中的值可以是 NoneOrigin shareAccessor share。 如果值为 None,则不会与其他账户或外部服务共享共享。 如果值为 Origin share,则共享将与另一个账户或外部服务共享,并与另一个账户中的访问者共享绑定。 如果值为 Accessor share,则该共享与源共享绑定,目的是访问源共享的数据。
复制角色 源和副本文件共享之间的关系。 “副本”指示文件共享源共享 (已链接) 的副本。 “源”表示共享副本的源 (已链接)。 “无”表示文件共享不会与另一个共享进行复制。
复制状态 此栏默认为隐藏。 单击设置图标,选择要查看的列。
加密类型 它显示文件共享 (提供者管理或客户管理) 的加密类型。 客户管理的加密 使用您自己的根密钥来保护数据。 该用户界面还会标识密钥管理服务(KMS)。

您可以通过单击 "操作" 图标 来访问“操作”菜单。 “操作”菜单具有用于管理文件共享的选项,具体取决于其状态。

  • 对于处于_稳定_状态的区域文件共享,您可以选择重命名共享、编辑 IOPS、复制共享的 CRN、创建副本或删除文件共享。 如果您已将复制设置为副本文件共享,则删除创建副本操作将被禁用。 有关详细信息,请参阅 创建副本文件共享
  • 对于区域文件共享,操作菜单包含重命名、编辑大小和带宽、复制 CRN、创建快照和删除操作。

在控制台中查看文件共享的详细信息

  1. 转至所有文件共享的列表。 从 IBM Cloud 控制台,单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 文件存储共享

  2. 单击文件共享的名称以查看详细信息页面。 将显示文件共享的可编辑名称和状态。 如果您对文件共享应用了用户或访问管理标记,它们会列在状态旁边。 单击 添加标记 以将新的 标记 应用于共享。

  3. 详细信息页面有几个选项卡。 默认显示 “概览”选项卡。

    • 概述- 下表描述了文件共享的可用信息。
    文件共享详细信息页面
    字段
    文件共享详细信息
    名称 文件共享名称。 单击 编辑图标 <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 的安装目标的所有文件共享。

  1. 转至 VPC:

    1. 文件共享详细信息页面 中,单击安装目标列表中的 VPC 链接。
    2. 从用户界面,单击 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 网络 > VPC。 单击列表中 VPC 的名称。
  2. 在 VPC 详细信息页面上,滚动到 此 VPC 中的文件共享

在控制台中查看挂载目标详细信息

  1. 转至所有文件共享的列表。 从 IBM Cloud 控制台,单击导航菜单图标菜单图标 > 基础架构 VPC 图标 > 存储 > 文件存储共享
  2. 单击文件共享的名称以查看详细信息页面。
  3. 滚动到“安装目标”部分以查看安装目标的列表。 该列表包含安装目标的名称和状态以及安装目标所属的 VPC。
  4. 单击 操作 图标 "操作" 图标 以显示“操作”菜单。 “操作”菜单具有 3 选项:“重命名”,“查看路径”和“删除”。
  5. 单击 查看路径 以查看可以在安装命令中复制和粘贴的安装路径信息。

从 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_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 个文件共享的限制,尽管示例响应只包含一个文件共享。 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。

后续步骤

安装文件共享。 挂载是指服务器操作系统通过服务器文件系统将存储设备上的文件和目录提供给用户访问的过程。 有关更多信息,请参阅以下主题:

管理文件共享和数据。

  • 管理文件共享。 您可以重命名文件共享。 您可以增加其容量并修改其 IOPS。 可以将安装目标添加到文件共享。 您可以重命名或删除安装目标。 当不再需要文件共享时,您可以将其删除。
  • 创建与复制的文件共享。 通过复制功能,您可以将文件共享的只读副本保留在另一个区域中。 将根据您指定的调度从源共享更新副本共享。 当数据变为不可访问或应用程序发生故障时,复制提供了一种从主站点上的事件恢复的方法。 复制还可用于地理扩展。