Erstellen und Verwalten von Duplikat-Volumes
Erstellen Sie ein Duplikat eines Block Storage for Classic-Volumes aus einem Snapshot mit geerbten oder angepassten Kapazitäts- und Leistungseinstellungen, entweder als abhängige oder als unabhängige Kopie.
Das duplizierte Volume erbt standardmäßig die Kapazität und die Leistungsoptionen des ursprünglichen Volumes, aber Sie können beide Attribute während der Erstellung anpassen. Das Duplikat enthält eine Kopie der Daten aus dem Snapshot, mit dem es erstellt wurde.
Als Benutzer mit einem dedizierten Konto für IBM Cloud® Kubernetes Service finden Sie in der IBM Cloud Kubernetes Service-Dokumentation Informationen zu Optionen für die Duplizierung eines Datenträgers.
Da der Duplikatdatenträger auf den Daten eines zeitpunktgesteuerten Snapshots basiert, ist auf dem ursprünglichen Datenträger Snapshotbereich erforderlich, bevor ein Duplikat erstellt werden kann. Weitere Informationen zu Snapshots und zum Bestellen von Snapshotbereichen finden Sie in der Snapshotdokumentation.
Typen doppelter Datenträger
Unabhängiges Duplikat
Unabhängige Duplikate können sowohl von primären Datenträgern als auch von Replikatdatenträgern erstellt werden. Das Duplikat wird im selben Rechenzentrum wie das Original-Volume erstellt. Wenn Sie aus einem Replikat-Volume ein Duplikat erstellen, wird das Duplikat-Volume im selben Rechenzentrum wie das Replikat-Volume erstellt.
Allgemeine Verwendungen für einen unabhängigen doppelten Datenträger
- Goldkopie. Verwenden Sie ein Speichervolume als Masterkopie, aus der Sie mehrere Instanzen für verschiedene Zwecke erstellen können.
- Datenaktualisierung: Erstellen Sie eine Kopie Ihrer Produktionsdaten, um diese zu Testzwecken in Ihrer Nicht-Produktionsumgebung einzubinden.
- Entwicklung und Test. Erstellen Sie gleichzeitig bis zu vier simultane Duplikate eines Datenträgers, um duplizierte Daten zu Entwicklungs- und Testzwecken zu erstellen.
Abhängiges Duplikat
Abhängige doppelte Datenträger werden mithilfe einer Momentaufnahme des primären Datenträgers erstellt. Replikat-Volumes können nicht zum Erstellen oder Aktualisieren abhängiger Duplikate verwendet werden.
Allgemeine Verwendungen für einen abhängigen doppelten Datenträger
- Disaster-Recovery-Test: Erstellen Sie ein Duplikat Ihres Quellendatenträgers und vergleichen Sie es mit dem Replikat. Durch den Vergleich des Duplikats mit dem Replikat können Sie überprüfen, ob die Daten, die repliziert werden, intakt sind und bei einem Katastrophenfall verwendet werden können, ohne dass die Replikation unterbrochen wird.
- Wiederherstellung aus Snapshot: Stellen Sie Daten auf dem Originaldatenträger mit bestimmten Dateien und Datumsangaben aus einem Snapshot wieder her, ohne den gesamten Originaldatenträger mit einer Snapshotwiederherstellungsfunktion zu überschreiben.
- Datenaktualisierung: Erstellen Sie eine Kopie Ihrer Produktionsdaten, um diese zu Testzwecken in Ihrer Nicht-Produktionsumgebung einzubinden.
- Entwicklung und Test. Erstellen Sie gleichzeitig bis zu vier simultane Duplikate eines Datenträgers, um duplizierte Daten zu Entwicklungs- und Testzwecken zu erstellen.
Erstellen eines Duplikatsvolumes in der Konsole
Sie können doppelte Datenträger über die Befehlszeilenschnittstelle und in der IBM Cloud-Konsole auf verschiedene Arten erstellen.
Erstellen eines Duplikats aus der Speicherliste in der Konsole
-
Gehen Sie zu Ihrer Liste von Block Storage for Classic in der IBM Cloud durch Klicken auf Infrastruktur > Klassische Infrastruktur > Speicher > Block Storage for Classic.
-
Wählen Sie einen Datenträger in der Liste aus und klicken auf die Auslassungspunkte
> Datenträger duplizieren.
-
Wählen Sie aus, ob das Duplikat abhängig oder unabhängig sein soll.
-
Wählen Sie die Snapshot-Option aus, die zum Erstellen des Duplikats verwendet werden soll. Sie können einen vorhandenen Snapshot auswählen oder einen neuen erstellen.
-
Die Standorteinträge bleiben mit denen des Originaldatenträgers identisch.
-
Stündliche oder monatliche Rechnungsstellung – Sie können den duplizierten Datenträger mit stündlicher oder monatlicher Rechnungsstellung bereitstellen. Der Abrechnungstyp für den Originaldatenträger wird automatisch ausgewählt. Wenn Sie jedoch für Ihren neuen duplizierten Speicher einen anderen Abrechnungstyp wählen möchten, können Sie das hier tun.
-
Sie können die Größe des neuen Datenträgers so aktualisieren, dass er größer als der ursprüngliche Datenträger wird. Standardmäßig wird die Größe des ursprünglichen Datenträgers festgelegt.
Block Storage for Classic kann bis auf das Zehnfache der ursprünglichen Größe des Datenträgers erhöht werden .
-
Sie können den Snapshotbereich für den neuen Datenträger aktualisieren, um mehr, weniger oder keinen Snapshotbereich hinzuzufügen.
-
Sie können den Betriebssystemtyp so auswählen, dass er sich vom Originaldatenträger unterscheidet oder gleich bleibt.
-
Sie können für das neue Volume auf Wunsch eine IOPS-Stufe oder eine IOPS-Tier-Stufe festlegen. Standardmäßig wird der IOPS-Wert des ursprünglichen Datenträgers festgelegt. Die verfügbaren Performance- und Größenkombinationen werden angezeigt.
- Wenn der ursprüngliche Datenträger die Endurance-Stufe von 0,25 IOPS hat, können Sie keine neue Auswahl angeben.
- Wenn der ursprüngliche Datenträger die Endurance-Stufe von 2, 4 oder 10 IOPS hat, können Sie für den neuen Datenträger einen beliebigen Wert zwischen diesen Stufen angeben.
-
Aktivieren Sie dieses Kontrollkästchen, wenn Sie die Bedingungen gelesen haben und diesen zustimmen.
-
Klicken Sie auf Erstellen, um den Vorgang fortzusetzen.
Duplikat über die Detailseite des Datenträgers in der Benutzerschnittstelle erstellen
-
Navigieren Sie zur Block Storage for Classic-Liste.
-
Klicken Sie in der Liste auf einen Datenträger, um die Detailseite anzuzeigen. (Es kann sich entweder um ein Replikat oder um ein Primärvolume handeln.)
-
Klicken Sie auf Aktionen
> Datenträger duplizieren.
-
Wählen Sie aus, ob das Duplikat abhängig oder unabhängig sein soll.
-
Wählen Sie die Snapshot-Option aus, die zum Erstellen des Duplikats verwendet werden soll. Sie können einen vorhandenen Snapshot auswählen oder einen neuen erstellen.
-
Die Standorteinträge bleiben mit denen des Originaldatenträgers identisch.
-
Stündliche oder monatliche Rechnungsstellung – Sie können den duplizierten Datenträger mit stündlicher oder monatlicher Rechnungsstellung bereitstellen. Der Abrechnungstyp für den Originaldatenträger wird automatisch ausgewählt. Wenn Sie jedoch für Ihren neuen duplizierten Speicher einen anderen Abrechnungstyp wählen möchten, können Sie das hier tun.
-
Sie können die Größe des neuen Datenträgers so aktualisieren, dass er größer als der ursprüngliche Datenträger wird. Standardmäßig wird die Größe des ursprünglichen Datenträgers festgelegt.
Block Storage for Classic kann bis auf das Zehnfache der ursprünglichen Größe des Datenträgers erhöht werden .
-
Sie können den Snapshotbereich für den neuen Datenträger aktualisieren, um mehr, weniger oder keinen Snapshotbereich hinzuzufügen.
-
Sie können den Betriebssystemtyp so auswählen, dass er sich vom Originaldatenträger unterscheidet oder gleich bleibt.
-
Sie können für das neue Volume auf Wunsch eine IOPS-Stufe oder eine IOPS-Tier-Stufe festlegen. Standardmäßig wird der IOPS-Wert des ursprünglichen Datenträgers festgelegt. Die verfügbaren Performance- und Größenkombinationen werden angezeigt.
- Wenn der ursprüngliche Datenträger die Endurance-Stufe von 0,25 IOPS hat, können Sie keine neue Auswahl angeben.
- Wenn der ursprüngliche Datenträger die Endurance-Stufe von 2, 4 oder 10 IOPS hat, können Sie für den neuen Datenträger einen beliebigen Wert zwischen diesen Stufen angeben.
-
Aktivieren Sie dieses Kontrollkästchen, wenn Sie die Bedingungen gelesen haben und diesen zustimmen.
-
Klicken Sie auf Erstellen, um den Vorgang fortzusetzen.
Nachdem Sie auf Erstellen geklickt haben, wird das Fenster zur Bestätigung der Bestellung angezeigt. Wenn Sie das Fenster schließen, kehren Sie zur Ressourcenliste zurück. Sie können zur Liste Ihrer Block Storage for Classic-Datenträger zurückkehren, um auf das neu bereitgestellte Duplikat zu klicken. Im Abschnitt "Datenträgerdetails" werden Informationen wie "Typ des Duplikats", ein Link zur Detailseite des übergeordneten Datenträgers und der Name der Momentaufnahme angezeigt, die zum Erstellen des Duplikats verwendet wurde.
Erstellen eines Duplikats über die CLI
Bevor Sie beginnen, entscheiden Sie, welchen CLI-Client Sie verwenden wollen.
- Sie können die IBM Cloud-CLI und das SL-Plug-in mit
ibmcloud plugin install slinstallieren. Weitere Informationen finden Sie unter IBM Cloud-CLI mit Plug-ins erweitern. - Sie können auch die SLCLIinstallieren.
Duplikat über die IBMCLOUD CLI erstellen
Sie können den Befehl ibmcloud sl block volume-duplicate verwenden, um ein Duplikat für Ihre gemeinsam genutzte Blockressource zu erstellen. Im folgenden Beispiel wird ein unabhängiges Duplikat der Blockfreigabe 560382016 erstellt.
ibmcloud sl block volume-duplicate 560382016
This action will incur charges on your account. Continue?> y
OK
Order 110554892 was placed.
> Storage as a Service
> File Storage
> 500 GBs
> 4 IOPS per GB
> 500 GB (Snapshot Space)
You may run 'ibmcloud sl block volume-list --order 110554892' to find this block volume after it is ready.
Wenn Sie über einen bestimmten Snapshot verfügen, der die Daten enthält, die Sie zum Erstellen des duplizierten Volumes verwenden möchten, geben Sie die ID des Snapshots mit der Option --origin-snapshot-id an.
Ihr neues Duplikat ist innerhalb von Minuten bereit.
$ ibmcloud sl block volume-list --order 110554892
id username datacenter storage_type capacity_gb bytes_used IOPs ip_addr lunId active_transactions rep_partner_count notes
560391190 SL02SEV1414935_269 dal09 endurance_block_storage 500 - - fsf-dal0902b-fz.service.softlayer.com - 1 0 -
Wenn Sie ein abhängiges Duplikat Ihres Datenträgers erstellen wollen, verwenden Sie den Befehl mit der Option --dependent-duplicate. Beispiel:
$ ibmcloud sl block volume-duplicate 560391190 --dependent-duplicate
This action will incur charges on your account. Continue?> y
OK
Order 110553472 was placed.
> Storage as a Service
> File Storage
> 500 GBs
> 4 IOPS per GB
> 500 GB (Snapshot Space)
You may run 'ibmcloud sl block volume-list --order 110553472' to find this block volume after it is ready.
Weitere Informationen zu allen Parametern, die für diesen Befehl verfügbar sind, finden Sie unter ibmcloud sl block volume-duplicate.
Duplikat über die SLCLI erstellen
Zum Erstellen eines unabhängigen Duplikats Block Storage for Classic-Datenträgers können Sie folgenden Befehl verwenden.
$ slcli block volume-duplicate --help
Usage: slcli block volume-duplicate [OPTIONS] ORIGIN_VOLUME_ID
Options:
-o, --origin-snapshot-id INTEGER
ID of an origin volume snapshot to use for
duplcation.
-c, --duplicate-size INTEGER Size of duplicate block volume in GB. ***If
no size is specified, the size of the origin
volume will be used.***
Minimum: [the size
of the origin volume]
-i, --duplicate-iops INTEGER Performance Storage IOPS, between 100 and
6000 in multiples of 100 [only used for
performance volumes] ***If no IOPS value is
specified, the IOPS value of the origin
volume will be used.***
Requirements: [If
IOPS/GB for the origin volume is less than
0.3, IOPS/GB for the duplicate must also be
less than 0.3. If IOPS/GB for the origin
volume is greater than or equal to 0.3,
IOPS/GB for the duplicate must also be
greater than or equal to 0.3.]
-t, --duplicate-tier [0.25|2|4|10]
Endurance Storage Tier (IOPS per GB) [only
used for endurance volumes] ***If no tier is
specified, the tier of the origin volume
will be used.***
Requirements: [If IOPS/GB
for the origin volume is 0.25, IOPS/GB for
the duplicate must also be 0.25. If IOPS/GB
for the origin volume is greater than 0.25,
IOPS/GB for the duplicate must also be
greater than 0.25.]
-s, --duplicate-snapshot-size INTEGER
The size of snapshot space to order for the
duplicate. ***If no snapshot space size is
specified, the snapshot space size of the
origin block volume will be used.***
Input
"0" for this parameter to order a duplicate
volume with no snapshot space.
--billing [hourly|monthly] Optional parameter for Billing rate (default
to monthly)
-h, --help Show this message and exit.
Abhängige doppelte Datenträger können auch über die Befehlszeilenschnittstelle mit der Option --dependent-duplicate TRUE bestellt werden.
slcli block volume-duplicate --dependent-duplicate TRUE ORIGIN_VOLUME_ID
Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter block volume-duplicate.
Erstellen eines doppelten Volumes mit der API
Um ein unabhängiges Duplikat Block Storage for Classic Volumen mit der API zu bestellen, können Sie einen POST Aufruf an die SL API machen. Das folgende REST-API-Beispiel erstellt ein unabhängiges Duplikat für ein
Endurance-Volume (IOPS-Ebenen), das durch seine Volume-ID in der duplicateOriginVolumeId Eigenschaft identifiziert wird.
- URL -
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder - Typ-POST
- Anforderungshauptteil-
Wenn Sie über einen bestimmten Snapshot verfügen, der die Daten enthält, die Sie zum Erstellen des duplizierten Volumes verwenden möchten, geben Sie die ID des Snapshots in der Eigenschaft{ "parameters":[{ "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService", "packageId": 531, "duplicateOriginVolumeId":<PrimaryId>, "isDependentDuplicateFlag": 0, "prices": [{"id": 19497}, {"id": 16479}, {"id": 12931}, {"id": 15749}, {"id":10407}], "quantity": 1, "osFormatType":{ "keyName": "LINUX" }, "location": 2, "volumeSize":23 }] }duplicateOriginSnapshotIdan.
Um ein abhängiges Duplikat für einen Performance-Datenträger (angepasste E/A-Operationen pro Sekunde) zu bestellen, führen Sie einen POST /SoftLayer_Product_Order/placeOrder-Aufruf wie im folgenden REST-API-Beispiel
aus.
- URL -
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder - Typ-POST
- Anforderungshauptteil-
Wenn Sie über einen bestimmten Snapshot verfügen, der die Daten enthält, die Sie zum Erstellen des duplizierten Volumes verwenden möchten, geben Sie die ID des Snapshots in der Eigenschaft{ "parameters":[{ "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService", "packageId": 531, "duplicateOriginVolumeId":1327277, "isDependentDuplicateFlag": 1, "prices": [{"id": 15751}, {"id": 19487}, {"id": 18983}, {"id": 15749}, {"id":10407}], "quantity": 1, "iops":454, "osFormatType":{ "keyName": "LINUX" }, "location": 2, "volumeSize":23 }] }duplicateOriginSnapshotIdan.
Weitere Informationen zur API und zu den Optionen finden Sie in der API-Referenz. Suchen Sie nach dem SoftLayer_Container_Product_Order_Network_Storage_AsAService datentyp.
Duplizierten Datenträger verwalten
Ein Host kann für Lese-und Schreiboperationen auf alle doppelten Datenträger zugreifen, sobald der Datenträger bereitgestellt wird.
Momentaufnahmen und die Replikation unabhängiger duplizierter Datenträger sind jedoch erst zulässig, wenn die Datenkopie vom Original auf das Duplikat vollständig und der duplizierte Datenträger vollständig unabhängig ist. Je nach Datenumfang kann der Aufteilungsprozess mehrere Stunden dauern. Nach Fertigstellung kann das Duplikat verwaltet und als eigenständiger Band verwendet werden.
Während die Daten vom ursprünglichen Volume auf das unabhängige Duplikat kopiert werden, können Sie an der Statusanzeige auf der Detailseite erkennen, dass die Duplizierung gerade läuft. Während dieser Zeit können Sie eine Verbindung zu einem Host herstellen sowie auf das Volume lesen und schreiben, aber Sie können keine Snapshot-Zeitpläne erstellen oder eine Aktualisierung auslösen. Nach Abschluss des Trennungsprozesses ist das neue Volume unabhängig vom Original und kann wie gewohnt mit Snapshots und Replikation verwaltet werden. Nach Abschluss der Konvertierung kann der unabhängige Datenträger mithilfe einer Momentaufnahme des übergeordneten Datenträgers manuell aktualisiert werden.
Abhängige Duplikate durchlaufen nicht den Trennungsprozess und können jederzeit manuell aktualisiert werden. Der Aktualisierungsprozess kann über die CLI, mit der API und in der Konsole initiiert werden. Wenn Sie das abhängige Duplikat später in einen unabhängigen Datenträger konvertieren möchten, können Sie diesen Prozess auch über die Benutzerschnittstelle, die Befehlszeilenschnittstelle oder die API einleiten.
Der abhängige doppelte Datenträger sperrt die ursprüngliche Momentaufnahme, sodass die Momentaufnahme nicht gelöscht werden kann, solange das abhängige Duplikat vorhanden ist.
Aktualisieren der Daten auf dem Duplikat vom übergeordneten Volume in der Konsole
Wenn auf dem Primärdatenträger im Laufe der Zeit Änderungen vorgenommen werden, kann der Duplikatdatenträger über die Aktualisierungsaktion mit diesen Änderungen aktualisiert werden, um den aktuellen Status wiederzugeben. Bei der Aktualisierung wird zunächst ein Snapshot des primären Volumes erstellt und anschließend das Duplikat-Volume anhand der Daten aus diesem Snapshot aktualisiert.
Wenn der duplizierte Datenträger unabhängig ist, können Sie eine aktive Aktualisierungsoperation stoppen und einen neuen starten.
-
Gehen Sie zu Ihrer Liste von Block Storage for Classic in der IBM Cloud durch Klicken auf Infrastruktur > Klassische Infrastruktur > Speicher > Block Storage for Classic.
-
Suchen Sie den duplizierten Datenträger und klicken Sie auf seinen Namen, um die Datenträgerdetails anzuzeigen.
-
Klicken Sie auf Aktionen
> Übergeordnete Momentaufnahme wiederherstellen.
-
Wählen Sie in der Liste der Momentaufnahmen die übergeordnete Momentaufnahme aus, die die Daten enthält, die Sie auf dem duplizierten Datenträger wiederherstellen wollen. Wenn der duplizierte Datenträger, den Sie aktualisieren, ein unabhängiger Datenträger ist, können Sie eine aktive Operation stoppen und den Start einer neuen Zurückschreibung erzwingen. Wenn Sie das Stoppen eines aktuellen Aktualisierungsprozesses erzwingen möchten, aktivieren Sie das Kontrollkästchen, bevor Sie fortfahren.
Die Wiederherstellung von Daten aus einer Momentaufnahme führt zum Verlust aller Daten, die seit der Erstellung der ausgewählten Momentaufnahme erstellt oder geändert wurden. Während der Aktualisierungstransaktion wird das doppelte Volume deaktiviert und muss nach Abschluss der Aktualisierung erneut eingebunden werden.
-
Klicken Sie auf Ja, um die Aktualisierung zu starten. Die Aktualisierung kann eine Weile dauern. Die Statusleiste zeigt den Prozentsatz der Daten an, die auf den Datenträger kopiert wurden. Aktualisieren Sie die Seite im Browser, um den aktualisierten Status anzuzeigen.
Konvertieren eines abhängigen Volumes in ein unabhängiges Duplikat in der Konsole
- Gehen Sie zu Ihrer Liste von Block Storage for Classic in der IBM Cloud durch Klicken auf Infrastruktur > Klassische Infrastruktur > Speicher > Block Storage for Classic.
- Suchen Sie den duplizierten Datenträger und klicken Sie auf seinen Namen, um die Datenträgerdetails anzuzeigen.
- Klicken Sie auf Aktionen
> Abhängiges Duplikat konvertieren.
- Aktivieren Sie das Kontrollkästchen, um zu bestätigen, dass Sie mit der Konvertierung fortfahren möchten.
- Klicken Sie auf Ja.
Der Konvertierungsprozess kann einige Zeit in Anspruch nehmen. Je größer das Volumen ist, desto länger dauert die Konvertierung. Sie können den Status des Prozesses auf der Seite mit den Datenträgerdetails unter der Kopfzeile Konvertierungsstatus duplizieren anzeigen.
Daten auf dem Duplikat des übergeordneten Datenträgers über die Befehlszeilenschnittstelle aktualisieren
Wenn auf dem Primärdatenträger im Laufe der Zeit Änderungen vorgenommen werden, kann der Duplikatdatenträger über die Aktualisierungsaktion mit diesen Änderungen aktualisiert werden, um den aktuellen Status wiederzugeben. Bei der Aktualisierung wird zunächst ein Snapshot des primären Volumes erstellt und anschließend das Duplikat-Volume anhand der Daten aus diesem Snapshot aktualisiert.
Aktualisierungen können mit dem folgenden Befehl ausgelöst werden.
slcli block volume-refresh <duplicate-vol-id> <primary-snapshot-id>
Die Aktualisierung hat keine Ausfallzeit für den Primärdatenträger zur Folge. Während der Aktualisierungstransaktion wird das duplizierte Volume jedoch deaktiviert und muss nach Abschluss der Aktualisierung erneut eingebunden werden.
Der Aktualisierungsprozess kann zeitaufwendig sein. Wenn Sie feststellen, dass neue Daten auf den unabhängigen duplizierten Datenträger kopiert werden sollen, können Sie den Befehl slcli block volume-refresh mit der Option --force-refresh ausgeben, um alle laufenden und anstehenden Aktualisierungstransaktionen zu stoppen und eine neue Aktualisierung einzuleiten.
Der Prozess zum Erzwingen der Aktualisierung funktioniert nur auf unabhängigen Datenträgern.
Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter slcli block volume-refresh.
Konvertieren eines abhängigen Datenträgers in ein unabhängiges Duplikat über die Befehlszeilenschnittstelle
Wenn Sie den abhängigen Datenträger zukünftig als eigenständigen Datenträger verwenden möchten, können Sie ihn über die SLCLI in einen normalen, abhängigen IBM Cloud® Block Storage for Classic-Datenträger konvertieren. Verwenden Sie dazu den folgenden Befehl.
slcli block volume-convert <dependent-vol-id>
Der Konvertierungsprozess kann einige Zeit in Anspruch nehmen. Je größer das Volumen ist, desto länger dauert die Konvertierung. Verwenden Sie den folgenden Befehl, um den Fortschritt zu überprüfen.
slcli block duplicate-convert-status <dependent-vol-id>
Das folgende Beispiel zeigt die erwartete Ausgabe.
slcli block duplicate-convert-status 370597202
Username Active Conversion Start Timestamp Completed Percentage
SL02SEVC307608_74 2022-06-13 14:59:17 90
Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter duplicate-convert-status.
Daten auf dem Duplikat des übergeordneten Datenträgers mit der API aktualisieren
Wenn auf dem Primärdatenträger im Laufe der Zeit Änderungen vorgenommen werden, kann der Duplikatdatenträger über die Aktualisierungsaktion mit diesen Änderungen aktualisiert werden, um den aktuellen Status wiederzugeben. Bei der Aktualisierung wird zunächst ein Snapshot des primären Volumes erstellt und anschließend das Duplikat-Volume anhand der Daten aus diesem Snapshot aktualisiert.
Die Aktualisierung hat keine Ausfallzeit für den Primärdatenträger zur Folge. Während der Aktualisierungstransaktion wird das duplizierte Volume jedoch deaktiviert und muss nach Abschluss der Aktualisierung erneut eingebunden werden.
Der Aktualisierungsprozess kann zeitaufwendig sein. Um dem Duplikat neue Daten hinzuzufügen, bevor die laufende Aktualisierung abgeschlossen ist, führen Sie einen zweiten Aufruf von refreshDuplicate durch, wobei der Parameter forceRefresh auf true gesetzt ist. Dadurch werden alle laufenden und anstehenden Aktualisierungsvorgänge gestoppt und eine neue Aktualisierung gestartet. Wenn der Parameter auf false gesetzt oder nicht angegeben ist, schlägt der
Aufruf fehl, wenn eine weitere Aktualisierung im Gange ist.
Der Prozess zum Erzwingen der Aktualisierung funktioniert nur auf unabhängigen Datenträgern.
Beispiel für REST-API
- URL -
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/duplicateVolumeId/refreshDuplicate - Typ-POST
- Anforderungshauptteil-
{ "parameters": [primaryVolumeSnapshotId, true OR false] }
SOAP-API-Beispiel
- URL -
https://api.softlayer.com/soap/v3.1/SoftLayer_Network_Storage - Typ-POST
- Anforderungshauptteil-
<?xml version="1.0" encoding="UTF-8"?> <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://api.service.softlayer.com/soap/v3.1/"> <SOAP-ENV:Header> <ns1:authenticate> <username>USERNAME</username> <apiKey>APIKEY</apiKey> </ns1:authenticate> <ns2:SoftLayer_Network_StorageInitParameters> <id>duplicate Volume Id</id> </ns2:SoftLayer_Network_StorageInitParameters> </SOAP-ENV:Header> <SOAP-ENV:Body> <ns1:refreshDuplicate> <snapshotId xsi:type="int">primary Volume Snapshot Id</snapshotId> <forceRefresh xsi:type="boolean">true</forceRefresh> <-- (remove this tag for normal refresh) </ns1:refreshDuplicate> </SOAP-ENV:Body> </SOAP-ENV:Envelope>
Weitere Informationen zur API und zu den Optionen finden Sie in der API-Referenz und in SoftLayer_Network_Storage::refreshDuplicate.
Konvertieren eines abhängigen Datenträgers in ein unabhängiges Duplikat mit der API
Wenn Sie das abhängige Volume in Zukunft als eigenständiges Volume nutzen möchten, können Sie es mithilfe der API in ein normales, unabhängiges IBM Cloud® Block Storage for Classic-Volume umwandeln. Sehen Sie sich das folgende Beispiel an, in dem die REST-API verwendet wird.
- URL -
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/<storageId>/convertCloneDependentToIndependent - Typ-POST
- Anforderungshauptteil-leer
Weitere Informationen zur API und zu den Optionen finden Sie in der API-Referenz.
Speicherdatenträger mit einem abhängigen Duplikat kündigen
Um ein übergeordnetes Volume mit aktiven abhängigen Volumes zu löschen, müssen zunächst die abhängigen doppelten Volumes gelöscht werden.