调整分区文件共享的 IOPS

在不中断服务的情况下，将采用 dp2 配置文件的区域文件共享的每秒输入/输出操作次数（IOPS）限制从100调整为96,000 IOPS。

更改立即生效，且不会造成服务中断。您可以通过控制台、CLI、API 或 Terraform 管理 IOPS 限制。

将自动更新已更新的共享的计费。新价格的分摊差额将添加到当前计费周期。在下一个计费周期中将采用新的完整金额记帐。

选择可用性您不能修改使用 rfs 配置文件创建的区域文件共享的 IOPS 值。不过，您可以调整带宽值来微调共享的性能。

可调 IOPS 概念

您可以调整分区文件共享的 IOPS，调整性能以满足您的要求。

例如，您可能会发现某个应用程序的扩展导致当前的 IOPS 限制成为性能瓶颈。您可以通过提高 IOPS 来改变现有文件共享的性能特征。
在另一种情况下，您可能希望将文件存储设置为较高的 IOPS 水平，以加快数据上传。上载完成后，可以将存储器重置为 5 IOPS/GB 以进行正常操作。此外，您可能希望在应用程序的高峰时段增加文件共享的 IOPS，并在非高峰时段减少 IOPS。

当共享使用 dp2 配置文件时，共享 IOPS 在 100 到 96,000 之间。您可以指定 IOPS 值，限制极少。 IOPS 可以多次调整，直到达到最大或最小限制。

要实现 96,000 IOPS，单个文件共享必须由多个虚拟服务器实例访问。一个客户端访问的单个文件共享的 IOPS 限制为 48,000 IOPS。

当文件共享使用已废弃的自定义共享配置文件时，IOPS 范围基于文件共享大小。

例如，对于 25 GB 的文件共享，您可以使用定制概要文件在 100 到 1,000 IOPS 范围内的任何位置增加 IOPS。如果以后将文件共享的大小增加到下一个最高级别，则可以再次增加 IOPS。 IOPS 可以多次调整，直到达到最大或最小限制。
也可以从自定义配置文件切换到 IOPS 层配置文件或 dp2 配置文件。 IOPS 层的选择受文件共享大小的限制。从自定义配置文件转到任何分层配置文件时，计费都会更新，IOPS 也会根据配置文件进行调整。

当文件共享使用已废弃的分层共享配置文件之一时，您可以通过以下方式调整 IOPS 限制：

从 IOPS 层配置文件切换到 dp2 或 custom 配置文件。在这种情况下，文件共享大小会限制您选择的 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，或者选择允许提高性能的下一个概要文件。

3 IOPS/GB 层概要文件的文件共享的最大 IOPS 为 96,000 IOPS。所有其他概要文件的上限为 48,000 IOPS。要实现 96,000 IOPS，必须由多个虚拟服务器实例访问单个文件共享。一个实例访问的单个文件共享限制为 48,000 IOPS。

要调整文件共享的 IOPS，该文件共享必须处于稳定状态。在调整 IOPS 之前，将验证您的用户权限。

您可以从 UI 或 CLI 监视文件共享的 IOPS 更改进度。您还可以检查活动跟踪事件，以验证 IOPS 是否已调整。

限制

以下限制适用。

要调整 IOPS，文件共享必须处于稳定状态。
dp2 概要文件可以扩展至 dp2 频带所允许的最大值。您无法切换dp2IOPS 频段，除非您增加文件共享大小，然后移动到更高的频段。
对于使用 IOPS 层概要文件创建的文件共享，要增加或减少 IOPS，请为文件共享大小选择其他概要文件。如果文件共享大小超过新的 IOPS 层概要文件的大小，那么无法更改该概要文件。
定制 IOPS 概要文件可以扩展至定制频带所允许的最大值。除非增大文件共享大小，然后移至更高的频带，否则无法切换定制频带。
通过在概要文件之间移动来调整 IOPS 受到文件共享大小的限制。
所有概要文件的文件共享的最大 IOPS 为 96,000 IOPS。要实现 96,000 IOPS，必须由多个虚拟服务器实例访问单个文件共享。实例中的单个文件共享限制为 48,000 IOPS。

在控制台中调整 IOPS

遵循以下步骤通过选择新的 IOPS 层或定制 IOPS 频带来调整 IOPS:

转至文件共享列表。在 IBM Cloud 控制台中，单击导航菜单图标 > 基础架构 > 存储 > 文件存储共享。默认情况下，文件共享会显示在您所在区域的所有资源组中。
在 VPC 的文件共享 列表页面中，单击文件共享的名称以查看其详细信息。
在“文件共享详细信息”页面上，找到 概要文件，然后单击 编辑图标 或使用操作菜单并选择 编辑 IOPS 概要文件。必须将卷连接到虚拟服务器实例，才能执行这些操作。
在侧面板中，调整 IOPS 如下:
- 对于 dp2 或自定义配置文件，将显示当前 IOPS 值和文件共享大小。请在该大小的允许范围内输入新的 IOPS 值。
- 对于 IOPS 层，请从菜单中选择其他层。例如，您可能具有要添加到 5 IOPS/GB 概要文件的 3 IOPS/GB 通用概要文件。
查看地理位置和新定价的每月估算订单摘要。
如果满意，请单击 保存并继续。当您重新启动实例时，将实现新的 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
Source snapshot              -

使用 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
Source snapshot              -
Allowed Access Protocols     nfs4
Availability Mode            zonal
Bandwidth(Mbps)              1
Storage Generation           1

有关命令选项的更多信息，请参阅 ibmcloud is share-update my-file-share。

通过指定不同的 IOPS 层概要文件来调整 IOPS

这些说明适用于在分区文件共享测试版中使用的上一代文件共享配置文件（通用、5-iops、10-iops 或自定义）。自 2026 年 5 月 6 日起，这些共享配置文件将不再使用。要访问最新功能，必须将共享的 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 Test Account 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
Source snapshot              -

有关命令选项的更多信息，请参阅 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: Bearer $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

发出 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: Bearer $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。

后续步骤

创建更多文件共享或管理现有共享: