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

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

你可以在控制台中查看所有文件共享、它们的绑定和挂载目标,也可以通过 CLI、API 或 Terraform 获取它们的信息。 您可以检索所有共享,绑定和安装目标的信息,或者仅检索特定资源的信息。

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

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

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

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

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

您可以通过单击 "操作" 图标 来访问“操作”菜单。 “操作”菜单具有用于管理文件共享的选项,具体取决于其状态。 对于处于 稳定 状态的文件共享,您可以重命名该共享,编辑 IOPS,复制该共享的 CRN,创建副本或删除文件共享。 如果已设置对副本文件共享的复制,那么将禁用 删除创建副本。 有关详细信息,请参阅 创建复制文件共享

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

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

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

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

    • 概述- 下表描述了文件共享的可用信息。

      文件共享详细信息页面
      字段
      文件共享详细信息
      名称 文件共享名称。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以更改名称。
      文件共享标识 创建文件共享时生成的 UUID。
      资源组 与帐户中的文件共享关联的资源组。
      创建日期 创建文件共享的日期。
      地区 文件共享的位置(例如 us-south-2 )。
      复制角色 源文件共享或副本。
      加密 指定提供者管理的加密或 客户管理的加密。 当文件共享使用客户管理密钥加密时,还会显示加密实例、加密密钥名称和加密密钥 CRN。
      安装目标访问方式 对文件共享的访问权由子网中的安全组或 VPC 中的任何虚拟服务器实例授予。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以切换访问方式。 安全组访问权仅可用于使用 dp2 概要文件 创建的文件共享。 有关更多信息,请参阅 安装目标访问方式
      CRN 文件共享的可复制云资源名称。
      允许在传输模式下加密 此值显示当客户机访问文件共享时是否需要传输中的加密。 单击 编辑图标 <img src="../icons/edit-tagging.svg" alt=""编辑" 图标" title="编辑"> 以更改允许的值。 可能的值是用户管理和无。 此字段不适用于具有 VPC 访问模式的文件共享。
      跨账户作用 可能的值包括“无”、“起源”、“访问者”。 此字段不适用于具有 VPC 访问模式的文件共享。
      快照计数 该值表示文件共享的快照数量。 此字段不适用于具有 VPC 访问模式的文件共享。
      所有快照中已更改数据的大小 它代表所有快照中的计费数据量。 此字段不适用于具有 VPC 访问模式的文件共享。
      概要文件详细信息
      Profile 定义文件共享性能的共享 配置文件 的名称。 在大多数情况下,dp2 配置文件。
      大小 文件共享容量(GB)。
      最大 IOPS 指定共享的最大 IOPS。
      安装目标 与文件共享关联的安装目标数。 每个 VPC 每个文件共享只能有一个挂载目标。 您可以为其他 VPC 创建更多安装目标。 单击 <img src="../icons/action-menu-icon.svg" alt=""操作" 图标"> 以重命名或删除安装目标,或者查看安装路径。
      名称 安装目标的名称。
      状态 VPC 上安装目标的状态。
      虚拟私有云 如果文件共享具有 VPC 访问方式,那么将显示此字段。 单击名称以转至该 VPC 的详细信息页面,您可以在该页面中看到在该 VPC 中具有安装目标的 文件共享列表
      Subnet 如果文件共享具有安全组访问方式,那么将显示此字段。 单击子网的名称以查看其详细信息。
      安全组 如果文件共享具有安全组访问方式,那么将显示此字段。 这是共享是其成员的安全组的数量。
      预留的 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   
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   

有关命令选项的更多信息,请参阅 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-share-dal-1   
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,user_managed   
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-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   share      

Snapshot count                     0   
Snapshot size                      0   
Source snapshot                    -   

您可以使用源共享的名称来检索其详细信息。 请参阅以下示例。

$ 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 user_managed,none
Zone                             us-south-2   
Profile                          dp2   
Size(GB)                         1500   
IOPS                             2000   
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      
                                 db8e8d865a83e0aae03f25a492c5b39e   Default      

Created                          2024-06-25T15:42:53+00:00   
Latest job                       Job status   Job status reasons      
                                 succeeded    -      

Replication share                ID                                          Name                    Resource type      
                                 r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   share      

Replication role                 source   
Replication status               active   
Replication status reasons       Status code   Status message      
                                 -             -
