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.

Bevor Sie beginnen, sollten Sie die folgenden Informationen sammeln:

• Ein eindeutiger Name für den Snapshot. Der Name des Freigabe-Snapshots muss auf der Ebene der Freigabe eindeutig sein. Vorschläge zur Benennung Ihrer Snapshots finden Sie unter Snapshots benennen.
• Der Name oder die ID der Quellfreigabe.
• Alle Tags, die Sie an den Schnappschuss anhängen möchten.

Verwenden Sie die folgenden CLI-Befehle, um die benötigten Informationen zu sammeln.

• ibmcloud is shares- Dieser Befehl listet alle verfügbaren Freigaben in der von Ihnen ausgewählten Region auf. Suchen Sie die Freigabe in der Liste und überprüfen Sie den Status ( available ).
• ibmcloud is share SHARE_ID- Verwenden Sie diesen Befehl mit der Freigabe-ID aus der Ausgabe des vorherigen Befehls, um die Details der Freigabe zu überprüfen. Wenn die Ausgabe zeigt, dass die Freigabe verfügbar, mit einer Instanz verbunden und nicht ausgelastet ist, können Sie einen Snapshot erstellen.

Voraussetzungen für die Erstellung eines Schnappschusses mit der API

Sie können einen Snapshot erstellen, indem Sie die VPC-API aufrufen. Bevor Sie beginnen, sollten Sie die folgenden Informationen sammeln:

• Ein eindeutiger Name für den Snapshot. Der Name des Freigabe-Snapshots muss auf der Ebene der Freigabe eindeutig sein. Vorschläge zur Benennung Ihrer Snapshots finden Sie unter Snapshots benennen.
• Die ID der Quellfreigabe.
• Alle Tags, die Sie an den Schnappschuss anhängen möchten.

Erstellen eines Snapshots über die API

Sie können einen Snapshot einer Dateifreigabe programmatisch erstellen, indem Sie die API-Methode shares/{share-id}/snapshots aufrufen. Das folgende Beispiel erstellt einen Snapshot einer Freigabe unter Verwendung der Freigabe-ID und gibt Benutzer-Tags an, die mit einer Sicherungsrichtlinie verknüpft werden können.

curl -X POST \
"$vpc_api_endpoint/v1/shares/{share-id}/snapshots?version=2024-12-10&generation=2" \
-H "Authorization: Bearer $iam_token"
-d '{
  "name": "my-first-share-snapshot",
  "user_tags": [
    "env:test"
  ]
}'

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus. Der Lebenszyklusstatus des Snapshots lautet während der Erstellung des Snapshots pending. Nach erfolgreicher Erstellung ändert sich der Status in „ stable “.

{
  "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": "pending",
  "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"
  }
}

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