Anzeigen von Informationen über alle Block Storage for VPC Volumes in der Konsole

Rufen Sie die Liste der Block Storage for VPC-Datenträger auf. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation > Infrastruktur > Speicher > Block Storage Volumen.

Standardmäßig werden Block Storage for VPC-Volumes in 10er-Sätzen für alle Ressourcengruppen in Ihrer Region angezeigt. Ändern Sie diese Voreinstellung, indem Sie auf den Abwärtspfeil der Seitensteuerung klicken und die Liste auf 20 oder 50 Bände erweitern. Verwenden Sie die Pfeile der Seitensteuerung, um zur nächsten Seite zu gelangen oder zurückzukehren. In der Liste aller Block Storage for VPC-Datenträger sehen Sie die folgenden Informationen.

Details zu allen Bänden

Feld	Beschreibung
Bereich	Die Region, in der sich diese Datenträger befinden, z. B. "US South". Klicken Sie auf den Abwärtspfeil, um die Volumes in einer anderen Region anzuzeigen, in der Sie über ein Konto verfügen.
Name	Klicken Sie auf den Namen des Datenträgers, um die Details der einzelnen Datenträger anzuzeigen.
Status	Status des Datenträgers, der als Standardfilter für alle Zeilen fungiert.
Standort	Verfügbarkeitszone in Ihrer Region, die von der VPC-Instanz übernommen wurde (z. B. Vereinigte Staaten (Süden) 1).
Größe	Größe des von Ihnen angegebenen Datenträgers (in GB).
Zuordnungstyp	Daten für sekundären Datenträger, der einer Instanz zugeordnet ist. 'Boot' bei Zuordnung als Bootdatenträger oder ohne Angabe für einen nicht zugeordneten Datenträger.
Status	Der Zustandsmonitor überwacht den Gesamtzustand des Volumes, beispielsweise die E/A-Leistung und die Datenkonsistenz. Datenträgerstatus sind OK oder degraded. Datenträger mit verminderter Leistung weisen eine verminderte Leistung oder Kapazität auf oder haben Verbindungsprobleme. Datenträger, die aus einer Momentaufnahme zurückgeschrieben werden, zeigen auch einen verminderten Zustand an. Der Service zeigt eine mögliche Ursache für den herabgesetzten Status an, damit Sie alle Probleme beheben können. Weitere Informationen finden Sie unter Block Storage for VPC-Datenträgerstatus.
Verschlüsselung	Die Verschlüsselung mit von IBM verwalteten Schlüsseln ist standardmäßig für alle Datenträger aktiviert. Sie können auch Ihre eigenen Root-Schlüssel in einer Key Protect-Instanz verwenden, um Ihre Daten zu schützen. Weitere Informationen finden Sie unter Block Storage for VPC-Volumes mit vom Kunden verwalteter Verschlüsselung erstellen.
Tags	Anzahl der Benutzer-Tags, die dem Datenträger zugewiesen sind. Klicken Sie auf die Nummer in dieser Spalte, um die Tags in einem neuen Fenster anzuzeigen oder zu bearbeiten. Wenn dem Volume noch keine Tags zugewiesen wurden, klicken Sie auf Tags hinzufügen und fügen Sie diese im neuen Fenster hinzu. Benutzertags können den Datenträger einer Sicherungsrichtlinie zum Erstellen von Sicherungen des Datenträgers zuordnen. Weitere Informationen finden Sie unter Hinzufügen von Benutzer-Tags, die mit einer Backup-Richtlinie verbunden sind, zu einem Volume in der Konsole.
Aktionen	Klicken Sie auf Aktionen um ein Menü mit kontextspezifischen Aktionen anzuzeigen, die Sie ausführen können.

Über das Menü Aktionen () auf der Seite mit der Volume-Liste stehen die folgenden Aktionen zur Verfügung. Einige Aktionen sind nur verfügbar, wenn das Volume bestimmte Bedingungen erfüllt, z. B. wenn es zugeordnet oder nicht zugeordnet ist.