Snapshot count                   0
Snapshot size                    0

有关命令选项的更多信息,请参阅 ibmcloud is share

从 CLI 查看文件共享的共享绑定

要从 CLI 查看链接到原始共享的访问者共享绑定,请使用 ibmcloud is share-accesssor-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
r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3   stable           2024-06-25T00:50:57+05:30  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232

从 CLI 查看文件共享的特定共享绑定

要从 CLI 查看链接到原始共享的特定访问者共享绑定,请使用 ibmcloud is share-accesssor-binding 命令。 请参阅以下示例。

$ ibmcloud is share-accessor-binding my-origin-share r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Get accessor binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for the share ID my-origin-share under account Test Account as user test.user@ibm.com...

ID               r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Created          2024-06-25T00:50:57+05:30
Href             https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed/bindings/r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Resource type    share_accessor_binding
Lifecycle state  stable
Accessor         Resource type  Name               CRN
                 share          my-accessor-share  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232

从 CLI 查看文件共享的安装目标

要查看为文件共享创建的所有安装目标,请运行 ibmcloud is share-mount-targets 命令并指定文件共享标识。

$ ibmcloud is share-mount-targets  r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
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: $iam_token"

成功回复的示例如下 在示例中,"limit 查询参数指定了 50 个文件共享的限制,尽管示例响应只包含一个文件共享。 access_control_mode 属性值为 vpc,这意味着可以在 VPC 中的所有虚拟服务器实例上安装文件共享。

{
  "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"
      }
    }
  ]
}

使用 API 查看单个文件共享

发出 GET /shares/{share_id} 请求以获取有关单个文件共享的详细信息。

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-04-01&generation=2"\
-H "Authorization: $iam_token"

成功回复的示例如下 在本例中,共享是用 "dp2 配置文件创建的。 access_ control_mode 属性值为 security_group,这意味着对共享的访问权由安全组的规则确定。

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_transit_encryption_modes": [
      "none",
      "user_managed"
  ],
  "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,
  "user_tags": [],
  "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
      "name": "us-south-2"
  }
}

列示与 API 的文件共享的共享绑定

发出 GET /shares/{id}/bindings 请求以获取单个文件共享的绑定列表。 该请求列出共享的所有绑定。 创建存取器共享时,将隐式创建每个绑定。

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"

成功回复的示例如下

{
  "bindings": [
    {
      "accessor": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "id": "r134-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/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
      "id": "r134-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/r134-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: $iam_token"

成功回复的示例如下

{
  "accessor": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "id": "r134-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/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
  "id": "r134-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: $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: $iam_token"

成功回复的示例如下 在此示例中,未启用 传输中的数据加密transit_encryption 属性值为 provider_managed

{
    "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": "provider_managed",
    "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: $iam_token"\

成功响应将提供源文件共享的详细信息。 请注意,复制角色为 source

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T22:58:49.000Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "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 提供者插件。 有关更多信息,请参阅 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" "example1" {
  name = ibm_is_share.example.name
}

导出的属性包括标识,名称,创建日期,大小,IOPS,CRN,访问标记,加密类型,加密密钥,生命周期状态,复制角色和状态,安装目标和其他属性。

有关更多信息,请参阅 ibm_is_share

查看与 Terraform 的文件共享关联的安装目标

导入与作为只读数据源的文件共享相关联的安装目标的列表。 按文件共享的标识来标识该文件共享。

data "ibm_is_share_targets" "example" {
  share = ibm_is_share.example.id
}

导出的属性包括安装目标及其标识,名称,创建日期,安装路径和子网信息等的列表。

有关更多信息,请参阅 ibm_is_share_targets

使用 Terraform 查看安装目标信息

将安装目标的详细信息作为只读数据源导入。 通过指定共享标识和安装目标标识来标识安装目标。 这两个参数都是必需的。

data "ibm_is_share_target" "example" {
  share        = ibm_is_share.example.id
  share_target = ibm_is_share_target.example.share_target
}

导出的属性包括标识,名称,创建日期,安装路径,子网信息和其他属性。

有关更多信息,请参阅 ibm_is_share_target

后续步骤

安装文件共享。 安装是一个过程,服务器的操作系统通过该过程使存储设备上的文件和目录可供用户通过服务器的文件系统进行访问。 有关更多信息,请参阅以下主题:

管理文件共享和数据。

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