Erstellen und Verwalten von doppelten „ File Storage for Classic “-Volumes
Erstellen Sie aus einem Snapshot ein Duplikat eines Dateispeichervolumes mit vererbten und anpassbaren Kapazitäts- und Leistungsoptionen. Das Duplikat kann abhängig oder unabhängig sein.
Sie können ein Duplikat eines vorhandenen IBM Cloud® File Storage for Classics erstellen. Der duplizierte Datenträger übernimmt standardmäßig die Kapazitäts-und Leistungsoptionen des ursprünglichen Datenträgers. Beide Attribute können jedoch geändert werden. Das Duplikat enthält eine Kopie der Daten bis zu dem Zeitpunkt, zu dem die Momentaufnahme erstellt wurde. Der duplizierte Datenträger kann vom ursprünglichen Datenträger abhängig oder unabhängig sein.
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 neue Duplikat wird im selben Rechenzentrum wie der ursprüngliche Datenträger erstellt. Wenn Sie aus einem Replikat-Volume ein Duplikat erstellen, wird das Duplikat-Volume im selben Rechenzentrum wie das Replikat erstellt.
Allgemeine Verwendungen für einen unabhängigen doppelten Datenträger
- Goldkopie. Verwenden Sie ein Speichervolumen als Referenzkopie, 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. Replikatdatenträger können nicht zum Erstellen oder Aktualisieren abhängiger duplizierter Datenträger 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 Duplikats eines bestimmten Volumes in der Konsole
-
Rufen Sie Ihre File Storage for Classic-Liste auf. Klicken Sie im Menü Infrastruktur
> Klassische Infrastruktur auf Storage > File Storage for Classic.
-
Suchen Sie den Namen des Datenträgers und klicken Sie darauf.
-
Klicken Sie auf Aktionen
> Gemeinsame Nutzung duplizieren.
-
Wählen Sie aus, ob das Duplikat abhängig oder unabhängig sein soll.
-
Wählen Sie Ihre Snapshot-Option aus.
- Erstellen Sie jetzt einen Snapshot der aktuellsten Daten.
- Verwenden Sie die letzte Momentaufnahme, die zuvor erstellt wurde.
-
Standort und IOPS-Profil bleiben gegenüber dem ursprünglichen Datenträger unverändert.
-
Sie können den duplizierten Datenträger mit stündlicher oder monatlicher Rechnungsstellung einrichten. Der Abrechnungstyp für den ursprünglichen Datenträger wird automatisch ausgewählt, Sie können ihn bei Bedarf ändern.
-
Wenn Sie möchten, können Sie die E/A-Operationen pro Sekunde (IOPS) oder die IOPS-Stufe für den neuen Datenträger ändern. 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.
-
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.
File 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. Standardmäßig wird der Snapshotbereich des ursprünglichen Datenträgers festgelegt.
-
Wählen Sie das Kontrollkästchen aus, mit dem Sie bestätigen, dass Sie die Bedingungen gelesen haben und zustimmen, und klicken Sie dann auf Erstellen, um die Bestellung zu senden.
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 zu Ihrer Liste der File Storage for Classic-Freigaben zurückkehren, um auf das neu bereitgestellte Duplikat zu klicken. Im Abschnitt "Freigabedetails" werden Informationen wie "Duplikattyp", ein Link zur Detailseite der übergeordneten Freigabe und der Name der Momentaufnahme angezeigt, die zum Erstellen des Duplikats verwendet wurde.
Erstellen eines Duplikats über die Befehlszeile
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 file volume-duplicate verwenden, um ein Duplikat für Ihre Dateifreigabe zu erstellen. Im folgenden Beispiel wird ein unabhängiges Duplikat der Dateifreigabe 560382016 erstellt.
ibmcloud sl file 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 file volume-list --order 110554892' to find this file volume after it is ready.
Ihr neues Duplikat ist innerhalb von Minuten bereit.
$ ibmcloud sl file 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_file_storage 500 - - fsf-dal0902b-fz.service.softlayer.com - 1 0 -
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.
Wenn Sie ein abhängiges Duplikat Ihres Datenträgers erstellen wollen, verwenden Sie den Befehl mit der Option --dependent-duplicate. Beispiel:
$ ibmcloud sl file 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 file volume-list --order 110553472' to find this file volume after it is ready.
Weitere Informationen zu allen Parametern, die für diesen Befehl verfügbar sind, finden Sie unter ibmcloud sl file volume-duplicate.
Duplikat über die SLCLI erstellen
Zum Erstellen eines unabhängigen Duplikats File Storage for Classic-Datenträgers können Sie folgenden Befehl verwenden.
$ slcli file volume-duplicate --help
Usage: slcli file 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 file 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 file 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 file volume-duplicate --dependent-duplicate TRUE <primary-vol-id>
Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter file volume-duplicate.
Doppelte Freigabe mit der API erstellen
Um einen unabhängigen Duplikat Block Storage for Classic-Datenträger mit der API zu bestellen, können Sie einen POST /SoftLayer_Product_Order/placeOrder-Aufruf durchführen. Das folgende REST-API-Beispiel erstellt
ein unabhängiges Duplikat für einen Endurance-Datenträger (IOPS-Tiers).
- URL
https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder- Typ
- POST
Anforderungshauptteil
{
"parameters":[{
"complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
"packageId": 531,
"duplicateOriginVolumeId":<PrimaryId>,
"isDependentDuplicateFlag": 1,
"prices": [{"id": 12207}, {"id": 10723}, {"id": 10413}, {"id": 15749}, {"id":14043}],
"quantity": 1,
"location": 2,
"volumeSize":23
}]
}
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 duplicateOriginSnapshotId an.
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
{
"parameters":[{
"complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
"packageId": 531,
"duplicateOriginVolumeId":<PrimaryId>,
"isDependentDuplicateFlag": 1,
"prices": [{"id": 15751}, {"id": 19487}, {"id": 18983}, {"id": 15749}, {"id":14043}],
"quantity": 1,
"iops":456,
"location": 2,
"volumeSize":23
}]
}
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 duplicateOriginSnapshotId an.
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 Umfang der Daten kann der Trennungsprozess mehrere Stunden dauern. Sobald der Vorgang abgeschlossen ist, kann das Duplikat verwaltet und als eigenständiges Volume genutzt werden.
Während die Daten vom Original-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 zugreifen, jedoch keine Snapshot-Zeitpläne erstellen oder Daten aus der ursprünglichen Dateifreigabe aktualisieren. Sobald der Trennungsprozess abgeschlossen ist, ist das neue Volume unabhängig vom ursprünglichen Volume und kann wie gewohnt mit Snapshots und Replikation verwaltet werden. Das unabhängige Duplikat kann mithilfe einer Momentaufnahme des übergeordneten Datenträgers nach Abschluss der Konvertierung 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 oder in der Konsole initiiert werden. Wenn Sie später das abhängige Duplikat in einen unabhängigen Datenträger konvertieren möchten, können Sie diesen Prozess auch über die Benutzerschnittstelle, die API oder die Befehlszeilenschnittstelle 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ärvolumens erstellt und anschließend das Duplikatvolumens 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.
-
Rufen Sie Ihre File Storage for Classic-Liste auf. Klicken Sie im Menü Infrastruktur
> Klassische Infrastruktur auf Storage > File 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
- Rufen Sie Ihre File Storage for Classic-Liste auf. Klicken Sie im Menü Infrastruktur
> Klassische Infrastruktur auf Storage > File 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 eine Momentaufnahme des primären Datenträgers erstellt und anschließend der duplizierte Datenträger mithilfe dieser Momentaufnahme aktualisiert.
Die Aktualisierung hat keine Ausfallzeit für den Primärdatenträger zur Folge. Während der Aktualisierungstransaktion ist der Duplikatdatenträger jedoch nicht verfügbar und muss nach dem Abschluss der Aktualisierung erneut angehängt 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 file 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.
Aktualisieren von Daten für ein abhängiges Duplikat über die IBMCLOUD CLI
Mit dem Befehl ibmcloud sl file volume-refresh können Sie die Daten auf Ihrem duplizierten Datenträger mit den Daten aus einer Momentaufnahme des übergeordneten Datenträgers aktualisieren. Das folgende Beispiel zeigt, wie manuell
eine Momentaufnahme des übergeordneten Datenträgers 560391190 erstellt und anschließend die neue Momentaufnahme 560391944 verwendet wird, um die Daten in der Dateifreigabe 560391814 zu aktualisieren.
$ ibmcloud sl file snapshot-create 560391190
OK
New snapshot 560391944 was created.
$ ibmcloud sl file volume-refresh 560391814 560391944
OK
Weitere Informationen zu allen Parametern, die für diesen Befehl verfügbar sind, finden Sie unter ibmcloud sl file volume-refresh.
Aktualisieren von Daten zu einem abhängigen Duplikat über die SLCLI
Aktualisierungen können mit dem folgenden Befehl ausgelöst werden.
slcli file volume-refresh <duplicate-vol-id> <primary-snapshot-id>
Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter slcli file volume-refresh.
Konvertieren eines abhängigen Datenträgers in ein unabhängiges Duplikat über die Befehlszeilenschnittstelle
Wenn Sie das abhängige Volume künftig als eigenständiges Volume nutzen möchten, können Sie es über die Befehlszeilenschnittstelle (CLI) in ein normales, unabhängiges „ File Storage for Classic “-Volume umwandeln.
Abhängigen Datenträger über die IBMCLOUD CLI konvertieren
Verwenden Sie den Befehl ibmcloud sl file volume-convert, um ein abhängiges Duplikat in eine unabhängige Dateifreigabe zu konvertieren. Das folgende Beispiel zeigt, wie die Dateifreigabe 560391814 in einen unabhängigen
Datenträger konvertiert wird.
$ ibmcloud sl file volume-convert 560391814
OK
Der Konvertierungsprozess kann einige Zeit in Anspruch nehmen. Je größer das Volumen ist, desto länger dauert die Konvertierung.
Weitere Informationen zu allen Parametern, die für diesen Befehl verfügbar sind, finden Sie in ibmcloud sl file volume-convert.
Abhängigen Datenträger über die SLCLI konvertieren
Verwenden Sie dazu den folgenden Befehl.
slcli file 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 file duplicate-convert-status <dependent-vol-id>
Das folgende Beispiel zeigt die erwartete Ausgabe.
slcli file 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 file 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ärvolumens erstellt und anschließend das Duplikatvolumens 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 doppelte Volume jedoch deaktiviert und muss nach Abschluss der Aktualisierung erneut eingebunden werden.
Der Aktualisierungsprozess kann zeitaufwendig sein. Möglicherweise stellen Sie fest, dass Sie neue Daten haben, die Sie dem Duplikat hinzufügen möchten, bevor die aktive Aktualisierung abgeschlossen ist. Wenn dies der Fall ist, können Sie einen
zweiten Aufruf an refreshDuplicate durchführen und den zweiten Parameter forceRefresh als true angeben, um alle laufenden und anstehenden Aktualisierungstransaktionen zu stoppen und eine neue Aktualisierung
einzuleiten. Wenn der zweite Parameter auf false gesetzt oder nicht angegeben ist, schlägt der Aufruf fehl, wenn bereits eine andere Aktualisierung in Bearbeitung 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 künftig 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
- Leerzeichen
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 Duplikate der Volumes gelöscht werden.