• Umbenennen – Benennen Sie diesen Datenträger um.
• An Server anhängen – ein nicht angehängtes Volume an eine virtuelle Serverinstanz anhängen. Diese Aktion ist nur verfügbar, wenn das Volume nicht zugeordnet ist. Weitere Informationen finden Sie im Abschnitt zum Zuordnen eines Datenträgers zu einer Instanz.
• Von der Instanz trennen – Trennen Sie ein zugeordnetes Volume von seiner virtuellen Serverinstanz. Diese Aktion ist nur verfügbar, wenn das Volume angeschlossen ist. Weitere Informationen finden Sie unter Ein Volume von einer virtuellen Serverinstanz trennen.
• Snapshot erstellen – Erstellen Sie einen Snapshot dieses Volumes. Diese Aktion ist möglicherweise ausgegraut, wenn sie nicht verfügbar ist. Weitere Informationen finden Sie unter Erstellen eines Snapshots in der Konsole.
• Image erstellen – Erstellen Sie ein benutzerdefiniertes Image aus einem Startvolume. Diese Aktion ist möglicherweise ausgegraut, wenn sie nicht verfügbar ist. Weitere Informationen finden Sie unter "Erstellen eines Images von einem Volume in der Konsole ".
• Tags hinzufügen oder bearbeiten – Fügen Sie Benutzer-Tags hinzu oder bearbeiten Sie diese und greifen Sie auf Verwaltungs-Tags in diesem Band zu. Weitere Informationen finden Sie im Abschnitt Mit Tags arbeiten.
• Löschen – diesen Band löschen. Diese Aktion ist ausgegraut, wenn das Volume an eine Instanz angehängt ist. Weitere Informationen finden Sie unter "Löschen eines Datenvolumens in der Konsole ".
• Volume migrieren – Migrieren Sie dieses Volume in ein anderes Profil oder eine andere Konfiguration. Weitere Informationen finden Sie unter Migration von Blockspeichervolumes.

Anzeigen von Details zu einem Block Storage for VPC Volume

Um Details zu einem Block Storage for VPC-Volume anzuzeigen, rufen Sie die Liste aller Block Storage for VPC-Volumes auf und wählen Sie ein Volume aus.

Neben dem Namen des Datenträgers befinden sich der Datenträgerstatus und Tags, die diesem Datenträger zugeordnet sind. Benutzer-Tags identifizieren die Ressource. Wenn Benutzer-Tags mit einer Backup-Richtlinie verknüpft sind, werden sie für die Erstellung von Backup-Snapshots des Volumes verwendet. Mit Zugriffsmanagementtags können Sie flexible Ressourcengruppierungen für die Verwaltung des Zugriffs erstellen. Weitere Informationen zu diesen Tags finden Sie unter Mit Tags arbeiten.

Produktspezifische Informationen

Die Seite verfügt über 4 Registerkarten. Die standardmäßig ausgewählte Registerkarte 'Übersicht' enthält Details zum Datenträger.

Datenträgerdetails

