In der Konsole

Auf der Seite für die Bereitstellung von Blockspeicher sehen Sie eine Liste aller verfügbaren Profile auf der Seite für die Erstellung von Blockspeicher, z. B. das Profil sdp, die drei Profile tiered und das Profil custom. Wenn Sie eines der abgestuften Profile auswählen, müssen Sie die Kapazität angeben. Wenn Sie das benutzerdefinierte Profil auswählen, müssen Sie die Kapazität und einen IOPS-Wert angeben, der in dem für Ihre Kapazität geltenden Bereich liegt (Tabelle 3 ). Wenn Sie das Profil sdp auswählen, können Sie die Kapazität und die IOPS ohne kapazitätsbasierte Bereichsbegrenzung angeben. Sie können auch die maximale Durchsatzgrenze für Ihr Volume angeben.

Über die -Befehlszeilenschnittstelle

Führen Sie den folgenden Befehl aus, um die Liste der verfügbaren Profile über die Befehlszeilenschnittstelle anzuzeigen:

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

Um Details des Profils anzuzeigen, führen Sie den Befehl ibmcloud is volume-profile mit dem Namen des Profils aus, das Sie anzeigen möchten. Das folgende Beispiel zeigt die Details des Profils 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

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is volume-profile.

Mit der API

Um die verfügbaren Profile anzuzeigen, stellen Sie eine GET /volume/profiles-Anforderung.

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

Für die meisten Konten antwortet die API mit den Feldern name, href, family. Für Konten mit speziellem Zugriff auf die Vorschau des definierten Leistungsprofils wird die Antwort um die folgenden Felder erweitert:

• boot_capacity bezeichnet die Kapazitätswerte, die für Boot-Volumes für jedes Profil zulässig sind. Der zurückgegebene Wert ist ein Bereich mit Mindest- und Höchstwerten, die für jedes Profil angegeben werden.
  • Für die Profile custom und tiered beträgt der Bereich 10 GB - 250 GB.
  • Für das Profil sdp beträgt der Bereich 10 GB - 250 GB.
• capacity bezeichnet die Kapazitätswerte, die für Data-Volumes für jedes Profil zulässig sind. Der zurückgegebene Wert ist ein Bereich mit Mindest- und Höchstwerten, die für jedes Profil angegeben werden.
  • Für die Profile custom und tiered beträgt die Bandbreite 10 GB - 16 TB.
  • Für das Profil sdp reicht die Spanne von 1 GB bis 32 TB.
• iops gibt dieses Feld die erreichbaren IOPS für jedes Profil an.
  • Für die Profile tiered ist dieser Wert festgelegt: 3 IOPS/GB, 5 IOPS/GB und 10 IOPS/GB.
  • Für das Profil custom kann dieser Wert zwischen 1 und 48.000 liegen.
  • Für das Profil sdp kann dieser Wert zwischen 1 und 64.000 liegen.
• family enum hat jetzt einen zusätzlichen Wert,defined_performance, neben den bereits vorhandenen Werten tiered und custom.
• adjustable_capacity_states gibt an, ob die Kapazität für das Volume geändert werden kann, wenn das Volume nicht mit einer laufenden virtuellen Serverinstanz verbunden ist. Dieses Feld dient der Information. Sie beschreibt die Eigenschaften des Volumenprofils und kann nicht geändert werden.
  • Für custom und tiered Profile ist dieser Wert attached.
  • Für das Profil sdp lautet dieser Wert attached, unattached.
• adjustable_iops_states gibt an, ob die IOPS für das Volume geändert werden können, wenn das Volume nicht mit einer laufenden virtuellen Serverinstanz verbunden ist. Dieses Feld dient der Information. Sie beschreibt die Eigenschaften des Volumenprofils und kann nicht geändert werden.
  • Für die custom-Profile ist dieser Wert attached.
  • Für die tiered-Profile ist dieser Wert leer, da Änderungen der IOPS in keinem Zustand unterstützt werden. Wenn Sie den IOPS-Wert eines Volumes ändern möchten, können Sie zu einem anderen tiered Profil wechseln.
  • Für das Profil sdp lautet dieser Wert attached, unattached.
• adjustable_bandwidth_supported gibt an, ob die bereitgestellte Bandbreitenbegrenzung angepasst werden kann.
  • Für die Profile custom und tiered ist dieser Wert false.
  • Für das Profil sdp lautet dieser Wert true.
• storage_generation gibt an, zu welcher Generation die Profilfamilie gehört.
  • Für die Profile custom und tiered ist dieser Wert 1.
  • Für das Profil sdp lautet dieser Wert 2.

Das neue Profil wird als sdp geführt. Um Details zu diesem Profil zu sehen, stellen Sie eine Anfrage an 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"

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.

{
    "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
}

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für Auflisten aller Datenträgerprofile und Abrufen eines Datenträgerprofils.

Mit Terraform

1. Zur Verwendung von Terraform laden Sie die Terraform-CLI herunter und konfigurieren das IBM Cloud®-Provider-Plug-in. Weitere Informationen finden Sie unter Einführung in Terraform.

2. VPC-Infrastrukturservices verwenden einen bestimmten regionalen Endpunkt, der standardmäßig auf us-south ausgerichtet ist. Wenn Ihre VPC in einer anderen Region erstellt wird, stellen Sie sicher, dass Sie die entsprechende Region im Providerblock in der Datei provider.tf als Ziel angeben. Sehen Sie sich das folgende Beispiel für eine andere Region als die Standardregion us-south an.

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

3. Importieren Sie die Liste der verfügbaren Datenträgerprofile als schreibgeschützte Datenquelle.

   data "ibm_is_volume_profiles" "example" {
   }
   

   Weitere Informationen finden Sie unter ibm_is_volume_profile.