Anzeigen von File Storage for VPC Schnappschüssen
Rufen Sie die Snapshot-Listen und -Details von „ File Storage for VPC “ über die Konsole, die Befehlszeilenschnittstelle (CLI), die API oder Terraform ab. Informationen abrufen, darunter Anzahl der Snapshots, Größe, Status und Replikationsrolle.
Auflistung von Momentaufnahmen in der Konsole
In der Konsole können Sie eine Liste aller Snapshots, die zu einer Dateifreigabe gehören, auf der Seite Details der Freigabe anzeigen.
-
Klicken Sie auf der Seite IBM Cloud konsole auf das Symbol Menü Navigation
> Infrastruktur
> Speicher > Dateispeicherfreigaben.
-
Die Dateifreigaben werden für eine bestimmte Region aufgelistet. Wenn Sie Ressourcen in einer anderen Region sehen möchten, klicken Sie auf den Pfeil, um die Liste zu erweitern, und wählen Sie eine andere Region aus. Standardmäßig werden die neuesten Freigaben am Anfang der Liste angezeigt.
-
Wählen Sie die Dateifreigabe aus, die Sie anzeigen möchten, und klicken Sie auf die Registerkarte Snapshots.
Der Abschnitt „Zusammenfassung des Snapshots“ enthält die folgenden Informationen:
Zusammenfassung der Registerkarte Schnappschüsse. Feld Beschreibung Snapshot-Anzahl Die Anzahl der Snapshots, die für die Dateifreigabe erstellt wurden. Größe der geänderten Daten in allen Schnappschüssen Der erste Snapshot ist eine vollständige Kopie Ihrer Dateifreigabe. Nachfolgende Snapshots erfassen die Änderungen, die seit dem letzten Snapshot aufgetreten sind. Dieses Feld zeigt die Gesamtkapazität an, die von den Snapshots genutzt wird.
Verfügbarkeit auswählen In dieser Version der regionalen Dateifreigaben wird bei der Durchführung von Dateifreigabevorgängen mit der Befehlszeilenschnittstelle oder API das Feld für die Snapshot-Größe in der Antwort standardmäßig auf 1 gesetzt, wenn ein Snapshot erstellt wird, und ansonsten auf 0. Dieser Wert entspricht nicht der tatsächlichen Größe des Schnappschusses.Replikationsrolle Diese Rolle entspricht der Replikationsrolle der Quellfreigabe. Der Abschnitt Snapshots enthält die Liste aller Snapshots, die von dieser Quellfreigabe erstellt wurden.
Zusammenfassung der Registerkarte Schnappschüsse. Feld Beschreibung Name Der eindeutige Name des Snapshots, der mit dem Snapshot-Detailfenster verknüpft ist. Größe des Quellanteils Die Größe der Quellfreigabe, als der Snapshot erstellt wurde. Wenn Sie eine Dateifreigabe mit Hilfe dieses Snapshots wiederherstellen, gibt die Größe in diesem Feld die Größe der Dateifreigabe an, die erstellt wird. Status Beispiel: stable.Durch Klicken auf das Symbol Aktionen
Aktionen können Sie ein Menü mit kontextspezifischen Aktionen anzeigen.
Das Menü "Aktionen" ist dynamisch. Wenn die Freigabe eine Replikatfreigabe ist, wird nur die Aktion Wiederherstellen angezeigt. Wenn die Freigabe eine Quellfreigabe ist oder kein Replikat hat, sind alle 3 Aktionen verfügbar.
Anzeigen von Snapshot-Details in der Konsole
Um detaillierte Informationen zu einem Snapshot anzuzeigen, suchen Sie den Snapshot auf der Detailseite der Dateifreigabe. Klicken Sie anschließend auf den Namen eines Snapshots. Im Seitenbereich "Snapshot-Details" werden Informationen wie der Name des Snapshots, seine CRN und ID sowie die zugehörigen Benutzer- und Zugriffsverwaltungs-Tags angezeigt.
Obwohl Sie auf einer Replik-Freigabe keinen Snapshot erstellen können, werden die Snapshots der Quellfreigabe bei der nächsten geplanten Replikationssynchronisierung automatisch auf der Replik generiert. Diese replizierten Snapshots werden vom Dateidienst erstellt. Sie erben weder die Namen noch die Tags der ursprünglichen Schnappschüsse. Sie haben jedoch dieselben Fingerabdruckwerte wie die Quellschnappschüsse.
In der folgenden Tabelle werden die Informationen beschrieben, die in der Detailansicht des Snapshots angezeigt werden können.
| Feld | Beschreibung |
|---|---|
| Name | Der Name des Schnappschusses, den Sie ändern können, indem Sie auf das Symbol Bearbeiten klicken |
| ID | Kopierbare UUID des Snapshots. |
| CRN | Kopierbarer CRN (Custom resource name, angepasster Ressourcenname) des Snapshots. |
| Ressourcengruppe | Die bei der Einrichtung Ihrer VPC-Instanz definierte Ressourcengruppe. |
| Status | Beispiel: stable. |
| Standort | Entspricht dem Speicherort der Quelldateifreigabe. |
| Erstellungsdatum | Der Zeitpunkt (Datum und Uhrzeit), zu dem der Prozess zur Erstellung der Ressourcenmomentaufnahme gestartet wurde. |
| Größe der freigegebenen Quelldatei | Die Größe der Freigabe zum Zeitpunkt der Erstellung des Snapshots in GBs. |
| Quelldatei teilen | Quell-Share, von dem der erste Snapshot erstellt wurde. Klicken Sie auf den Link, um weitere Informationen zu erhalten. |
| Verschlüsselung | Vom Anbieter verwaltete oder vom Kunden verwaltete Verschlüsselung. Bei der vom Kunden verwalteten Verschlüsselung werden die KMS-Instanz, der Name des Stammschlüssels und die Stammschlüssel-ID angezeigt. |
| Fingerabdruck | Die Referenz-ID, die Sie verwenden können, um den Snapshot im Ordner .snapshot zu finden. |
| Benutzertags | Die Tags, die Sie hinzugefügt haben. Dieses Feld ist leer, wenn Sie sich Snapshots auf einer Replikatfreigabe ansehen. |
| Erstellt von | Sie zeigt an, ob der Snapshot vom Benutzer oder von einer Sicherungsrichtlinie erstellt wurde. Das Feld zeigt die Replikation an, wenn Snapshots auf einer Replikatdateifreigabe angezeigt werden. |
Durch Klicken auf das Symbol Aktionen Aktionen können Sie ein Menü mit kontextspezifischen Aktionen anzeigen.
Das Menü "Aktionen" ist dynamisch. Wenn die Freigabe eine Replikatfreigabe ist, wird nur die Aktion Wiederherstellen angezeigt. Wenn die Freigabe eine Quellfreigabe ist oder kein Replikat hat, sind alle 3 Aktionen verfügbar.
Anzeigen von Snapshots über die Befehlszeile
Über die Befehlszeilenschnittstelle (CLI) können Sie alle Snapshots, alle Snapshots einer Freigabe sowie Details zu einem bestimmten Snapshot auflisten.
Obwohl Sie auf einer Replik-Freigabe keinen Snapshot erstellen können, werden die Snapshots der Quellfreigabe bei der nächsten geplanten Replikationssynchronisierung automatisch auf der Replik generiert. Diese replizierten Snapshots werden vom Dateidienst erstellt. Sie erben weder die Namen noch die Tags der ursprünglichen Schnappschüsse. Sie haben jedoch dieselben Fingerabdruckwerte wie die Quellschnappschüsse.
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 unter 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, Ihr Konto auszuwählen. Wenn Sie Zugriff auf mehrere 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.
Anzeigen aller Snapshots in der Region über die CLI
Führen Sie den Befehl ibmcloud is share-snapshots aus, um alle Snapshots anzuzeigen, die in der Zone verfügbar sind.
ibmcloud is share-snapshots [--share SHARE] [--backup-policy-plan BACKUP_POLICY_PLAN [--backup-policy BACKUP_POLICY]] [--output JSON] [-q, --quiet]
ibmcloud is share-snapshots
Listing share snapshots in all resource groups and region au-syd under account Test Account as user test.user@ibm.com...
ID Name Created at Fingerprint Minimum Size Lifecycle state Zone Status User Tags
r026-c8fd81f8-3437-424e-8fc0-f9dd2f4766d3 demo-bkp-plan-2-02ae167865c0-44e8 2024-12-09T16:55:13+05:30 15b9509d-b6f8-461b-987a-2333be203e0e 40 stable au-syd-1 available dev:tags
r026-9997158e-daa6-409d-8e51-b2bbbc23c5d2 demo-bkp-plan-2-29e97584db07-4e86 2024-12-09T16:55:12+05:30 0b9c1e17-d872-4858-b478-a4d46cfd3dfe 40 stable au-syd-1 available dev:tags
r026-d04eb5f7-4159-4fa0-bfdd-83deca3b73b0 demo-bkp-plan-2-2b8c5b1bcadc-496f 2024-12-09T18:55:14+05:30 622a0e1f-7a48-4dce-adf0-c54adb4605c3 40 stable au-syd-1 available dev:tags
r026-9289ba15-a922-4b75-9650-7afc9471e9d9 demo-bkp-plan-2-47a13671bf22-47e0 2024-12-09T17:55:11+05:30 9a433610-0134-4162-8af3-d9358af832b5 40 stable au-syd-1 available dev:tags
r026-bee1b285-adc3-43e6-b8dd-5645efbe5732 demo-bkp-plan-2-4a90deb0778a-4f1a 2024-12-09T17:55:11+05:30 f8ec608d-9fbc-48cf-9018-01b1a8711449 40 stable au-syd-1 available dev:tags
Bei Snapshots von regionalen Dateifreigaben ist der Zonenwert sowohl in den CLI- als auch in den API-Antworten leer.
Für weitere Informationen über die verfügbaren Befehlsoptionen siehe ibmcloud is share-snapshots.
Anzeigen aller Snapshots, die von einer Sicherungsrichtlinie über die CLI erstellt wurden
Führen Sie den Befehl ibmcloud is share-snapshots aus und geben Sie den Sicherungsrichtlinienplan an. Sie können entweder die ID oder den Namen des Sicherungsrichtlinienplans angeben. Wenn Sie den Namen des Sicherungsrichtlinienplans
verwenden möchten, müssen Sie auch die Sicherungsrichtlinie mit ihrem Namen oder ihrer ID angeben.
ibmcloud is share-snapshots [--backup-policy-plan BACKUP_POLICY_PLAN] [--backup-policy BACKUP_POLICY]
Das folgende Beispiel zeigt die Snapshots, die durch den Sicherungsrichtlinienplan mit der ID r006-158e0d66-338e-4501-b756-be0732677da8 erstellt wurden.
ibmcloud is share-snapshots --backup-policy-plan r006-158e0d66-338e-4501-b756-be0732677da8 --share my-file-share
Listing share snapshots of share my-file-share under account Test Account as user test.user@ibm.com...
ID Name Created at Fingerprint Minimum Size LifeCycle State Zone Status User Tags
r006-b4d12d66-18de-4660-9fe7-12e667d5ed5b demo-bkp-plan-1-d619b2fb4a68-4602 2024-11-19T11:33:27+05:30 643ce8da-bbbd-4515-b988-701aea2667df 40 stable us-south-1 available dev:tags
r006-59d25cac-92cd-4076-b988-e5d6746a848f demo-bkp-plan-1-e4406ae16e8f-4cb0 2024-11-19T12:32:23+05:30 202a5bd4-a1e0-4d89-914c-3574f45fc725 40 stable us-south-1 available dev:tags
r006-41785c6b-5d48-4dc1-89b7-21a5b2ada21e demo-bkp-plan-1-efc6f81b8505-4782 2024-11-19T10:32:19+05:30 acd57e05-ffe2-4eed-8e78-40b5000c53d3 40 stable us-south-1 available dev:tags
Für weitere Informationen über die verfügbaren Befehlsoptionen siehe ibmcloud is share-snapshots.
Details zu einem Snapshot über die Befehlszeilenschnittstelle anzeigen
Führen Sie den Befehl ibmcloud is share-snapshot mit der Snapshot-ID oder dem Snapshot-Namen und dem Freigabenamen oder der ID aus. Die Snapshot-IDs sind für das gesamte Konto eindeutig. Snapshot-Namen sind jedoch nur auf Snapshot-Ebene
eindeutig.
ibmcloud is share-snapshot SHARE_SNAPSHOT [--output JSON] [-q, --quiet]
Das folgende Beispiel zeigt die Details eines Snapshots.
ibmcloud is share-snapshot my-file-share r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Getting share snapshot ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd for share ID my-file-share under account Test Account as user test.user@ibm.com...
ID r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Name my-first-share-snapshot
Fingerprint 7f29bdd5-bc67-4e67-9b24-638a73be4742
Backup Policy Plan -
Status available
Created at 2025-03-10T19:17:55+00:00
Captured At 2025-03-10T19:17:58+00:00
CRN crn:v1:bluemix:public:is:us-south-2:a/a1234567::share-snapshot:r006-d14e4b29-cb73-4886-a267-b2cd58d67641/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
LifeCycle Reasons Code Message More Info
- -
LifeCycle State stable
Href https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d14e4b29-cb73-4886-a267-b2cd58d67641/snapshots/r006-6c760e3e-33fc-41a4-b896-8a2c229ddccd
Minimum Size 10
Zone ID Name
us-south-2
Resource group ID Name
6edefe513d934fdd872e78ee6a8e73ef defaults
Status reasons Status code Status message
- -
Resource type share_snapshot
Für weitere Informationen über die verfügbaren Befehlsoptionen siehe ibmcloud is share-snapshot.
Auflistung von Momentaufnahmen über die API
Sie können Ihre Snapshots, die zur gleichen Freigabe gehören, programmatisch auflisten, indem Sie die VPC-API verwenden.
Obwohl Sie auf einer Replik-Freigabe keinen Snapshot erstellen können, werden die Snapshots der Quellfreigabe bei der nächsten geplanten Replikationssynchronisierung automatisch auf der Replik generiert. Diese replizierten Snapshots werden vom Dateidienst erstellt. Sie erben weder die Namen noch die Tags der ursprünglichen Schnappschüsse. Sie haben jedoch dieselben Fingerabdruckwerte wie die Quellschnappschüsse.
Alle Snapshots über die API auflisten
Sie können alle Snapshots Ihrer Freigaben programmatisch auflisten, indem Sie die Methode /shares/{share-id}/snapshots in der VPC-API aufrufen,
wie in der folgenden Beispielanforderung gezeigt. Die Liste zeigt standardmäßig die neuesten Snapshots zuerst an, die in absteigender Reihenfolge von älteren Snapshots gefolgt werden.
curl -X GET \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
Sie können die Liste nach der Plan-ID der Sicherungsrichtlinie filtern, um die Snapshots anzuzeigen, die von einer Sicherungsrichtlinie erstellt wurden. Der folgende Aufruf filtert beispielsweise die Liste so, dass nur Snapshots angezeigt werden, die im Rahmen eines bestimmten Sicherungsplans erstellt wurden, und begrenzt die Anzahl der Ergebnisse auf fünf pro Seite.
curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
"limit": 5,
"backup_policy_plan":
"id": "r006-b470ae68-8325-4a9c-9051-1ade8c3806c3"
}'
Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.
{
"limit": 5,
"snapshots": [
{
"captured_at": "2024-12-10T01:21:12.000Z",
"created_at": "2024-12-10T01:59:46.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"lifecycle_state": "stable",
"minimum_size": 10,
"name": "my-first-share-snapshot",
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
"id": "fee82deba12e4c0fb69c3b09d1f12345",
"name": "Default"
},
"resource_type": "share_snapshot",
"status": "available",
"status_reasons": [],
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
},
{
"captured_at": "2024-12-10T02:21:12.000Z",
"created_at": "2024-12-10T02:59:46.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"fingerprint": "9bbc3aef-c2bc-4f65-a296-2928e534d498",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
"id": "r006-d13ee54f-baa4-40d3-b35c-b9ec163972b4",
"lifecycle_state": "stable",
"minimum_size": 10,
"name": "my-second-share-snapshot",
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
"id": "fee82deba12e4c0fb69c3b09d1f12345",
"name": "Default"
},
"resource_type": "share_snapshot",
"status": "available",
"status_reasons": [],
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
}
],
"total_count": 1
}
Bei Snapshots von regionalen Dateifreigaben ist der Zonenwert sowohl in den CLI- als auch in den API-Antworten leer.
Details zu einem Snapshot über die API abrufen
Sie können die Details eines einzelnen Snapshots programmatisch abrufen, indem Sie die Methode /shares/{share-id}/snapshots/{snapshot-id} in der VPC-API aufrufen und die Freigabe-ID und die Snapshot-ID angeben, wie in der folgenden Beispielanforderung gezeigt.
curl -X GET \
"$vpc_api_endpoint/v1/shares/r006-1fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.
{
"captured_at": "2024-12-10T01:21:12.000Z",
"created_at": "2024-12-10T01:59:46.000Z",
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share-snapshot:r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"fingerprint": "7abc3aef-c2bc-4f65-a296-2928e534d498",
"href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"id": "r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4",
"lifecycle_state": "stable",
"minimum_size": 10,
"name": "my-share-snapshot",
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/fee82deba12e4c0fb69c3b09d1f12345",
"id": "fee82deba12e4c0fb69c3b09d1f12345",
"name": "Default"
},
"resource_type": "share_snapshot",
"status": "available",
"status_reasons": [],
"user_tags": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
},
Bei Snapshots von regionalen Dateifreigaben ist der Zonenwert sowohl in den CLI- als auch in den API-Antworten leer.
Anzeigen von Snapshots mit Terraform
Sie können Terraform verwenden, um Ihre Snapshots anzuzeigen. Um Terraform zu verwenden, laden Sie die Terraform CLI herunter und konfigurieren Sie das IBM Cloud Provider Plug-in. Weitere Informationen finden Sie unter Erste Schritte mit Terraform.
VPC-Infrastrukturdienste verwenden einen bestimmten regionalen Endpunkt, der standardmäßig auf us-south ausgerichtet ist. Wenn Ihre VPC in einer anderen Region erstellt wurde, stellen Sie sicher, dass Sie die entsprechende Region
im Provider-Block in der Datei provider.tf als Ziel angeben.
Siehe das folgende Beispiel für die Ausrichtung auf eine andere Region als die Standardregion us-south.
provider "ibm" {
region = "eu-de"
}
Auflistung aller Snapshots einer Dateifreigabe mit Terraform
Importieren Sie die Details einer Sammlung von Snapshots als schreibgeschützte Datenquelle. Sie können die Sammlung von Schnappschüssen nach source_share, resource_group, name, usw. filtern.
data "ibm_is_snapshots" "example" {
}
Weitere Informationen finden Sie unter ibm_is_snapshots.
Auflistung der Details eines Snapshots mit Terraform
Importieren Sie die Details eines Snapshots als schreibgeschützte Datenquelle. Sie können entweder die Snapshot-ID oder den Snapshot-Namen angeben.
data "ibm_is_share_snapshot" "example" {
share_snapshot = ibm_is_share_snapshot.example.share_snapshot
share = ibm_is_share.example.id
}
Weitere Informationen finden Sie unter ibm_is_share_snapshot.
Nächste Schritte
Sie können Snapshots ändern oder löschen und eine Freigabe aus einem Snapshot wiederherstellen.