Feld	Beschreibung
Datenträgerdetails
Name	Der Name des Volumes, den Sie beim Erstellen des Volumes angegeben haben. Klicken Sie auf das Symbol Bearbeiten , um den Namen des Datenträgers zu bearbeiten. Der Datenträgername kann bis zu 63 alphanumerische Zeichen in Kleinschreibung und den Bindestrich (-) enthalten und muss mit einem Kleinbuchstaben beginnen. Datenträgernamen müssen für das Konto und für die Region eindeutig sein.
Datenträger-ID	Systemgenerierte Datenträger-ID.
Status	Der Zustandsmonitor überwacht den Gesamtzustand des Volumes, beispielsweise die E/A-Leistung und die Datenkonsistenz. Datenträgerstatus sind OK oder degraded. Datenträger in einem schlechten Zustand weisen eine unzureichende Leistung und Kapazität auf oder es treten Verbindungsprobleme auf. Datenträger, die aus einer Momentaufnahme zurückgeschrieben werden, zeigen auch einen verminderten Status. Der Service zeigt eine mögliche Ursache für den herabgesetzten Status an, damit Sie ihn beheben können. Weitere Informationen finden Sie unter Block Storage for VPC-Datenträgerstatus.
Ressourcengruppe	Die bei der Einrichtung Ihrer VPC-Instanz definierte Ressourcengruppe. Ressourcengruppen dienen zur Verwaltung des Zugriffs auf Ressourcen, haben jedoch keine Auswirkungen auf die Abrechnung oder Überwachung.
Zuordnungstyp	Daten: für ein sekundäres Volume, das an eine Instanz angehängt ist; Boot, wenn es als Boot-Volume angehängt ist; oder leer für ein nicht angehängtes Volume.
Erstellungsdatum	Systemgeneriertes Erstellungsdatum des Datenträgers.
Standort	Verfügbarkeitszone in Ihrer Region.
Größe	Größe des von Ihnen angegebenen Datenträgers. Wenn der Datenträger zu einer Virtual Server-Instanz zugeordnet wurde und noch nicht die maximale Kapazität für seinen Bereich erreicht hat, können Sie auf das Symbol klicken, um den Datenträger zu erweitern. Weitere Informationen finden Sie unter Block Storage for VPC volume capacity erweitern.
Profil	Dieses Feld zeigt das Volumenprofil an: sdp, benutzerdefinierte IOPS oder eines der IOPS-Tier-Profile.
Max. E/A-Operationen pro Sekunde	Der maximale IOPS-Wert für eine vordefinierte IOPS-Stufe oder der von Ihnen für benutzerdefinierte IOPS angegebene Wert.
Durchsatz	Das Feld zeigt die zugewiesene Bandbreite des Speichervolumens, die in Gigabit pro Sekunde (Gbps) gemessen wird. Der Durchsatz wird als Ergebnis der Anzahl der IOPS, für die das Volumen bereitgestellt wird, multipliziert mit dem Durchsatzmultiplikator berechnet. Je nach Volumenprofil kann der Durchsatzmultiplikator 16 KB oder 256 KB betragen. Für Volumes, die mit dem Profil sdp erstellt werden, ist der Durchsatzwert im Bereich von 1000-8192 Mbit/s anpassbar.
Verschlüsselung	Die Verschlüsselung mit von IBM verwalteten Schlüsseln ist standardmäßig für alle Datenträger aktiviert. Sie können auch eigene Rootschlüssel zum Schutz der Daten verwenden. Im Feld Verschlüsselung wird der Name des von Ihnen bereitgestellten und vom Kunden verwalteten Schlüsselverwaltungsdienstes (KMS) angezeigt (z. B. Key Protect ). Weitere Informationen finden Sie unter Block Storage for VPC-Datenträger mit kundenverwalteter Verschlüsselung erstellen.
Verschlüsselungsinstanz	Optional. Ein Link zu der bereitgestellten KMS-Instanz für einen Datenträger mit vom Kunden verwalteter Verschlüsselung.
Schlüssel	Optional. Der Name und die kopierbare ID des Root-Schlüssels, der zur Verschlüsselung der Passphrase verwendet wird, die ein vom Kunden verwaltetes Verschlüsselungsvolume schützt.
Sicherungsrichtlinien	Die Anzahl Sicherungsmaßnahmen, die dem Datenträger zugeordnet sind Klicken Sie auf den Zahlenlink, um die Registerkarte für Sicherungsrichtlinien aufzurufen.
Snapshots	Die Anzahl der Momentaufnahmen, die für den Datenträger erstellt wurden Klicken Sie auf den Zahlenlink, um die Registerkarte 'Momentaufnahmen und Sicherungen' aufzurufen.
Replikationsrolle	Die Rolle dieses Volumes in einer Replikationsbeziehung: source, replica, oder none. Dieses Feld ist nur bei sdp Profil-Volumes vorhanden.
Zugeordneter virtueller Server	Datenträger, die einer Virtual Server-Instanz zugeordnet wurden, werden hier aufgeführt. Klicken Sie auf Anhängen, um eine Instanz auszuwählen, an die dieses Volume angehängt werden soll. Weitere Informationen finden Sie im Abschnitt zum Zuordnen eines Datenträgers zu einer Instanz.
Status	Dieses Feld verfolgt den gesamten Lebenszyklusstatus des Datenträgers, der von der Erstellung des Datenträgers bis zu seiner Löschung reicht. Der Status angeschlossen wird beispielsweise angezeigt, wenn das Volume an eine Instanz angeschlossen ist, und wird angeschlossen, wenn der Vorgang noch läuft.
Name	Klicken Sie auf den Namen der Virtual Server-Instanz, um die Instanzdetails anzuzeigen.
Automatisches Löschen	Bei Aktiviert wird der Datenträger automatisch gelöscht, wenn Sie die Instanz löschen. Klicken Sie auf die Umschaltfläche, um die automatische Löschung zu aktivieren.
Sicherungsrichtlinien	Zeigt Sicherungsrichtlinien an, die diesem Datenträger zugeordnet sind. Um diesem Datenträger Sicherungsrichtlinien zuzuordnen, können Sie Tags einer Sicherungsrichtlinie für Zielressourcen hinzufügen. Klicken Sie auf Anwenden, um eine Sicherungsrichtlinie auszuwählen und anschließend die zugehörigen Tags für die Zielressource auf den Datenträger anzuwenden.

