在控制台中

在區塊儲存配置頁面上，您可以看到建立區塊儲存頁面中所有可用設定檔的清單，例如 sdp 設定檔，三個 tiered，以及 custom 設定檔。 當您選擇其中一個分層設定檔時，您需要指定容量。 選擇自訂設定檔時，您需要指定容量和 IOPS 值，該值應在您容量的適用範圍內 （表 3 ）。 當您選擇 sdp 設定檔時，您可以指定容量和 IOPS，而不受任何以容量為基礎的範圍限制。 您也可以指定卷的最大吞吐量限制。

從 CLI

若要使用 CLI 檢視可用設定檔的清單，請執行下列指令：

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 指令。 以下範例顯示 sdp 設定檔的詳細資訊。

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