IBM Cloud Docs
调整文件共享 IOPS

调整文件共享 IOPS

对于 File Storage for VPC 文件共享,可以增加或减少 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:

  1. 转至文件共享列表。 在 IBM Cloud 控制台中,单击 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 存储 > 文件共享。 默认情况下,文件共享会显示所在区域的所有资源组。

  2. VPC 的文件共享 列表页面中,单击文件共享的名称以查看其详细信息。

  3. 在“文件共享详细信息”页面上,找到 概要文件,然后单击 编辑图标 "编辑" 图标 或使用 操作 菜单并选择 编辑 IOPS 概要文件。 必须将卷连接到虚拟服务器实例,才能执行这些操作。

  4. 在侧面板中,调整 IOPS 如下:

    • 对于 IOPS 层,请从菜单中选择其他层。 例如,您可能具有要添加到 5 IOPS/GB 概要文件的 3 IOPS/GB 通用概要文件。

    • 对于定制 IOPS 或 dp2 概要文件,将显示当前 IOPS 值和文件共享大小。 请在该大小的允许范围内输入新的 IOPS 值。

  5. 查看地理位置和新定价的每月估算订单摘要。

  6. 如果满意,请单击 保存并继续。 当您重新启动实例时,将实现新的 IOPS 分配。

从 CLI 调整 IOPS

调整定制或 dp2 概要文件的 IOPS

在 CLI 中,将 share-update 命令与 --iops 属性配合使用,以指示定制或 dp2 概要文件的新 IOPS 大小。 您指定的 IOPS 必须在文件共享大小的范围内。 更多信息,请参阅 dp2自定义 IOPS 配置文件

在使用 CLI 之前,您必须安装 IBM Cloud CLI 和 VPC CLI 插件。 有关更多信息,请参阅 CLI 先决条件

  1. 通过使用 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
    
  2. 查看要使用 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                                            
    
  3. 使用 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

后续步骤

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