Über das Menü Aktionen ( ) auf der Seite mit den Details zum Volume stehen folgende Aktionen zur Verfügung:

• Aktivitätsprotokoll anzeigen – Zeigen Sie das Aktivitätsprotokoll für diesen Band an.
• Snapshot erstellen – Erstellen Sie einen Snapshot aus einem angehängten Datenvolume oder einem Startvolume. Weitere Informationen finden Sie unter Erstellen eines Snapshots in der Konsole.
• Image erstellen – Erstellen Sie ein benutzerdefiniertes Image aus einem Startvolume. Diese Aktion ist ausgegraut, wenn sie nicht verfügbar ist. Weitere Informationen finden Sie unter "Erstellen eines Images von einem Volume in der Konsole ".
• Volume erweitern – Erhöhen Sie die Größe eines angehängten Volumes in Schritten von 1 GB. Weitere Informationen finden Sie unter Kapazität von Blockspeicherdatenträgern erhöhen (Betaversion).
• IOPS-Profil bearbeiten – Ändern Sie die Leistungsmerkmale eines verbundenen Datenträgers, indem Sie die IOPS durch Bearbeiten des IOPS-Profils erhöhen oder verringern.
• Sicherungsrichtlinie anwenden – Wenden Sie eine Sicherungsrichtlinie auf dieses Volume an. Weitere Informationen finden Sie unter Anwenden von Sicherungsrichtlinien auf Ressourcen.
• Volume migrieren – Migrieren Sie dieses Volume in ein anderes Profil. Weitere Informationen finden Sie unter Migration von Blockspeichervolumes.
• Löschen – Löschen eines nicht zugeordneten Volumes. Weitere Informationen finden Sie unter "Löschen eines Datenvolumens in der Konsole ".

Um eine Liste der Snapshots dieses Volumes anzuzeigen, die manuell oder gemäß einer Sicherungsrichtlinie erstellt wurden, klicken Sie auf die Registerkarte Snapshots und Sicherungen.

Details zu angehängten Block Storage for VPC-Datenträgern in Instanzdetails anzeigen

Sie können Informationen zu einem angehängten Block Storage for VPC-Volume auch auf der Detailseite der virtuellen Serverinstanz einsehen:

1. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation > Infrastruktur > Rechenleistung > Virtuelle Serverinstanzen und wählen Sie eine Instanz aus.

2. Klicken Sie unter Zugeordnete Blockspeicherdatenträger auf den Namen des gewünschten Datenträgers, um die Detailseite dieses Datenträgers aufzurufen.

Alle Bände des CLI anzeigen

Führen Sie den folgenden Befehl aus, um eine Übersicht über alle Volumes anzuzeigen:

ibmcloud is volumes [--json]

Durch Angabe der Ressourcengruppen-ID bzw. des Ressourcengruppennamens wird die Liste der Datenträger, die zu einer Ressourcengruppe gehören, gefiltert. Wenn Sie dieses Argument weglassen, werden standardmäßig alle Ressourcengruppen berücksichtigt. Sie können auch alle Datenträger in einer bestimmten Verfügbarkeitszone anzeigen. Standardmäßig werden pro Seite die ersten 25 Datenträger angezeigt.

Im folgenden Beispiel werden alle Datenträger für alle Ressourcengruppen in Ihrer Verfügbarkeitszone angezeigt.

ibmcloud is volumes

Listing volumes in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                                            Status      Capacity   IOPS    Profile           Attachment state   Attachment type   Zone         Resource group   Catalog Offering Version   Catalog Offering Plan   Storage Generation
r006-1dad641f-3a17-4117-8bb6-e30e09e64dff   my-2nd-data-volume                              available   9600       48000   5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-f336511e-ece5-4407-9c8e-ef030c94aaa0   my-3rd-data-volume                              available   4800       48000   10iops-tier       unattached         -                 us-south-2   Default          -                          -                       1
r006-45ca6ddd-9942-4dd2-9ae9-d3edcb9fa076   my-data-volume-1                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-6a1ac889-d232-4beb-84dd-93c63cf9a156   my-data-volume-2                                available   300        3000    5iops-tier        unattached         -                 us-south-2   Default          -                          -                       1
r006-862ddcd3-59a6-4c69-9a10-275c894195b9   my-new-boot-volume                              available   250        3000    general-purpose   unattached         -                 us-south-2   Default          -                          -                       1
r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05   my-sdp-volume                                   available   250        3000    sdp               attached.          -                 us-south-2   Default          -                          -                       2
r006-693f555e-fec7-4afb-b1e3-a16bf8b0d744   my-virtual-server-instance-boot-1756849222000   available   100        3000    general-purpose   attached           boot              us-south-2   Default          -                          -                       1

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is volumes.

Anzeigen von Details zu einem Volume über die CLI

Führen Sie den folgenden Befehl aus, um Details zu einem bestimmten Datenträger anzuzeigen. Sie können den Namen oder die ID des Datenträgers verwenden, um den Datenträger zu identifizieren.

ibmcloud is volume VOLUME_ID [--json]

Beispiel:

ibmcloud is volume my-sdp-volume

Getting volume my-sdp-volume  under account under account Test Account as user test.user@ibm.com...
ID                                     r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Name                                   my-sdp-volume
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-145fb6c8-8e03-4a9f-bcd7-3bb131d30f05
Status                                 available
Attachment state                       attached
Capacity                               250
IOPS                                   3000
Bandwidth(Mbps)                        1000
Profile                                sdp
Encryption key                         -
Encryption                             provider_managed
Resource group                         Default
Created                                2025-06-23T16:35:10+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name                Auto delete   Attachment ID                               Attachment name
                                       data              0726_6cf2d984-e825-458d-8048-11572b72d040   my-virtual-server-instance   false         0717-beec02ac-7edf-4b59-ab9f-7c004bf4d8fa   outpour-perm-cosmic-gander
Active                                 true
Adjustable IOPS                        true
Adjustable Capacity States             unattached,attached
Adjustable IOPS States                 unattached,attached
Busy                                   false
Tags                                   -
Storage Generation                     2

Im Beispiel ist das Volume an eine virtuelle Serverinstanz angehängt, sodass die Namen und IDs des Volume-Anhangs und der Instanz auch in der Befehlsausgabe angezeigt werden. Die Eigenschaft Active lautet true, da die virtuelle Serverinstanz, an die das Volume angeschlossen ist, ausgeführt wird. Die Eigenschaft Busy mit dem Wert false zeigt an, dass dieser Datenträger keinen Vorgang durchführt, der serialisiert werden muss.

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

Zusätzliche CLI-Eigenschaften für Boot-Volumes

Wenn Sie Details zu Boot-Volumes abfragen, werden in der Antwort einige zusätzliche Eigenschaften zurückgegeben. Sehen Sie sich das folgende Beispiel an:

ibmcloud is volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e

Getting volume r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e under account Test Account as user test.user@ibm.com...
ID                                     r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Name                                   vsi-test-boot-1712686424000
CRN                                    crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-77851646-75da-4bd0-8bbd-ed86fdec0b0e
Status                                 available
Attachment state                       attached
Capacity                               100
IOPS                                   3000
Bandwidth(Mbps)                        393
Profile                                general-purpose
Encryption key                         -
Encryption                             provider_managed
Resource group                         defaults
Created                                2025-04-01T18:18:57+00:00
Zone                                   us-south-2
Health State                           ok
Volume Attachment Instance Reference   Attachment type   Instance ID                                 Instance name   Auto delete   Attachment ID                               Attachment name
                                       boot              0727_a9910bc9-3ea0-40d2-b3de-2b03e752f989   vsi-lvm-test    true          0727-7ff0df1b-ba0b-40c7-ad99-122819342f39   prissy-reason-unselect-overcome
Operating system                       CentOS Stream 9 - Minimal Install (amd64)
Source image                           ID                                          Name
                                       r006-0950e619-325e-446e-b895-e0bdd21dd1ea   ibm-centos-stream-9-amd64-9
Active                                 true
Adjustable IOPS                        false
Busy                                   false
Tags                                   -
Storage Generation                     1
Allowed Use API Version                2025-03-31
Allowed Use Bare Metal Server          true
Allowed Use Instance                   true

Die Eigenschaften der erlaubten Verwendung werden von dem Quell-Image oder Snapshot übernommen, aus dem das übergeordnete Boot-Volume erstellt wurde. Mithilfe der Befehlszeilenschnittstelle oder der API können Sie diese Werte bei der Erstellung einer Instanz oder bei der Aktualisierung des Startvolumens außer Kraft setzen. Sie müssen über die IAM-Rolle is.volume.volume.manage-allowed-use verfügen, um diese Aktualisierungen vornehmen zu können.

Diese Eigenschaften bestehen aus einem booleschen Common Expression Language-Ausdruck. Wenn der Ausdruck als true ausgewertet wird, ist die Bereitstellung einer virtuellen Serverinstanz oder eines Bare-Metal-Servers mit dem Boot-Volume oder einem Image, das von dem Boot-Volume erstellt wurde, zulässig. Wenn der Ausdruck als false ausgewertet wird, wird die Bereitstellung blockiert. Weitere Informationen finden Sie unter Hinzufügen von Ausdrücken für die zulässige Verwendung zu benutzerdefinierten Bildern.

Alle Bände mit der API anzeigen

Setzen Sie den Aufruf GET /volumes ab, um Übersichtsdaten für alle Datenträger aufzulisten. Beispiel:

curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: Bearer $iam_token"

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus. Dieses Beispiel zeigt drei Datenträger. Der zweite Eintrag in der Liste ist einer Instanz zugeordnet.

[
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2025-01-22T00:54:01.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
    "iops": 3000,
    "name": "my-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_snapshot": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
        "name": "wdc-fst-rstore-c6a092f34118-4505",
        "resource_type": "snapshot"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "env:prod",
        "env:test"
    ],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
        "name": "us-south-2"
    }
  },
  {
    "active": false,
    "allowed_use": {
      "api_version": "2025-03-31",
      "instance": "true",
      "bare_metal_server": "false"
    },
    "attachment_state": "attached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 100,
    "created_at": "2024-04-01T16:48:16.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
    "iops": 3000,
    "name": "my-vsi--boot-volume-1711989834000",
    "operating_system": {
      "architecture": "amd64",
      "dedicated_host_only": false,
      "display_name": "Ubuntu Linux® 20.04 LTS Focal Fossa Minimal Install (amd64)",
      "family": "Ubuntu Linux",
      "gpu_supported": [],
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
      "name": "ubuntu-20-04-amd64",
      "resource_type": "operating_system",
      "vendor": "Canonical",
      "version": "20.04 LTS Focal Fossa Minimal Install"
    },
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "source_image": {
        "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
        "name": "ibm-redhat-8-6-minimal-amd64-7",
        "resource_type": "image"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [
        "backup-policy-tag"
    ],
    "volume_attachments": [
        {
            "delete_volume_on_instance_delete": true,
            "device": {
                "id": ""
            },
            "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
            "instance": {
                "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
                "name": "my-vsi-test",
                "resource_type": null
            },
            "name": "perfectly-parting-humble-skewer",
            "type": "boot"
        }
    ],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
    }
  },
  {
    "active": false,
    "attachment_state": "unattached",
    "bandwidth": 393,
    "busy": false,
    "capacity": 10,
    "created_at": "2021-09-10T15:56:30.000Z",
    "crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "encryption": "provider_managed",
    "health_reasons": [],
    "health_state": "ok",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
    "iops": 3000,
    "name": "my-other-data-volume",
    "profile": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
        "name": "general-purpose"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "status": "available",
    "status_reasons": [],
    "storage_generation": 1,
    "adjustable_capacity_states": [
        "attached"
    ],
    "user_tags": [],
    "volume_attachments": [],
    "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
        "name": "us-south-3"
    }
  }
]

