管理文件共享,存取器共享绑定和安装目标
管理您创建的文件共享。 您可以重命名文件共享。 您可以增加其容量并修改其性能特征。 可以将安装目标添加到文件共享,并使用安装路径从虚拟服务器实例安装文件共享。 您可以重命名或删除安装目标。 或者,如果不再需要文件共享,那么可以将其删除。
File Storage for VPC 服务需要 IAM 许可权以进行基于角色的访问控制。 例如,要创建文件共享,您至少需要具有编辑者许可权。 有关详细信息,请参阅 为文件共享管理 VPC 基础架构服务的 IAM 访问。
在控制台中管理文件共享、访问器共享绑定和挂载目标
在控制台中,您可以:
- 重命名文件共享。
- 重命名文件共享的安装目标。
- 更新文件共享概要文件 (不适用于存取器共享)。
- 更新允许的传输加密方式 (不适用于存取器共享)。
- 提高文件共享容量
- 调整分区文件共享的 IOPS
- 将用户标记添加到文件共享。
- 删除文件共享的安装目标。
- 删除文件共享。
在控制台中,您可以管理正常文件共享和存取器共享。 只有共享所有者才能修改诸如访问控制方式,IOPS 和概要文件之类的属性。 存取器帐户无法编辑源共享,并且可以修改存取器共享的一组较小的属性。
只有将安全组作为访问控制模式的共享才支持快照。 除非删除共享的所有快照,否则无法将访问控制模式更改为 VPC。
在控制台中重命名文件共享的挂载目标
- 转至 文件共享详细信息 页面。
- 单击“操作”图标
。
- 选择 重命名。
- 输入新名称,然后单击“重命名”。
有效的挂载目标名称可包括小写字母数字字符(a-z,0-9)和连字符(-)的组合,最多 63 个字符。 安装目标名称必须以小写字母开头。
在控制台中更新文件共享配置文件
这些指示信息适用于上一代文件共享概要文件 (通用,5-iops,10-iops 或 custom)。 要访问当前功能,必须将共享的 IOPS 配置文件更改为 dp2。 使用 dp2
配置文件创建的文件共享的配置文件无法更改。
您可以将文件共享的概要文件从当前概要文件更改为另一个 IOPS 层 概要文件,更改为 定制 概要文件或更改为高性能 dp2 概要文件。 您的账单会根据您选择的配置文件进行调整。
- 转至 文件共享详细信息 页面。
- 单击当前概要文件旁边的 编辑图标
,或者使用 操作 菜单
并选择 编辑 IOPS 概要文件。 侧面板显示当前概要文件,文件共享大小和最大 IOPS。
- 对于 新建概要文件,单击向下箭头。 您可以选择新的 IOPS 层,定制概要文件或 dp2。 对于 定制 IOPS 或 dp2,请根据文件共享大小指定新的最大 IOPS。 根据您的选择自动计算文件股价。
- 单击保存并继续。
更新控制台中允许的传输加密模式
共享的所有者可以更改允许的传输加密模式。 但是,必须先删除所有绑定,然后才能更改此属性。 删除绑定将切断源文件共享和存取器共享之间的网络路径,并使连接到存取器共享的安装目标处于失败状态。 有关更多信息,请参阅 从其他帐户除去对文件共享的访问权。
- 从 文件共享列表 中选择文件共享。
- 在“文件共享详细信息”页面上,找到允许的传输加密方式。
- 单击 编辑图标
以更改当前值。
从 CLI 管理文件共享,存取器共享绑定和安装目标
通过使用 CLI,您可以:
- 重命名文件共享。
- 重命名文件共享的安装目标。
- 更新文件共享概要文件 (不适用于存取器共享)。
- 更新允许的传输加密方式 (不适用于存取器共享)。
- 提高文件共享容量
- 调整分区文件共享的 IOPS
- 将用户标记添加到文件共享。
- 删除文件共享的安装目标。
- 删除文件共享。
只有将安全组作为访问控制模式的共享才支持快照。 除非删除共享的所有快照,否则无法将访问控制模式更改为 VPC。
从 CLI 重命名文件共享的安装目标
-
使用
ibmcloud is shares
命令列出区域中的文件共享。 记下具有要重命名的安装目标的文件共享的名称和标识。 -
通过
ibmcloud is share-mount-targets
命令使用共享的名称或标识来查找其安装目标。$ ibmcloud is share-mount-targets r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 Listing share mount target of r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 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
-
要重命名安装目标,请运行带有文件共享名称或标识以及安装目标名称的
share-mount-target-update
命令。 使用--name
选项指定新的安装目标名称。ibmcloud is share-mount-target-update r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03 r006-fdbffc45-618c-49f1-bb08-ec530d7be378 --name my-renamed-mount-target
有效的挂载目标名称可包括小写字母数字字符(a-z,0-9)和连字符(-)的组合,最多 63 个字符。 安装目标名称必须以小写字母开头。
有关命令选项的更多信息,请参阅 ibmcloud is share-mount-target-update
。
在 CLI 中更新文件共享概要文件
这些指示信息适用于上一代文件共享概要文件 (通用,5-iops,10-iops 或 custom)。 要访问当前功能,必须将共享的 IOPS 配置文件更改为 dp2。 使用 dp2
配置文件创建的文件共享的配置文件无法更改。
-
通过使用
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 r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f my-old-file-share stable us-south-1 tier-3iops 40 defaults none - - -
-
将
share-update
命令与--profile
参数配合使用,以按名称指示新的文件共享概要文件。$ ibmcloud is share-update my-old-file-share --profile dp2 --size 1000 --iops 3000 Updating file share my-file-share-8 under account Test Account as user test.user@ibm.com... ID r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f Name my-old-file-share CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-cc7ab6a0-bb71-4e03-8ef7-dcffca43717f Lifecycle state updating Access control mode vpc Zone us-south-1 Profile dp2 Size(GB) 1000 IOPS 3000 User Tags env:dev,env:prod Encryption provider_managed Mount Targets ID Name r006-c9d82a15-7ead-4388-abc8-88e81c12ed28 my-target121 Resource group ID Name 6edefe513d934fdd872e78ee6a8e73ef defaults Created 2023-03-27T20:43:36+00:00 Replication role none Replication status none Replication status reasons Status code Status message - - Snapshot count 0 Snapshot size 0 Source snapshot -
有关命令选项的更多信息,请参阅 ibmcloud is share-update
。
通过 CLI 更新允许的传输加密模式
共享所有者可将允许的传输加密模式类型更改为“user_managed,none
、user_managed
或”none
。
但是,在更改此属性之前,必须删除所有绑定和挂载目标。 删除绑定将切断源文件共享和存取器共享之间的网络路径,并使连接到存取器共享的安装目标处于失败状态。 有关更多信息,请参阅 从其他账户删除对文件共享的访问权限。
$ ibmcloud is share-update my-origin-share --allowed-transit-encryption-modes user_managed
Updating file share my-file-share under account Test Account as user test.user@ibm.com...
ID r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Name my-origin-share
CRN crn:v1:bluemix:public:is:us-south-2:a/1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6
Lifecycle state stable
Access control mode security_group
Accessor binding role origin
Allowed transit encryption modes user_managed
Origin share CRN Name Remote account Remote region
crn:v1:bluemix:public:is:us-south-2:a/7654321::share:r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed my-origin-share a7654321 -
Zone us-south-2
Profile dp2
Size(GB) 1000
IOPS 1000
Encryption provider_managed
Mount Targets ID Name
No mounted targets found.
Resource group ID Name
db8e8d865a83e0aae03f25a492c5b39e Default
Created 2024-06-25T22:15:15+00:00
Replication role none
Replication status none
Replication status reasons Status code Status message
- -
使用 API 管理文件共享,存取器共享绑定和安装目标
通过使用 API,您可以:
- 重命名文件共享。
- 重命名文件共享的安装目标。
- 更新文件共享概要文件 (不适用于存取器共享)。
- 使用 API 更新允许的传输加密方式 (不适用于存取器共享)。
- 提高文件共享容量
- 调整分区文件共享的 IOPS
- 将用户标记添加到文件共享。
- 删除文件共享的安装目标。
- 删除文件共享。
要查看有关 File Storage for VPC API 方法的信息,请参阅 API 参考 中的以下部分。
只有将安全组作为访问控制模式的共享才支持快照。 除非删除共享的所有快照,否则无法将访问控制模式更改为 VPC。
使用 API 重命名文件共享的安装目标
发出 PATCH /shares/$share_id/mount_targets/$target_id
调用以重命名文件共享的安装目标。 请参阅以下示例。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$target_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}" \
-d '{"name": "target-renamed1"}
成功回复的示例如下
{
"access_control_mode": "vpc",
"created_at": "2023-07-18T23:31:59Z",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/0995b8c6-c323-4e59-9ea9-fa14dd66bba8/mount_targets/9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"id": "9fdf4438-f5b4-4b6f-8bca-602494fd6c31",
"lifecycle_state": "stable",
"mount_path": "domain.com:/vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
"name": "target-renamed1",
"resource_type": "share_target",
"transit_encryption": "none",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs8c95b3c1-fe3c-45c-97a6-e43d14088287",
"id": "82a7b841-9586-43b4-85dc-c0ab5e8b1c7a",
"name": "vpc-name1",
"resource_type": "vpc"
}
}
有效的挂载目标名称可包括小写字母数字字符(a-z,0-9)和连字符(-)的组合,最多 63 个字符。 安装目标名称必须以小写字母开头。
使用 API 更新文件共享概要文件
这些指示信息适用于上一代文件共享概要文件 (通用,5-iops,10-iops 或 custom)。 要访问当前功能,必须将共享的 IOPS 配置文件更改为 dp2。 使用 dp2
配置文件创建的文件共享的配置文件无法更改。
发出 PATCH /shares/{share_ID}
调用并在 profile
属性中指定概要文件名称。 以下示例将概要文件更改为 dp2
概要文件。
curl -X PATCH "$vpc_api_endpoint/v1/shares/432f1a4d-4aac-4ba1-922c-76fdbcbeb1e3?version=2023-08-08&generation=2"\
-H "Authorization: $iam_token"\
-d '{"profile": {"name": "dp2"}}'
使用 API 更新允许的传输加密方式
共享所有者可将允许的传输加密模式类型更改为“user_managed,none
、user_managed
或”none
。
不过,在更改该属性之前,必须先删除所有绑定和挂载目标。 删除绑定将切断源文件共享和存取器共享之间的网络路径,并使连接到存取器共享的安装目标处于失败状态。 有关更多信息,请参阅 从其他帐户除去对文件共享的访问权。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-08&generation=2"\
-H "Authorization: Bearer ${API_TOKEN}"
-d '{"allowed_transit_encryption_modes": "user-managed"}'
使用 Terraform 管理文件共享,存取器共享绑定和安装目标
通过 Terraform,您可以:
使用 Terraform 更新安装目标的属性
更新 is_share_target
资源以更改安装目标的名称。 应用后,以下资源会将安装目标的名称更改为 my-new-share-target
。
resource "is_share_target" "is_share_target" {
share = is_share.is_share.id
subnet = ibm_is_subnet.example.id
name = "my-new-share-target"
}`
有关自变量和属性的更多信息,请参阅 ibm_is_share_target。
从其他帐户除去对文件共享的访问权
撤销对文件共享的访问权是一个 2 步骤的过程。
-
除去帐户之间的 IAM 授权。 除去 IAM 授权会阻止其他帐户或服务创建存取器共享和安装目标。
-
删除将源共享与存取器共享连接的共享绑定。 此操作会导致其他帐户的安装目标进入
failed
状态。
在虚拟服务器实例上安装和卸装文件共享
安装是一个过程,服务器的操作系统通过该过程使存储设备上的文件和目录可供用户通过服务器的文件系统进行访问。 要将文件共享安装到虚拟服务器实例,请 找到安装路径信息。 安装路径是在您为文件共享创建安装目标时创建的。 请参阅以下信息以在几个 Linux 操作系统上进行安装。 其他 Linux 发行版遵循类似的过程。
- 在 Red Hat Linux 上安装文件共享。
- 在 CentOS中安装文件共享。
- 在 Ubuntu 上安装文件共享。
- 在 z/OS上安装文件共享
监控文件共享
您可以使用控制台、CLI 或 API 检查文件共享的状态和健康状态。 您可以在 IBM Cloud 控制台中随时监控共享的总吞吐量、总 IOPS、挂载目标数量和容量使用情况。 您可以使用 IBM Cloud® Activity Tracker Event Routing 配置如何路由文件共享的审计事件。 您还可以配置 IBM Cloud Logs Routing 来处理日志。 有关详细信息,请参阅 监控文件共享运行状态、生命周期状态和事件。
文件共享可与 IBM Cloud® Monitoring 集成,以获得共享性能和健康状况的运行可见性。 在 Sysdig Web UI 中,您可以更详细地查看吞吐量、IOPS 和容量指标,自定义仪表盘,并设置警报。 有关详细信息,请参阅 Monitoring metrics for File Storage for VPC。
删除文件共享、访问器共享绑定和挂载目标
删除文件共享前,请确保已从所有虚拟服务器实例中 卸载 该共享,并删除属于该文件共享的所有挂载目标。 如果您的文件共享与其他帐户共享,请先删除存取器绑定,然后再删除该共享。 此外,如果文件共享具有副本文件共享,那么必须除去复制关系。 有关更多信息,请参阅 在控制台中移除复制关系从 CLI 移除复制关系使用 API 移除复制关系使用 Terraform 移除复制关系。