Umbenennen eines Schnappschusses in der Konsole

Führen Sie die folgenden Schritte aus, um einen Snapshot in der Konsole umzubenennen.

1. Rufen Sie die Liste der Snapshots auf. Klicken Sie auf der Seite IBM Cloud konsole auf das Symbol Menü Navigation > Infrastruktur > Speicher > Dateispeicherfreigaben.
2. 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.
3. Wählen Sie die Dateifreigabe aus, die Sie anzeigen möchten, und klicken Sie auf die Registerkarte Snapshots.
4. Suchen Sie den Snapshot in der Liste, klicken Sie auf das Aktionen und wählen Sie Umbenennen.
5. Geben Sie den neuen Namen ein und klicken Sie auf „ Umbenennen “.

Aktualisieren von Benutzer-Tags eines Schnappschusses in der Konsole

Gehen Sie wie folgt vor, um die Benutzer-Tags eines Snapshots in der Konsole zu aktualisieren.

1. Rufen Sie die Liste der Snapshots auf. Klicken Sie auf der Seite IBM Cloud konsole auf das Symbol Menü Navigation > Infrastruktur > Speicher > Dateispeicherfreigaben.
2. 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.
3. Wählen Sie die Dateifreigabe aus, die Sie anzeigen möchten, und klicken Sie auf die Registerkarte Snapshots.
4. Klicken Sie auf den Namen eines Snapshots, um das Snapshot-Detailfenster zu öffnen.
5. Klicken Sie auf das Bearbeiten-Symbol neben den Benutzer-Tags.
6. Sie können vorhandene Tags entfernen und neue Tags hinzufügen. Klicken Sie auf Speichern.

Aktualisieren der Details eines Snapshots über die CLI

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

Benutzer-Tags eines Snapshots über die Befehlszeile aktualisieren

Sie können die Benutzer-Tags, die einem Snapshot zugewiesen sind, über die CLI aktualisieren. Geben Sie den Befehl ibmcloud is share-snapshot-update ein und geben Sie die Snapshot-ID und das neue Tag an.

ibmcloud is share-snapshot-update SHARE SNAPSHOT --tags NEW_TAG1,NEW_TAG2 [--output JSON] [-q, --quiet]

Das folgende Beispiel zeigt, wie ein Benutzer-Tag hinzugefügt wird.

ibmcloud is share-snapshot-update my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags test:cli

Updating file share snapshot share-snapshot-cli-update for share my-file-share under account Test Account as user test.user@ibm.com...
ID                   r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
Name                 share-snapshot-cli-update
Fingerprint          c25fdce4-6e0a-433f-99c0-9985f127cd54
Backup Policy Plan   -
Status               available
Status reasons       Status code   Status message
                     -             -
Created at           2024-12-17T11:19:33+05:30
Captured At          2024-12-17T11:19:34+05:30
CRN                  crn:v1:bluemix:public:is:us-south-1:a/a123456::share-snapshot:r006-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
LifeCycle State      stable
LifeCycle Reasons    Code   Message   More Info
                      -      -
Href                 https://us-south.iaas.cloud.ibm.com/v1/shares/r006-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/snapshots/r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
Minimum Size         40
User Tags            test:cli
Zone                 ID   Name
                          us-south-1
Resource group       ID                                 Name
                     11caaa983d9c4beb82690daab08717e9   Default
Resource type        share_snapshot

Bei Snapshots von regionalen Dateifreigaben ist der Zonenwert sowohl in den CLI- als auch in den API-Antworten leer.

Umbenennen eines Snapshots über die API

Sie können einen Snapshot mit Hilfe der API umbenennen. Rufen Sie die Funktion „ PATCH /shares/{share-id}/snapshots/{snapshot-id} “ auf und geben Sie die Snapshot-ID sowie den neuen Namen des Snapshots an.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "name": "my-snapshot-renamed"
   }'

Aktualisierung von Benutzer-Tags mit der API

Sie können die Benutzer-Tags eines Schnappschusses mit Hilfe der API aktualisieren. Stellen Sie eine Anfrage an PATCH /shares/{share-id}/snapshots/{snapshot-id} und geben Sie die Snapshot-ID und die Tags an, die der Snapshot haben soll.

curl -X PATCH \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
   -H "Authorization: Bearer ${API_TOKEN}" \
   -d '{
     "user_tags": ["env:test","dev:test"]
    }'

