调整文件共享的 IOPS
对于分区文件共享，您可以增加或减少 IOPS，以满足您的性能需求。 通过指定不同的 IOPS 层配置文件（在所选配置文件内调整 IOPS）、自定义配置文件或 dp2 配置文件来调整 IOPS。 调整 IOPS 的过程不会导致中断或无法访问存储器。
将自动更新已更新的共享的计费。 新价格的分摊差额将添加到当前计费周期。 在下一个计费周期中将采用新的完整金额记帐。
可调 IOPS 概念
您可以调整分区文件共享的 IOPS，调整性能以满足您的要求。
例如，您可能会发现应用程序已缩放，使得较低层的存储器概要文件现在成为性能瓶颈。 您可以通过选择更高的 IOPS 层 (例如，3 IOPS/GB 层到 5 IOPS/GB 层) 来增加 IOPS，从而更改现有文件共享的性能特征。
在另一个方案中，您可能希望最初将文件存储器设置为更高的 10 IOPS/GB 性能级别，以加速数据上载。 上载完成后，可以将存储器重置为 5 IOPS/GB 以进行正常操作。 此外，您可能希望在应用程序的高峰时段增加文件共享的 IOPS，并在非高峰时段减少 IOPS。
通过使用此功能，您可以:
-
使用“dp2 或”自定义 IOPS 时调整 IOPS。 IOPS 范围基于文件共享大小。 例如，对于 25 GB 的文件共享，您可以使用定制概要文件在 100 到 1,000 IOPS 范围内的任何位置增加 IOPS。 如果稍后 增大文件共享的大小 到下一个最高频带，那么可以再次增大 IOPS。
-
将 IOPS 层配置文件中的 IOPS 调整为dp2或自定义配置文件。 在这种情况下，文件共享大小会限制您选择的 IOPS 范围。
- 例如，如果使用 3 IOPS/GB 配置文件调整文件共享的 IOPS，而文件的容量为 12,000 GB，则可以使用自定义或dp2配置文件调整 IOPS。 这是可能的，因为两者都支持 12000 GB 的共享大小。
- 如果文件共享大小超过 16,000 GB，自定义配置文件将不支持调整 IOPS，但dp2配置文件支持调整 IOPS，因为它支持最大 32,000 GB 的共享大小。 IOPS 层最大大小为 32,000 GB (对于 3 IOPS/GB)，9,600 GB (对于 5 IOPS/GB) 和 4,800 GB (对于 10 IOPS/GB)。
从分层配置文件移动到自定义或dp2配置文件时，计费将根据指定的 IOPS 更新。
-
通过选择其他 IOPS 层 来向上或向下调整 IOPS。 IOPS 在层内进行调整。 可增加 IOPS 的程度由文件共享的 IOPS 层概要文件 所允许的最大值确定。 您可以根据共享大小调整 IOPS 层的 IOPS，或者选择允许提高性能的下一个概要文件。
3 IOPS/GB 层概要文件的文件共享的最大 IOPS 为 96,000 IOPS。 所有其他概要文件的上限为 48,000 IOPS。 要实现 96,000 IOPS，必须由多个虚拟服务器实例访问单个文件共享。 一个实例访问的单个文件共享限制为 48,000 IOPS。
-
将 IOPS 从自定义配置文件调整为 IOPS 层配置文件。 同样，您只能通过文件共享大小来选择 IOPS 层概要文件。 从自定义配置文件转到任何分层配置文件时，计费都会更新，IOPS 也会根据配置文件进行调整。
要调整文件共享的 IOPS，该文件共享必须处于 稳定 状态。 在调整 IOPS 之前，将验证您的用户权限。
您可以使用 UI，CLI，API 或 Terraform 来调整 IOPS。 您可以将文件共享的 IOPS 多次调整到其最大限制，或者将 IOPS 降低到其最小限制。
您可以从 UI 或 CLI 监视文件共享的 IOPS 更改进度。 您还可以检查 活动跟踪事件，以验证 IOPS 是否已调整。
限制
以下限制适用。
- 要调整 IOPS，文件共享必须处于 稳定 状态。
- dp2 概要文件 可以扩展至 dp2 频带所允许的最大值。 您无法切换dp2IOPS 频段，除非您增加文件共享大小，然后移动到更高的频段。
- 对于使用 IOPS 层概要文件 创建的文件共享，要增加或减少 IOPS，请为文件共享大小选择其他概要文件。 如果文件共享大小超过新的 IOPS 层概要文件的大小，那么无法更改该概要文件。
- 定制 IOPS 概要文件 可以扩展至定制频带所允许的最大值。 除非增大文件共享大小，然后移至更高的频带，否则无法切换定制频带。
- 通过在概要文件之间移动来调整 IOPS 受到文件共享大小的限制。
- 使用定制或 dp2 概要文件时，可以多次调整 IOPS，直到达到最大或最小限制为止。
- 所有概要文件的文件共享的最大 IOPS 为 96,000 IOPS。 要实现 96,000 IOPS，必须由多个虚拟服务器实例访问单个文件共享。 实例中的单个文件共享限制为 48,000 IOPS。
在控制台中调整 IOPS
遵循以下步骤通过选择新的 IOPS 层或定制 IOPS 频带来调整 IOPS:
-
转至文件共享列表。 在 IBM Cloud 控制台中，单击 导航菜单 图标
> 基础架构 
存储 > 文件共享。
默认情况下，文件共享会显示所在区域的所有资源组。 -
在 VPC 的文件共享 列表页面中，单击文件共享的名称以查看其详细信息。
-
在“文件共享详细信息”页面上，找到 概要文件，然后单击 编辑图标
或使用 操作 菜单并选择 编辑 IOPS 概要文件。 必须将卷连接到虚拟服务器实例，才能执行这些操作。 -
在侧面板中，调整 IOPS 如下:
-
对于 IOPS 层，请从菜单中选择其他层。 例如，您可能具有要添加到 5 IOPS/GB 概要文件的 3 IOPS/GB 通用概要文件。
-
对于定制 IOPS 或 dp2 概要文件，将显示当前 IOPS 值和文件共享大小。 请在该大小的允许范围内输入新的 IOPS 值。
-
-
查看地理位置和新定价的每月估算订单摘要。
-
如果满意，请单击 保存并继续。 当您重新启动实例时，将实现新的 IOPS 分配。
从 CLI 调整 IOPS
调整定制或 dp2 概要文件的 IOPS
在 CLI 中，将 share-update 命令与 --iops 属性配合使用，以指示定制或 dp2 概要文件的新 IOPS 大小。 您指定的 IOPS 必须在文件共享大小的范围内。 更多信息，请参阅 dp2 或 自定义 IOPS 配置文件。
在使用 CLI 之前，您必须安装 IBM Cloud CLI 和 VPC CLI 插件。 有关更多信息，请参阅 CLI 先决条件。
-
通过使用
ibmcloud is shares命令列出区域中的文件共享，在 CLI 中找到您的共享。$ 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 r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516 my-replica-file-share stable us-south-1 dp2 1500 Default replica r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-file-share stable us-south-2 dp2 1500 Default source r006-6d1719da-f790-45cc-9f68-896fd5673a1a my-replica-share stable us-south-3 dp2 1500 Default replica r006-925214bc-ded5-4626-9d8e-bc4e2e579232 my-new-file-share stable us-south-2 dp2 500 Default none r006-b1707390-3825-41eb-a5bb-1161f77f8a58 my-vpc-file-share stable us-south-2 dp2 1000 Default none r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 my-file-share stable us-south-2 dp2 1500 Default source -
查看要使用
ibmcloud is share命令修改的文件共享的详细信息。$ ibmcloud is share my-file-share Getting file share my-file-share under account Test Account as user test.user@ibm.com... ID r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Name my-file-share CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Lifecycle state stable Access control mode security_group Accessor binding role none Zone us-south-2 Profile dp2 Size(GB) 1000 IOPS 1000 User Tags docs:test Encryption provider_managed Mount Targets ID Name r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61 my-cli-share-mount-target-1 Resource group ID Name db8e8d865a83e0aae03f25a492c5b39e Default Created 2023-10-18T22:15:15+00:00 Replication role none Replication status none Replication status reasons Status code Status message - - Snapshot count 0 Snapshot size 0 -
使用
ibmcloud is share-update命令来增加或减少文件共享的 IOPS。$ ibmcloud is share-update my-file-share --iops 2000 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-file-share CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-b696742a-92ee-4f6a-bfd7-921d6ddf8fa6 Lifecycle state updating Access control mode security_group Accessor binding role none Zone us-south-2 Profile dp2 Size(GB) 1000 IOPS 2000 User Tags docs:test Encryption provider_managed Mount Targets ID Name r006-dd497561-c7c9-4dfb-af0a-c84eeee78b61 my-cli-share-mount-target-1 Resource group ID Name db8e8d865a83e0aae03f25a492c5b39e Default Created 2023-10-18T22:15:15+00:00 Replication role none Replication status none Replication status reasons Status code Status message - - Snapshot count 0 Snapshot size 0
有关命令选项的更多信息，请参阅 ibmcloud is share-update my-file-share。
通过指定不同的 IOPS 层概要文件来调整 IOPS
这些指示信息适用于上一代文件共享概要文件 (通用，5-iops，10-iops 或 custom)。 只能使用 dp2 概要文件供应新文件共享。 要访问最新功能部件，必须将共享的 IOPS 概要文件更改为 dp2。
在 CLI 中，将 ibmcloud is share-update 命令与 --profile 属性配合使用，并指示 IOPS 层概要文件的名称或 href。
以下示例将 3 IOPS/GB 概要文件更改为 5 IOPS/GB 概要文件。 在这种情况下，文件共享不能超过 9,600 GB 以移至更高的概要文件。
ibmcloud is share-update my-file-share --profile tier-5iops
Updating file share my-file-share under account VPC1 as user user@mycompany.com...
ID ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Name my-file-share
CRN crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:ba7c7c8a-c111-4f54-a7fe-bb6d3d66eb2a
Lifecycle state updating
Access control mode security_group
Accessor binding role none
Zone us-south-1
Profile tier-5iops
Size(GB) 100
IOPS 3000
User Tags docs:test
Encryption provider_managed
Mount targets ID Name VPC ID VPC Name
No mount targets found.
Resource group ID Name
7f1645c5-8afa-4a7e-860d-3df563e0aa8d Default
Created 2023-02-26T20:01:18+05:30
Snapshot count 0
Snapshot size 0
有关命令选项的更多信息，请参阅 ibmcloud is share-update my-file-share。
使用 API 调整 IOPS
您可以通过调用虚拟私有云 (VPC) 来调整现有数据文件共享的 IOPS API。
调整dp2或自定义配置文件的 IOPS
发出 PATCH /shares 请求并指定 iops 属性以在定制 pr dp2 概要文件的允许范围内调整 IOPS。
无法在同一 PATCH /shares 请求中更新文件共享的名称并调整 IOPS。 发出两个 PATCH /shares 请求。
以下示例显示了基于 100-499 定制概要文件的 100 GB 文件共享将 100 IOPS 增加到 3,000 IOPS。 此定制频带的 IOPS 范围为 100 到 6000 IOPS。 有关可用 IOPS 范围的更多信息，请参阅 文件存储配置文件概述。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-08-086&generation=2" \
-H "Authorization: $iam_token" \
-d '{
"iops": 3000
}'
调整 IOPS 时，文件共享状态显示 updating。 将显示当前 IOPS，直到您重新启动实例为止。 在下面的示例中，IOPS 值从 100 开始调整。
{
"created_at": "2023-08-08T22:58:49.000Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-a0c07083-f411-446c-9316-7b08d6448c86",
"id": "r006-a0c07083-f411-446c-9316-7b08d6448c86",
"iops": 100,
.
.
.
"status": "updating",
.
.
.
}
当 IOPS 扩展完成时，重新启动实例。 将显示新值，并且文件共享状态为 stable。
{
"created_at": "2023-08-08T22:58:49.000Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86",
"id": "a0c07083-f411-446c-9316-7b08d6448c86",
"iops": 3000,
"lifecycle_state": "stable",
"name": "my-share-updated",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-3iops",
"name": "custom",
"resource_type": "share_profile"
},
"access_control_mode": "security-group",
"allowed_transit_encryption_modes": ["none", "user-managed"],
"replication_role": "none",
"replication_status": "none",
"replication_status_reasons": [],
"resource_group": {
"crn": "crn:[...]",
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
"id": "678523bcbe2b4eada913d32640909956",
"name": "Default"
},
"resource_type": "share",
"size": 4800,
"mount_targets": [
{
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/a0c07083-f411-446c-9316-7b08d6448c86/mount_targets/1b5571cb-536d-48d0-8452-81c05c6f7b80",
"id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
"name": "my-mount-target",
"resource_type": "share_target",
"vpc": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/r006-12bb28fc-856d-4902-813b-dc065d1ed084",
"id": "12bb28fc-856d-4902-813b-dc065d1ed084",
"name": "my-vpc",
"resource_type": "vpc"
}
}
],
"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"
}
}
通过指定不同的 IOPS 层概要文件来调整 IOPS
这些指示信息适用于上一代文件共享概要文件 (通用，5-iops，10-iops 或 custom)。 只能使用 dp2 概要文件供应新文件共享。 要访问最新功能部件，必须将共享的 IOPS 概要文件更改为 dp2。
发出 PATCH /shares 请求并指定 profile 属性，并指示 IOPS 层概要文件的名称或 href。
以下示例将 3 IOPS/GB 概要文件更改为 5 IOPS/GB 概要文件。 在这种情况下，文件共享不能超过 9,600 GB 以移至更高的概要文件。
curl -X PATCH \
"$vpc_api_endpoint/v1/shares/$share_id?version=2023-07-18&generation=2" \
-H "Authorization: $iam_token" \
-d '{
"profile": "5iops-tier"
}'
使用 Terraform 调整 IOPS
您可以调整 Terraform 中现有数据文件共享的 IOPS。
调整定制或 dp2 概要文件的 IOPS
要修改文件共享的性能级别，请使用 ibm_is_share 资源并提供所需的 IOPS 值。 指定 IOPS 值时，请确保它在文件共享大小的性能范围内。 有关更多信息，请参阅 dp2 文件存储器概要文件。
应用时，以下示例将共享性能更新为 5000 IOPS。
resource "ibm_is_share" "example" {
name = "my-new-share"
size = 200
iops = 5000
profile = "dp2"
zone = "us-south-2"
}
有关自变量和属性的更多信息，请参阅 ibm_is_share。
通过指定不同的 IOPS 层概要文件来调整 IOPS
要使用 IOPS 层概要文件修改文件共享的性能级别，请使用 ibm_is_share 资源并指定另一 IOPS 层。 应用时，以下示例将共享性能更新为 5000 IOPS。
resource "ibm_is_share" "example" {
name = "my-share"
size = 220
profile = "tier-5iops"
zone = "us-south-2"
}
有关自变量和属性的更多信息，请参阅 ibm_is_share。
后续步骤
创建更多文件共享或管理现有共享: