IBM Cloud Docs
Anhängen eines Block Storage for VPC Volumes

Anhängen eines Block Storage for VPC Volumes

Wenn Sie ein IBM® Cloud Block Storage for Virtual Private Cloud Volume für eine virtuelle Serverinstanz erstellen, wird das Volume standardmäßig an die Instanz angehängt. Wenn Sie die Zuordnung eines Datenträgers aufheben, dann existiert der Datenträger als nicht zugeordneter Datenträger weiter, der zu einem späteren Zeitpunkt erneut zugeordnet werden kann. Diese verfügbaren Datenträger werden in der Liste der alle Block Storage for VPC Datenträger angezeigt. Sie können das Volume einer anderen Instanz aus der Liste aller Block Storage for VPC Volumes zuordnen, oder wenn Sie Details zu einer Instanz anzeigen.

Einschränkungen bei der Datenträgerzuordnung

Sie können jeweils nur ein Block Storage for VPC Boot-Volume an eine virtuelle Serverinstanz anhängen, aber Sie können bis zu 12 Block Storage for VPC Daten-Volumes an eine einzelne Instanz anhängen.

Wenn Sie eine Hyper Protect Virtual Servers for IBM Cloud® Virtual Private Cloud-Instanz erstellen, kann derzeit nur ein Datenträger hinzugefügt werden. Selbst wenn Sie weitere Datenträger zuordnen, werden diese nicht von der Instanz verwendet.

Sie können die Benutzeroberfläche nicht verwenden, um Block Storage for VPC Volumes an IBM Cloud® Kubernetes Service Cluster-Arbeitsknoten anzuhängen. Weitere Informationen über die Verwendung der CLI zum Anhängen von Volumes an Clusterknoten finden Sie unter Speichern von Daten auf Block Storage for VPC.

Anhängen eines Block Storage for VPC Volumes an eine virtuelle Serverinstanz

Sie können einen Datenträger über die Liste der Block Storage-Datenträger, die Seite mit den Datenträgerdetails oder über die Seite mit den Instanzdetails einer virtuellen Serverinstanz zuordnen.

Datenträger aus der Liste der Datenträger an eine Instanz anhängen

Gehen Sie in der Liste aller Block Storage for VPC Volumes wie folgt vor.

  1. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation Menü-Symbol > Infrastruktur VPC-Symbol > Speicher > Block Storage Volumen.
  2. Geben Sie in der Liste der Datenträger einen verfügbaren, nicht angehängten Datenträger an und klicken Sie auf das Symbol Aktionen Aktionssymbol am Ende einer Zeile.
  3. Wählen Sie Zu Instanz zuordnen aus.
  4. Wählen Sie eine virtuelle Serverinstanz aus der Liste der verfügbaren Instanzen und klicken Sie dann auf Speichern. Wenn in der Liste keine virtuellen Serverinstanzen angezeigt werden, klicken Sie auf Server erstellen, um die Seite Instanzbereitstellung aufzurufen.
  5. Auf der Seite mit den Datenträgerdetails werden Nachrichten angezeigt, in denen Sie darüber informiert werden, dass der Datenträger dem Image zugeordnet wird. Nach Abschluss dieses Vorgangs wird unter Zugeordnete Instanzen der Name des Images angezeigt.

Wenn Sie eine Hyper Protect Virtual Servers-Instanz erstellen und der Vertrag Datenträger erwähnt, haben Sie 15 Minuten nach der Erstellung der Instanz Zeit, einen Datenträger zuzuordnen. Ist dies nicht der Fall, wird die Instanz nach dem 15 -minütigen Fenster in den Status 'Herunterfahren' versetzt.

Datenträger über die Seite 'Datenträgerdetails' einer Instanz zuordnen

Führen Sie auf der Seite mit den Datenträgerdetails die folgenden Schritte aus:

  1. Wählen Sie einen nicht zugeordneten Datenträger in der Liste der Block Storage datenträger aus.
  2. Klicken Sie auf der Seite 'Datenträgerdetails' auf der Kachel Virtuelle Serverinstanzen auf Zuordnen.
  3. Wählen Sie in der seitlichen Anzeige eine virtuelle Serverinstanz aus und klicken Sie auf Speichern. Wenn in der Liste keine virtuellen Serverinstanzen angezeigt werden, klicken Sie auf Server erstellen, um die Seite Instanzbereitstellung aufzurufen. Der Boot-oder Datendatenträger wird auf der Instanzbereitstellungsseite in den entsprechenden Feldern angezeigt.
  4. Nachrichten zeigen an, dass der Datenträger an das Image angehängt wird. Nach Abschluss dieses Vorgangs wird unter Zugeordnete Instanzen der Name des Images angezeigt.

Datenträger über die Seite 'Instanzdetails' einer Instanz zuordnen

Hängen Sie einen Block Storage for VPC-Datenträger über die Detailseite der virtuellen Serverinstanz an.

  1. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation Menü-Symbol > Infrastruktur VPC-Symbol > Rechenleistung > Virtuelle Serverinstanzen.
  2. Wählen Sie in der Liste aller Virtual Server-Instanzen die gewünschte Instanz aus. Wenn Block Storage for VPC-Datenträger zugeordnet sind, werden sie unter Speicherdatenträger aufgeführt.
  3. Wählen Sie Datenträger zuordnen aus.
  4. Wählen Sie in der Liste der verfügbaren Ressourcen den gewünschten Datenträger aus und klicken Sie dann auf Zuordnen. Auf der Seite mit den Instanzdetails werden Nachrichten angezeigt, in denen Sie darüber informiert werden, dass der Datenträger zugeordnet wird. Wenn der Vorgang abgeschlossen ist, wird die Liste Speichervolumen aktualisiert und enthält das neue Volumen.

Anhängen eines Block Storage for VPC Volumes über die CLI

Befolgen Sie diese Anweisungen, um mithilfe der Befehlszeilenschnittstelle ein Block Storage for VPC-Volume an eine virtuelle Serverinstanz anzuhängen. Jede Instanz kann über mehrere Datenträgerzuordnungen verfügen, eine einzelne Datenträgerzuordnung stellt aber eine Verbindung zwischen einem Datenträger und einer Instanz her.

Vorbereitende Schritte

Bevor Sie die Befehlszeilenschnittstelle (CLI) verwenden können, müssen Sie die IBM Cloud-CLI und das VPC-CLI-Plug-in installieren. Weitere Informationen finden Sie unter CLI-Voraussetzungen.

Melden Sie sich bei IBM Cloud an.

ibmcloud login --sso -a cloud.ibm.com

Mit diesem Befehl wird eine URL zurückgegeben und die Eingabe eines Kenncodes angefordert. Rufen Sie diese URL im Browser auf und melden Sie sich an. Wenn dieser Vorgang erfolgreich ausgeführt werden kann, dann erhalten Sie einen Einmalkenncode. Kopieren Sie diesen Kenncode und fügen Sie ihn als Antwort auf die Eingabeaufforderung ein. Nach erfolgreicher Authentifizierung werden Sie aufgefordert, Ihren Account auszuwählen. Wenn Sie Zugang zu mehreren Konten haben, wählen Sie das Konto aus, mit dem Sie sich anmelden möchten. Antworten Sie auf alle verbleibenden Eingabeaufforderungen, um die Anmeldung abzuschließen.

Anhängen eines Block Storage for VPC Volumes über die CLI

Um einen Datenträger einer Virtual Server-Instanz in der aktuellen Ressourcengruppe zuzuordnen, müssen Sie den folgenden Befehl ausführen.

ibmcloud is instance-volume-attachment-add NAME INSTANCE_ID VOLUME_ID [--auto-delete true | false] [--json]

NAME ist der Name, den Sie für die Datenträgerzuordnung angegeben haben. INSTANCE_ID ist die ID der virtuellen Serverinstanz. In VOLUME_ID wird der Datenträger angegeben, den Sie zuordnen. Soll der Datenträger automatisch gelöscht werden, wenn die virtuelle Serverinstanz gelöscht wird, geben Sie --auto-delete true an.

Zur Anzeige einer Liste der verfügbaren Virtual Server-Instanzen müssen Sie den Befehl ibmcloud is instances ausführen. Sehen Sie sich das folgende Beispiel an.

$ ibmcloud is instances
Listing instances in all resource groups and region us-east under account Test Account as user test.user@ibm.com...
ID                                          Name                 Status    Reserved IP   Floating IP      Profile    Image                                VPC                              Zone        Resource group   
0757_506a787d-0672-4209-854b-3e280ec50b44    my-rhel-instance    running   10.241.0.4    169.63.96.188    bx2-2x8    ibm-redhat-9-0-minimal-amd64-2       test-pbalak1                     us-east-1   defaults   
0757_4fc00b09-c967-46bf-9203-d17a08078d1d    my-rhel-instance2   running   10.241.0.5    150.239.86.22    bx2-2x8    ibm-redhat-9-0-minimal-amd64-2       test-pbalak1                     us-east-1   defaults   
0757_11f5db7f-35a1-4678-bcbd-c85204e09507    my-test-ro          stopped   10.241.0.5    -                bx2d-2x8   ibm-ubuntu-18-04-5-minimal-amd64-1   test-vpc-blu-wdc                 us-east-1   defaults   
0767_7ac6da13-c16a-4f58-9981-612d6e33ec53    my-ubuntu-vsi       running   10.241.64.4   -                bx2-2x8    ibm-centos-7-9-minimal-amd64-3       test-vpc-blu-wdc                 us-east-2   defaults   
0757_ff64452f-7e81-4a48-b938-7fc601597dcd    my-new-ubuntu-vsi   running   10.241.14.4   52.116.121.167   mx2-2x16   ibm-ubuntu-20-04-6-minimal-amd64-1   test-vpc-do-not-delete-default   us-east-1   Default   
0757_337977c1-f1f0-42ad-9de4-16fe0cda2ba9    my-virtual-server   running   10.241.4.4    52.116.124.193   mx2-2x16   ibm-ubuntu-20-04-6-minimal-amd64-1   test-vpc-do-not-delete-default   us-east-1   Default   