Aktualisieren eines Snapshots mit Terraform

Um Terraform zu verwenden, laden Sie die Terraform-CLI herunter und konfigurieren Sie das Plug-in „ IBM Cloud Provider“. 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"
}

Um einen Snapshot zu aktualisieren, verwenden Sie die Ressource ibm_is_share_snapshot. Sie können die Tags des Schnappschusses ändern, indem Sie sie mit dem Argument tags hinzufügen.

resource "ibm_is_share_snapshot" "example" {
  tags          = "dev:test"
  source_share  = ibm_is_share.example.id
  }

Weitere Informationen zu den Argumenten und Attributen finden Sie unter ibm_is_snapshot.

Snapshots in der Konsole löschen

Sie können jeden Snapshot einer Freigabe löschen. Um einen Snapshot löschen zu können, muss er die folgenden Voraussetzungen erfüllen:

• Sie müssen sich im Status stable oder pending befinden.
• Es darf keine aktive Wiederherstellung einer Freigabe stattfinden.

Um festzustellen, ob Sie einen Snapshot löschen können, können Sie in der Konsole die Liste der Snapshots aufrufen und ihren Status überprüfen.

Snapshots über die Befehlszeilenschnittstelle löschen

Sie können jeden Snapshot für eine Freigabe oder alle Snapshots für eine Freigabe löschen. Um einen Snapshot löschen zu können, muss er die folgenden Voraussetzungen erfüllen:

• Sie müssen sich im Status stable oder pending befinden.
• Es darf keine aktive Wiederherstellung einer Freigabe stattfinden.

Gehen Sie wie folgt vor, um einen einzelnen Snapshot über die CLI zu löschen.

1. Listen Sie die Snapshots auf, die für eine Freigabe verfügbar sind, um die ID des Snapshots zu bestätigen, den Sie löschen möchten.

   ibmcloud is share-snapshots SHARE [--output JSON] [-q, --quiet]
   

   ibmcloud is share-snapshots my-file-share
   

2. Führen Sie den Befehl ibmcloud is share-snapshot-delete aus und geben Sie die ID der Momentaufnahme an. Um mehrere Snapshots zu löschen, müssen Sie alle ihre IDs in demselben Befehl angeben.

   ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]
   

3. Bestätigen Sie das Löschen des Snapshots. Die Antwortnachricht gibt an, dass der Snapshot gelöscht wird.

   $ ibmcloud is share-snapshot-delete my-file-share r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
   This will delete share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share and cannot be undone. Continue [y/N] ?> y
   Deleting share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 for share ID my-file-share under account Test Account as user test.user@ibm.com...
   OK
   Share snapshot r006-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 is deleted.
   

Weitere Informationen zu den verfügbaren Befehlsoptionen finden Sie hier, ibmcloud is snapshot-delete.

Snapshots über die API löschen

Sie können jeden Snapshot für eine Freigabe oder alle Snapshots für eine Freigabe löschen. Um einen Snapshot löschen zu können, muss er die folgenden Voraussetzungen erfüllen:

• Sie müssen sich im Status stable oder pending befinden.
• Es darf keine aktive Wiederherstellung einer Freigabe stattfinden.

Rufen Sie die Methode DELETE /shares/{share-id}/snapshots/{snapshot-id} auf, um einen bestimmten Snapshot nach ID zu löschen.

curl -X DELETE \
"$vpc_api_endpoint/v1/shares/r006-0fe9e5d8-0a4d-4818-96ec-e99708644a58/snapshots/r006-e13ee54f-baa4-40d3-b35c-b9ec163972b4?version=2024-12-10&generation=2" \
     -H "Authorization: Bearer ${API_TOKEN}"

Löschen von Snapshots mit Terraform

Sie können jeden Snapshot für eine Freigabe oder alle Snapshots für eine Freigabe löschen. Um einen Snapshot löschen zu können, muss er die folgenden Voraussetzungen erfüllen:

• Sie müssen sich im Status stable oder pending befinden.
• Es darf keine aktive Wiederherstellung einer Freigabe stattfinden.

Verwenden Sie den Befehl terraform destroy, um ein Remote-Objekt wie einen einzelnen Schnappschuss bequem zu löschen. Im folgenden Beispiel wird „ my-snapshot “ gelöscht.

terraform destroy --target ibm_is_snapshot.my-snapshot

Weitere Informationen finden Sie unter Terraforming zerstören.