在控制台中

拥有特殊访问权限的客户可以使用 sdp 配置文件创建 Block Storage 卷。

作为允许列表客户，您可以看到所有可用配置文件的列表，如三个 tiered、custom 和新的 sdp 配置文件。 选择分层配置文件时，需要指定容量。 选择自定义配置文件时，需要指定容量和在容量适用范围内的 IOPS 值 （表 3 ）。 选择 sdp 配置文件时，可以指定容量和 IOPS，而不受任何基于容量范围的限制。 您还可以指定加密卷的最大吞吐量限制。

通过 CLI

要使用 CLI 来查看可用概要文件的列表，请运行以下命令：

ibmcloud is volume-profiles

$ ibmcloud is volume-profiles
Listing volume profiles in region us-east under account TEST as user test.user@ibm.com...
Name              Family                Bandwidth(Mbps) default value   Storage Generation
general-purpose   tiered                -                               1
5iops-tier        tiered                -                               1
10iops-tier       tiered                -                               1
sdp               defined_performance   1000                            2
custom            custom                -                               1

要查看概要文件的详细信息，请运行带有您希望查看的概要文件名称的 ibmcloud is volume-profile 命令。

以下示例显示了 10iops-tier 的详细信息。

$ ibmcloud is volume-profile 10iops-tier
Getting volume profile 10iops-tier under account Test Account as user test.user@ibm.com...

Name                                   10iops-tier   
Family                                 tiered   
Adjustable IOPS                        false   
Boot capacity                          Max   Min      
                                       250   10      

Capacity                               Max    Min   Default   Step      
                                       4800   10    10        1      

IOPS                                   Max    Min   Default   Step      
                                       48000  10    10        1     
Storage Generation                     1

下面的示例显示了使用 export IBMCLOUD_IS_FEATURE_VOLUME_ADJUSTABLE_CAPACITY_IOPS_STATES=true 命令时 sdp 配置文件的详细信息。 当此功能标志设置为 true 时，属性 Adjustable Capacity State 和 Adjustable IOPS State 将显示在 CLI 响应中。

$ ibmcloud is volume-profile sdp
Getting volume profile sdp under account Test Account as user test.user@ibm.com...

Name                                   sdp   
Family                                 defined_performance   
Adjustable IOPS                        true
Boot capacity                          Max     Min
                                       32000   1

Capacity                               Max     Min   Default   Step
                                       32000   1     -         1

IOPS                                   Max     Min    Default   Step
                                       64000   3000   3000      1

Bandwidth(Mbps)                        Max    Min    Default   Step   Value
                                       8192   1000   1000      1      -

Storage Generation                     2
Adjustable Bandwidth Supported         true
Adjustable Capacity States             attached, unattached
Adjustable IOPS State                  attached, unattached

有关可用命令选项的更多信息，请参阅 ibmcloud is volume-profile。

使用 API

要查看可用概要文件，请发出 GET /volume/profiles 请求。

curl -X GET \
$vpc_api_endpoint/v1/volume/profiles?$api_version&generation=2 \
-H "Authorization: $iam_token"

对于大多数账户，API 响应的字段为 name, href, family。对于具有预览已定义性能配置文件的特殊访问权限的账户，响应会增强以包括以下字段：

• boot_capacity 表示每个配置文件允许启动卷使用的容量值。 返回值是一个范围，包含为每个配置文件指定的最小值和最大值。
  • 对于 custom 和 tiered 配置文件，范围为 10 GB - 250 GB。
  • sdp 配置文件的范围为 10 GB - 250 GB。
• capacity 表示每个配置文件允许的数据卷容量值。 返回值是一个范围，包含为每个配置文件指定的最小值和最大值。
  • 对于 custom 和 tiered 配置文件，范围为 10 GB - 16 TB。
  • sdp 配置文件的范围为 1 GB - 32 TB。
• iops 该字段表示每个配置文件下可实现的 IOPS。
  • 对于 tiered 配置文件，该值是固定的：3 IOPS/GB、5 IOPS/GB 和 10 IOPS/GB。
  • 对于 custom 配置文件，该值范围为 1 - 48,000。
  • 对于 sdp 配置文件，该值范围为 1 - 64,000。
• family 枚举现在多了一个值，以及目前存在的 和 值。defined_performance tiered custom
• adjustable_capacity_states 表示卷未连接到运行中的虚拟服务器实例时，是否可以更改卷的容量。 该字段仅提供信息。 它描述了音量曲线的特征，不能更改。
  • 对于 custom 和 tiered 配置文件，该值为 attached。
  • 对于 sdp 配置文件，该值为 attached, unattached。
• adjustable_iops_states 表示卷未连接到运行中的虚拟服务器实例时，是否可以更改卷的 IOPS。 该字段仅提供信息。 它描述了音量曲线的特征，不能更改。
  • 对于 custom 配置文件，该值为 attached。
  • 对于 tiered 配置文件，该值为空，因为任何状态下都不支持更改 IOPS。 如果您想更改卷的 IOPS 值，可以切换到另一个 tiered 配置文件。
  • 对于 sdp 配置文件，该值为 attached, unattached。
• adjustable_bandwidth_supported 表示是否可以调整已配置的带宽限制。
  • 对于 custom 和 tiered 个人资料，该值为 false。
  • 对于 sdp 配置文件，该值为 true。
• storage_generation 表示剖面族属于哪一代。
  • 对于 custom 和 tiered 个人资料，该值为 1。
  • 对于 sdp 配置文件，该值为 2。

新的个人资料被列为 sdp。 要查看该资料的详细信息，请申请 GET /volume/profiles/sdp。

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/sdp?version=2024-09-24&generation=2"\
 -H "Authorization: $iam_token"

成功回复的示例如下

{
    "boot_capacity": {
        "max": 32000,
        "min": 1,
        "type": "dependent_range"
    },
    "capacity": {
        "default": 1,
        "max": 32000,
        "min": 1,
        "step": 1,
        "type": "range"
    },
    "family": "defined_performance",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/sdp",
    "iops": {
        "default": 100,
        "max": 64000,
        "min": 100,
        "step": 1,
        "type": "range"
    },
    "name": "sdp",
    "adjustable_capacity_states": {
        "type": "fixed",
        "value": "attached, unattached"
    },
    "adjustable_iops_states": {
        "type": "fixed",
        "value": "attached, unattached"
    },
    "adjustable_bandwidth_supported": true,
    "max_throughput": 8192,
    "max_bandwidth_mbps": 8192,
    "min_bandwidth_mbps": 1000,
    "default_bandwidth_mbps": 1000,
    "storage_generation": 2
}

有关此方法的更多信息，请参阅 列出所有卷概要文件 和 检索卷概要文件 的 API 参考。

使用 Terraform

1. 要使用 Terraform，请下载 Terraform CLI 并配置 IBM Cloud® 提供者插件。 有关更多信息，请参阅 Terraform 入门。

2. VPC 基础架构服务使用特定区域端点，缺省情况下该端点以 us-south 为目标。 如果在另一个区域中创建了 VPC，请确保将 provider.tf 文件中的提供程序块中的相应区域作为目标。 请参阅以下以非缺省 us-south 的区域为目标的示例。

   provider "ibm" {
      region = "eu-de"
   }
   

3. 将可用卷概要文件的列表作为只读数据源导入。

   data "ibm_is_volume_profiles" "example" {
   }
   

   有关更多信息，请参阅 ibm_is_volume_profile。