Anzeigen von Volumendaten mit der API

Geben Sie einen Aufruf GET /volumes/{id} aus, um die Details eines Datenträgers anzuzeigen. Beispiel:

curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: Bearer $iam_token"

Eine erfolgreiche Antwort enthält Details zum Volume, einschließlich Kapazität und IOPS, den Status des Volumes sowie die Angabe, ob das Volume an eine Instanz angehängt ist.

{
  "active": false,
  "adjustable_capacity_states": ["attached"],
  "adjustable_iops_states": ["attached"],
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  "attachment_state": "attached",
  "bandwidth": 1000,
  "busy": false,
  "capacity": 100,
  "created_at": "2024-10-07T23:16:53.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "encryption": "user_managed",
  "encryption_key": {
    "crn": "crn:v1:bluemix:public:kms:us-south:a/a1234567:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"
  },
  "health_reasons": [],
  "health_state": "ok",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5",
  "iops": 1000,
  "name": "my-volume",
  "profile": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/custom",
    "name": "custom"
  },
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
    "id": "fee82deba12e4c0fb69c3b09d1f12345",
    "name": "Default"
  },
  "resource_type": "volume",
  "status": "available",
  "status_reasons": [],
  "storage_generation": 1,
  "user_tags": [],
  "volume_attachments": [
    {
      "delete_volume_on_instance_delete": false,
      "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0/volume_attachments/0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "id": "0717-82cbf856-9cbb-45fb-b62f-d7bcef32399a",
      "instance": {
        "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "id": "0717_e21b7391-2ca2-4ab5-84a8-b92157a633b0",
        "name": "my-instance",
        "resource_type": "instance"
      },
      "name": "my-volume-attachment",
      "type": "data"
    }
  ],
  "zone": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
    "name": "us-south-1"
  }
}

Zusätzliche API-Eigenschaften für Boot-Volumes

Wenn Sie Details zu Boot-Volumes anzeigen möchten, werden in der Antwort auf Anfragen von GET /volumes und GET /volumes/{id} einige zusätzliche Eigenschaften zurückgegeben.

• Die Eigenschaft active gibt an, ob die Virtual Server-Instanz, der ein Datenträger zugeordnet ist, aktiv ist oder gestoppt wurde. Wenn die Instanz läuft active = true, funktionieren auch Vorgänge, die eine laufende Instanz erfordern, wie beispielsweise das Erstellen eines Images aus dem Startvolume.

• Die Eigenschaft busy gibt an, ob dieser Datenträger eine Operation ausführt, die serialisiert werden muss. Wenn ein Vorgang eine Serialisierung erfordert, schlägt der Vorgang fehl, sofern diese Eigenschaft nicht gesetzt ist false.