Wählen Sie anschließend die virtuelle Serverinstanz aus, die sich in derselben Zone wie der Datenträger befindet, den Sie zuordnen wollen.

$ ibmcloud is instance-volume-attachment-add otp1 0757_11f5db7f-35a1-4678-bcbd-c85204e09507 demo-volume-update --auto-delete true
Creating volume attachment otp1 for instance my-test-ro under account Test Account as user test.user@ibm.com...

ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c   
Name              otp1   
Volume            ID                                          Name      
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update      

Status            attaching   
Bandwidth(Mbps)   393   
Type              data   
Device            -   
Auto delete       true   
Created           2023-06-29T18:14:57+00:00

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is instance-volume-attachment-add.

Details eines Datenträgers anzeigen, der einer Virtual Server-Instanz zugeordnet ist

Nachdem Sie ein Volume angehängt haben, können Sie Details anzeigen, indem Sie die Instanz-ID oder den Namen und die Volume-Anhänge-ID oder den Namen im Befehl instance-volume-attachment angeben.

ibmcloud is instance-volume-attachment INSTANCE VOLUME_ATTACHMENT [--json]
$ ibmcloud is instance-volume-attachment my-test-ro otp1
Getting volume attachment otp1 of instance my-test-ro under account Test Account as user test.user@ibm.com...

ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c   
Name              otp1   
Volume            ID                                          Name      
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update      

Status            attached   
Bandwidth(Mbps)   393   
Type              data   
Device            0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7   
Auto delete       true   
Created           2023-06-29T18:14:57+00:00   

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

Alle Datenträgerzuordnungen einer Serverinstanz auflisten

Verwenden Sie den Befehl instance-volume-attachments und geben Sie die Instanz-ID oder den Namen an, um alle Volume-Anhänge für eine Instanz anzuzeigen.

ibmcloud is instance-volume-attachments INSTANCE [--json]

Beispiel:

ibmcloud is instance-volume-attachments my-test-ro
Listing volume attachments of instance my-test-ro under account Test Account as user test.user@ibm.com...
ID                                          Name                                 Volume                          Status     Type   Device                                            Auto delete   
0757-6757e676-0bf5-4b79-9a5b-29c24e17420c   otp1                                 demo-volume-update              attached   data   0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7   true   
0757-af470ade-9d5c-491e-97b2-f000ed4ee49b   scheming-tipper-shivering-decrease   my-test-ro-boot-1629867631000   attached   boot   0757-af470ade-9d5c-491e-97b2-f000ed4ee49b-fc4tl   true

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

JSON-Datei für Datenträgerzuordnung erstellen

Wenn Sie eine virtuelle Serverinstanz über die CLI bereitstellen und ein Block Storage for VPC-Volume als Teil des Prozesses erstellen, können Sie einen Volume-Anhang JSON angeben. Der im Befehl oder als Datei angegebene Datenträgeranhang JSON enthält die Datenträgerparameter.

Im CLI-Befehl, mit dem Sie eine Instanz erstellen, geben Sie die Option --volume-attach und die JSON-Datei des Datenträgers an. Zum Beispiel --volume-attach @/Users/myname/myvolume-attachment_create.json.

Das folgende Beispiel zeigt den Inhalt einer JSON-Datei für Datenträgeranhänge, die einen angepassten Datenträger definiert und Benutzertags angibt.

[
    {
        "name": "myvolume-attachment",
        "delete_volume_on_instance_delete": true,
        "volume": {
            "name": "myvolume",
            "capacity": 100,
            "iops": 1000,
            "profile": {
                "name": "custom"
            },
            "user_tags": {
                "env:test"
            }
        }
    }
]

Anhängen eines Block Storage for VPC Volumes mit der API

Anhängen eines Block Storage for VPC Volumes mit der API

Fügen Sie Block Storage for VPC Volumes zu einer Instanz hinzu, indem Sie die REST APIs direkt aufrufen.

Erstellen Sie eine Volume-Anlage für eine Instanz, um ein Block Storage for VPC Volume anzuhängen. Rufen Sie die Methode POST /instances auf und geben Sie volume_attachments an.

POST/instances/{instance_id}/volume_attachments

Im folgenden Beispiel wird ein Volume-Anhang erstellt und das Volume durch seine ID spezifiziert.

curl -X POST "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments?version=2021-04-20&generation=2" \
-H "Authorization: $iam_token" \
-d '{
      "delete_volume_on_instance_delete": true,
      "name": "my-volume-attachment-data-5iops",
      "volume": {"id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945"}
    }'

Eine Antwort für die erfolgreiche Ausführung gibt an, dass der Datenträger zugeordnet wurde.

{
  "created_at": "2021-04-21T16:35:47.000Z",
  "delete_volume_on_instance_delete": true,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "id": "9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "name": "my-volume-attachment-data-5iops",
  "status": "attached",
  "type": "data",
  "volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "name": "my-volume-data-5iops"
  }
}

Nächste Schritte

Erstellen Sie weitere Datenträger und verwalten Sie die bereits vorhandenen Datenträger. Siehe hierzu die folgenden Informationen.