In der Konsole

Kunden mit besonderem Zugang können Block Storage Volumes mit dem Profil sdp erstellen.

Als zugelassener Kunde können Sie eine Liste aller verfügbaren Profile sehen, wie z. B. die drei Profile tiered, custom und das neue Profil sdp. 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

$ 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 der 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

Das folgende Beispiel zeigt die Details des Profils sdp, wenn Sie den Befehl export IBMCLOUD_IS_FEATURE_VOLUME_ADJUSTABLE_CAPACITY_IOPS_STATES=true verwenden. Wenn dieses Funktionskennzeichen auf true gesetzt ist, werden die Eigenschaften Adjustable Capacity State und Adjustable IOPS State in der CLI-Antwort angezeigt.

$ 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: $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: $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.