• Die Ausdrücke für die erlaubte Verwendung werden von dem Quell-Image oder -Snapshot geerbt, aus dem das übergeordnete Boot-Volume erstellt wurde. Sie können Ausdrücke für die erlaubte Verwendung nur auf abgetrennten Boot-Volumes aktualisieren. Mithilfe der Befehlszeilenschnittstelle oder der API können Sie diese Werte bei der Erstellung einer Instanz oder durch Aktualisierung des Startvolumens außer Kraft setzen. Sie müssen über die IAM-Rolle is.volume.volume.manage-allowed-use verfügen, um diese Aktualisierungen vornehmen zu können. Diese Eigenschaften bestehen aus einem booleschen Common Expression Language-Ausdruck. Wenn der Ausdruck als true ausgewertet wird, ist die Bereitstellung einer virtuellen Serverinstanz oder eines Bare-Metal-Servers mit dem Boot-Volume oder einem Image, das von dem Boot-Volume erstellt wurde, zulässig. Wenn der Ausdruck als false ausgewertet wird, wird die Bereitstellung blockiert. Weitere Informationen finden Sie unter Hinzufügen von Ausdrücken für die zulässige Verwendung zu benutzerdefinierten Bildern.

Beispiel:

  "active": "true",
  "busy": "false",
  "capacity": 100,
  "created_at": "2022-12-08T06:26:17Z",
  "crn": "crn:[...]",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
  "id": "ccbe6fe1-5680-4865-94d3-687076a38293",
  "iops": 300,
  "name": "boot-volume-1",
  "allowed_use": {
    "api_version": "2025-03-31",
    "instance": "true",
    "bare_metal_server": "false"
  },
  .
  .
  .

Alle Bände mit Terraform anzeigen

Importieren Sie die Liste der zu einem Konto gehörenden Bände als schreibgeschützte Datenquelle. Sie können nach Datenträgernamen, Zonennamen, Anhangstatus, Verschlüsselungstyp, Betriebssystemfamilie (gilt für Startvolumes) oder Betriebssystemarchitektur (gilt für Startvolumes) filtern.

data "ibm_is_volumes" "example" {
}

Zu den exportierten Attributen gehören die Gesamtzahl der Bände und die Liste der Bände. Zu den verschachtelten Attributen gehören Volume-ID, Name, Erstellungsdatum, Größe, IOPS, CRN, Zugriffs- und Benutzertags, Profil, Verschlüsselungstyp und -schlüssel, Lebenszyklusstatus, Integritätsstatus und -grund, Betriebssystem und andere Attribute.

Weitere Informationen finden Sie unter ibm_is_volumes.

Details zum Volumen mit Terraform anzeigen

Importieren Sie die Details eines Datenträgers als schreibgeschützte Datenquelle. Sie müssen das Volumen anhand der ID oder des Namens identifizieren.

data "ibm_is_volume" "example1" {
  name = ibm_is_volume.example.name
}

Zu den exportierten Attributen gehören die Gesamtzahl der Bände und die Liste der Bände. Zu den verschachtelten Attributen gehören Volume-ID, Name, Erstellungsdatum, Größe, IOPS, CRN, Zugriffs- und Benutzertags, Profil, Verschlüsselungstyp und -schlüssel, Lebenszyklusstatus, Integritätsstatus und -grund, Betriebssystem und andere Attribute.

Weitere Informationen finden Sie unter ibm_is_volume.

Zusätzliche Terraform-Eigenschaften für Boot-Volumes

Die Ausdrücke für die erlaubte Verwendung werden von dem Quell-Image oder -Snapshot geerbt, aus dem das übergeordnete Boot-Volume erstellt wurde. Sie können Ausdrücke für die erlaubte Verwendung nur auf abgetrennten Boot-Volumes aktualisieren. Mit Terraform können Sie diese Werte überschreiben, wenn Sie eine Instanz erstellen oder das Boot-Volume aktualisieren. Sie müssen über die IAM-Rolle is.volume.volume.manage-allowed-use verfügen, um diese Aktualisierungen vornehmen zu können. Diese Eigenschaften bestehen aus einem booleschen Common Expression Language-Ausdruck. Wenn der Ausdruck als true ausgewertet wird, ist die Bereitstellung einer virtuellen Serverinstanz oder eines Bare-Metal-Servers mit dem Boot-Volume oder einem Image, das von dem Boot-Volume erstellt wurde, zulässig. Wenn der Ausdruck als false ausgewertet wird, wird die Bereitstellung blockiert. Weitere Informationen finden Sie unter Hinzufügen von Ausdrücken für die zulässige Verwendung zu benutzerdefinierten Bildern.