查看文件共享,共享绑定和安装目标
你可以在控制台中查看所有文件共享、它们的绑定和挂载目标,也可以通过 CLI、API 或 Terraform 获取它们的信息。 您可以检索所有共享,绑定和安装目标的信息,或者仅检索特定资源的信息。
在控制台中查看文件共享、共享绑定和挂载目标
在控制台中查看所有文件共享
-
在 IBM Cloud 控制台,单击 导航菜单 图标
> 基础架构
> 存储 > 文件共享。
-
“VPC 的文件共享”列表页面显示在该区域中创建的所有文件共享。 操作 菜单
选项用于管理文件共享。 下表描述了列表页面上的信息。
字段 | 值 |
---|---|
区域 | 文件共享的帐户区域。 选择其他区域以查看该区域中的区域的文件共享。 |
名称 | 文件共享名称。 它可以是原始文件共享或副本文件共享。 单击名称以查看有关该文件共享的详细信息。 |
状态 | 有关文件共享的状态列表,请参阅 文件共享生命周期状态。 |
资源组 | 字段显示文件共享所属资源组的名称。 |
地区 | 该字段显示文件共享所在的区域。 |
安装目标 | 与文件共享关联的安装目标数。 每个 VPC 每个文件共享只能有一个挂载目标。 |
快照 | 此字段显示文件共享的快照数量。 此栏默认为隐藏。 单击 |
大小 | 文件共享的大小 (以 GB 为单位)。 |
跨账户作用 | 此列中的值可以是 无、_原始共享_或 从属共享。 如果值为 无,则不会与其他账户或外部服务共享共享。 如果值为 源共享,则该共享与另一个账户或外部服务共享,并与另一个账户中的访问者共享绑定。 如果值为 Accessor share,则此共享与源共享绑定,目的是访问源共享的数据。 |
复制角色 | 源和副本文件共享之间的关系。 “副本”指示文件共享源共享 (已链接) 的副本。 “源”表示共享副本的源 (已链接)。 “无”表示文件共享不会与另一个共享进行复制。 |
复制状态 | 此栏默认为隐藏。 单击 |
加密类型 | 它显示文件共享 (提供者管理或客户管理) 的加密类型。 客户管理的加密 使用您自己的根密钥来保护数据。 UI 还标识密钥管理服务 (KMS) Key Protect 或 Hyper Protect Crypto Services。 |
您可以通过单击 来访问“操作”菜单。 “操作”菜单具有用于管理文件共享的选项,具体取决于其状态。 对于处于 稳定 状态的文件共享,您可以重命名该共享,编辑 IOPS,复制该共享的 CRN,创建副本或删除文件共享。 如果已设置对副本文件共享的复制,那么将禁用 删除 和 创建副本。
有关详细信息,请参阅 创建复制文件共享。
在控制台中查看文件共享的详细信息
-
转至所有文件共享的列表。 从 IBM Cloud 控制台,单击 导航菜单 图标
> 基础架构
> 存储 > 文件共享。
-
单击文件共享的名称以查看详细信息页面。 将显示文件共享的可编辑名称和状态。 如果您对文件共享应用了用户或访问管理标记,它们会列在状态旁边。 单击 添加标记 以将新的 标记 应用于共享。
-
详细信息页面有几个选项卡。 默认显示“概览”选项卡。
-
概述- 下表描述了文件共享的可用信息。
文件共享详细信息页面 字段 值 文件共享详细信息 名称 文件共享名称。 单击 编辑图标 <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 的安装目标的所有文件共享。
-
转至 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
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
replication_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: $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。
后续步骤
安装文件共享。 安装是一个过程,服务器的操作系统通过该过程使存储设备上的文件和目录可供用户通过服务器的文件系统进行访问。 有关更多信息,请参阅以下主题:
- IBM Cloud File Share Mount Helper 实用程序
- 在 Red Hat Linux 上安装文件共享。
- 在 CentOS中安装文件共享。
- 在 Ubuntu 上安装文件共享。
- 在 z/OS上安装文件共享
管理文件共享和数据。
- 管理文件共享。 您可以重命名文件共享。 您可以增加其容量并修改其 IOPS。 可以将安装目标添加到文件共享。 您可以重命名或删除安装目标。 当您不再需要文件共享时,可以将其删除。
- 创建与复制的文件共享。 通过复制功能,您可以将文件共享的只读副本保留在另一个区域中。 将根据您指定的调度从源共享更新副本共享。 当数据变为不可访问或应用程序发生故障时,复制提供了一种从主站点上的事件恢复的方法。 复制还可用于地理扩展。