IBM Storage Ceph as a Service-Befehlszeilenschnittstelle (CLI)

Das IBM Storage Ceph as a Service Plug-in erweitert die IBM Cloud Befehlszeilenschnittstelle (CLI), um Ihnen die Möglichkeit zu geben, Befehle auszuführen, die verschiedene Operationen für den Dienst durchführen, einschließlich, aber nicht beschränkt auf die Verwaltung von Volumes, Hosts, Mappings, Objektanmeldeinformationen und Zertifikaten.

Voraussetzungen

Bevor Sie das IBM Storage Ceph as a Service CLI-Plug-in verwenden können, müssen Sie zunächst IBM Cloud CLI installieren, sich bei CLI anmelden und dann das software-defined-storage CLI-Plug-in installieren. Anweisungen zur Installation der „ IBM Cloud “-CLI finden Sie unter „ Erste Schritte mit der „ IBM Cloud “-CLI “.

Das Plug-in ist kompatibel mit den Plattformen „ linux64 “, „Windows®“ und „ macOS® “, die auf 64-Bit-Prozessoren laufen.

Installieren Sie das Plug-in mit dem Befehl „ plugin install “:

ibmcloud plugin install software-defined-storage

Sobald das Plug-in installiert ist, können Sie die Installation überprüfen, indem Sie das „Software-Defined-Storage“-Plug-in ausführen, woraufhin die Hilfe angezeigt wird:

ibmcloud software-defined-storage --help

In der Ausgabe werden die USAGE-Anweisungen und die unterstützten Befehle aufgelistet.

Aktualisierung des Plug-ins

Aktualisieren Sie das Plug-in mit dem Befehl „ plugin update “.

ibmcloud plugin update software-defined-storage

Die neueste Plug-in-Version wird heruntergeladen und ersetzt Ihre aktuellen Plug-in-Dienstbefehle. Wenn keine neuen Updates verfügbar sind, wird die Meldung No updates are available angezeigt.

Sie werden über die Befehlszeile benachrichtigt, sobald Updates für die CLI und die Plug-ins von „ IBM Cloud “ verfügbar sind. Stellen Sie sicher, dass die Befehlszeilenschnittstelle auf dem neuesten Stand ist, damit Sie die aktuellen Befehle nutzen können. Sie können die aktuelle Version aller installierten Plug-ins anzeigen, indem Sie den Befehl ibmcloud plugin list ausführen.

Befehlsindex

Zu jeder Operation gibt es eine Erläuterung, was sie bewirkt, wie sie verwendet wird und welche optionalen oder erforderlichen Parameter es gibt. Sofern nicht ausdrücklich als optional vermerkt, handelt es sich bei allen aufgelisteten Parametern um obligatorische Parameter, deren Angabe verbindlich ist.

Das CLI-Plug-in unterstützt noch nicht alle Funktionen, die in Software Defined Storage verfügbar sind.

software-Defined-Storage

software-defined-storage- eine OpenAPI Definition für die IBM Storage Ceph as a Service CLI auf der IBM Cloud Plattform.

ibmcloud software-defined-storage [command] [options]

Aliasnamen von software-defined-storage: sds

Blockspeicher

`ibmcloud sds volume-create`

Verwenden Sie diesen Befehl, um ein neues Volume mit der angegebenen Kapazität zu erstellen.

ibmcloud sds volume-create --capacity CAPACITY [--name NAME] [--source-snapshot (SOURCE-SNAPSHOT | @SOURCE-SNAPSHOT-FILE) | --source-snapshot-id SOURCE-SNAPSHOT-ID]

Aliasnamen von volume-create: volc

Beispiel: Ein neues Volume erstellen

ibmcloud sds volume-create \
    --capacity 10 \
    --name my-volume \
    --url $sds_endpoint

Beispiel: Wiederherstellen eines Volumes aus einem Snapshot

ibmcloud sds volume-create \
    --name test-volume-restored \
    --source-snapshot-id r134-eda57df4-41f2-48d8-812d-3d81955b6a1a \
    --capacity 10 \
    --url $sds_endpoint

Bei der Wiederherstellung eines Volumes aus einem Snapshot muss die Kapazität mindestens so groß sein wie die des ursprünglichen Volumes.

Bei $sds_endpoint handelt es sich um eine Umgebungsvariable, die auf den Endpunkt verweist, der Ihnen bei der Konfiguration von IBM Storage Ceph as a Service mitgeteilt wurde. Es ist im URL-Formular. Beispiel: https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. Sie können URL einmal festlegen und müssen es dann nicht bei jedem Befehl hinzufügen. Eine Anleitung zum Einrichten von URL finden Sie unter "Config commands ".

Parameter, die angegeben werden müssen:

Kapazität des Datenträgers (in Gigabyte).
- Flag:--capacity CAPACITY
Name des Datenträgers.
- Flag:--name NAME
Wenn Sie keinen Namen für das neue Volume angeben, generiert das System einen Namen, der aus einer mit Bindestrichen versehenen Liste von zufällig ausgewählten Wörtern besteht.
API-Endpunkt im URL-Formular.
- Flag:--url string
Der Quell-Snapshot, aus dem dieser Datenträger erstellt wurde.
- Flag:--source-snapshot
Verwenden Sie diese Option, wenn Sie das Volume aus einem Snapshot erstellen.
Eindeutiger Snapshot-Bezeichner der Ressource.
- Flag:--source-snapshot-id
Verwenden Sie diese Option, wenn Sie das Volume aus einem Snapshot erstellen.

`ibmcloud sds volume`

Verwenden Sie diesen Befehl, um Details zu einem einzelnen Volume abzurufen.

ibmcloud sds volume --volume-id VOLUME-ID --url string

Aliasnamen von volume: vol

Beispielbefehl:

ibmcloud sds volume \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die Datenträgerkennung.
- Flag:--volume-id VOLUME-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds volume-update`

Verwenden Sie diesen Befehl zusammen mit den neuen Informationen, die im Parameter „volume patch“ angegeben sind, um die Kapazität oder den Namen des Volumes zu aktualisieren.

Sie können im Befehl jeweils nur einen Parameterwert ändern. Mehr als eine Änderung in demselben Befehl wird nicht unterstützt.

ibmcloud sds volume-update --volume-id VOLUME-ID [--volume-patch VOLUME-PATCH | @VOLUME-PATCH-FILE] --url string

Aliasnamen von volume-update: volu

Beispielbefehl:

ibmcloud sds volume-update \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --capacity 38 \
    --name my-volume-updated \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die Datenträgerkennung.
- aus:--volume-id VOLUME-ID
Kapazität des Datenträgers (in Gigabyte).
- Flag:--capacity CAPACITY
Name des Datenträgers.
- Flag:--name NAME
[Optionales] JSON-Objekt, das die Volumeninformationen enthält, z. B. den Pfad zu einer JSON-Datei.
- Flag:--volume-patch VOLUME-PATCH
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds volume-delete`

Verwenden Sie diesen Befehl, um ein einzelnes Volume zu löschen.

ibmcloud sds volume-delete --volume-id VOLUME-ID --url string

Aliasnamen von volume-delete: vold

Beispielbefehl:

ibmcloud sds volume-delete \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die Datenträgerkennung.
- aus:--volume-id VOLUME-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds volumes`

Verwenden Sie den hier beschriebenen Befehl, um alle Datenträger aufzulisten.

ibmcloud sds volumes --help [--limit LIMIT] [--name NAME] --url string

Aliasnamen von volumes: vols

Beispielbefehl:

ibmcloud sds volumes --help \
    --limit 10 \
    --name my-volume \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die Anzahl der Ressourcen, die auf einer Seite zurückgegeben werden sollen. Der Standardwert ist 1. Der maximale Grenzwert beträgt 1000.
- Flag:--limit int
Nach Namen aus der Ressourcensammlung filtern. Sie können eine Zeichenfolge mit einer Länge von 0 bis 200 Zeichen angeben.
- Flag:--name string

Hosts

`ibmcloud sds host-create`

Verwenden Sie diesen Befehl, um einen neuen Host anzulegen.

ibmcloud sds host-create --name NAME --nqn NQN [--volume-mappings VOLUME-MAPPINGS | @VOLUME-MAPPINGS-FILE] --url string --psk string

Aliasnamen von host-create: hstc

Beispielbefehl:

ibmcloud sds host-create \
    --name my-host \
    --nqn nqn.2014-06.org:9345 \
    --volume-mappings '[{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}]' \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

NVMe Qualified Name (NQN) des Hosts, der in der Umgebung des Kunden konfiguriert ist. Die maximal unterstützte Länge beträgt 223 Byte.
- Flag:--nqn NQN
Name für den neuen Host. Stellen Sie sicher, dass der neue Name eindeutig ist.
- Flag:--name NAME
Wenn Sie keinen Namen für den neuen Host angeben, generiert das System einen Namen, der aus einer durch Bindestriche getrennten Liste zufällig ausgewählter Wörter besteht.
PSK für den neuen Host. Transport Layer Security-Verschlüsselungssuiten mit vorab geteilten Schlüsseln ( TLS-PSK) sind eine Reihe kryptografischer Protokolle, die eine sichere Kommunikation auf der Grundlage von vorab geteilten Schlüsseln (PSKs) ermöglichen.
- Flag:--psk string
Die eindeutige Kennung des Volumes, das diesem Host zugeordnet werden soll. Muss in der Form [{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}] vorliegen.
- Flag:--volume-mappings VOLUME-MAPPINGS
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host`

Verwenden Sie diesen Befehl, um Details zu einem einzelnen Host abzurufen.

ibmcloud sds host --host-id HOST-ID --url string

Beispielbefehl:

ibmcloud sds host \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds hosts`

Verwenden Sie diesen Befehl, um alle Hosts aufzulisten.

ibmcloud sds hosts [--limit LIMIT] --url string

Aliasnamen von hosts: hsts

Beispielbefehl:

ibmcloud sds hosts \
    --limit 10 \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Anzahl der Ressourcen, die auf einer Seite zurückgegeben werden sollen.
- Flag:--limit LIMIT
Durch die Auswahl dieser Option wird die Sammlung der Ressourcen nach Namen gefiltert.
- Flag:--name NAME
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-update`

Verwenden Sie diesen Befehl, um einen Host zu aktualisieren.

ibmcloud sds host-update --host-id HOST-ID [--host-patch HOST-PATCH | @HOST-PATCH-FILE] --url string

Aliasnamen von host-update: hstu

Beispielbefehl:

ibmcloud sds host-update \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --name my-host
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie aktualisieren möchten
- Flag:--host-id HOST-ID
[Optional] : Geben Sie den Inhalt des JSON-Merge-Patches für host_update an.
- Flag:--host-patch HOST-PATCH
Name für den neuen Host. Stellen Sie sicher, dass der neue Name eindeutig ist.
- Flag:--name NAME
Wenn Sie keinen Namen für den neuen Host angeben, generiert das System einen Namen, der aus einer durch Bindestriche getrennten Liste zufällig ausgewählter Wörter besteht.
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-mapping-create`

Verwenden Sie diesen Befehl, um ein Volume einem Host zuzuordnen.

ibmcloud sds host-mapping-create --host-id HOST-ID [--volume (VOLUME | @VOLUME-FILE) | --volume-id VOLUME-ID]

Aliasnamen von host-mapping-create: hstmc

Beispielbefehl:

ibmcloud sds host-mapping-create \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume '{"id": "r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39"}' \
    --url $sds_endpoint

Oder

ibmcloud sds host-mapping-create \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Geben Sie die Host-ID an, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
Geben Sie die eindeutige Datenträgerkennung an.
- Flag:--volume-id VOLUME-ID
Die eindeutige Kennung des Volumes, das diesem Host zugeordnet werden soll. Muss in der Form [{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}] vorliegen.
- Flag:--volume VOLUME-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-mappings`

Verwenden Sie diesen Befehl, um alle Host-Zuordnungen für einen Host anzuzeigen.

ibmcloud sds host-mappings --host-id HOST-ID

Aliasnamen von host-mappings: hstms

Beispielbefehl:

ibmcloud sds host-mappings \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-mapping`

Verwenden Sie diesen Befehl, um eine einzelne Host-Zuordnung für einen Host anzuzeigen.

ibmcloud sds host-mapping --host-id HOST-ID --volume-mapping-id VOLUME-MAPPING-ID

Aliasnamen von host-mapping: hstm

Beispielbefehl:

ibmcloud sds host-mapping \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume-mapping-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
Eindeutige Kennung für die Volumenabbildung. Diese ID finden Sie, indem Sie entweder das zugehörige Volume oder den Host anzeigen, für den Sie diesen Vorgang durchführen möchten.
- Flag:--volume-mapping-id VOLUME-MAPPING_ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-delete`

Verwenden Sie diesen Befehl, um einen Host zu löschen.

ibmcloud sds host-delete --host-id HOST-ID --url string

Aliasnamen von host-delete: hstd

Beispielbefehl:

ibmcloud sds host-delete \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-mapping-delete`

Verwenden Sie diesen Befehl, um eine einzelne Datenträgerzuordnung von einem Host zu löschen.

ibmcloud sds host-mapping-delete --host-id HOST-ID --volume-mapping-id VOLUME-MAPPING-ID

Aliasnamen von host-mapping-delete: hstmd

Beispielbefehl:

ibmcloud sds host-mapping-delete \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --volume-mapping-id r134-f24710c4-d5f4-4881-ab78-7bfXX6281f39 \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
Eindeutige Kennung für die Volumenabbildung. Diese ID finden Sie, indem Sie entweder das zugehörige Volume oder den Host anzeigen, für den Sie diesen Vorgang durchführen möchten.
- Flag:--volume-mapping-id VOLUME-MAPPING_ID
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds host-mapping-delete-all`

Verwenden Sie diesen Befehl, um alle mit einem Host verknüpften Datenträgerzuordnungen zu löschen.

ibmcloud sds host-mapping-delete-all --host-id HOST-ID

Aliasnamen von host-vol-delete-all: hstmda

Beispielbefehl:

ibmcloud sds host-mapping-delete-all \
    --host-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Host-ID, deren Details Sie anzeigen möchten
- Flag:--host-id HOST-ID
API-Endpunkt im URL-Formular.
- Flag:--url string

Objektspeicher

`ibmcloud sds cred-create`

Verwenden Sie diesen Befehl, um die Anmeldeinformationen für ein Speicherkonto zu aktualisieren oder diese anzulegen, falls sie noch nicht vorhanden sind.

ibmcloud sds cred-create --access-key ACCESS-KEY --url string

Aliasnamen von cred-create: crc

Beispielbefehl:

ibmcloud sds cred-create \
    --access-key mytestkey
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Legt den Zugriffsschlüssel für die Service-Instanz fest.
- Flag:--access-key ACCESS-KEY
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds cred-delete`

Verwenden Sie diesen Befehl, um die Anmeldedaten eines Dienstes zu löschen.

ibmcloud sds cred-delete --access-key ACCESS-KEY --url string

Aliasnamen von cred-delete: crd

Beispielbefehl:

ibmcloud sds cred-delete \
    --access-key mytestkey
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Legt den Zugriffsschlüssel für die Service-Instanz fest.
- Flag:--access-key ACCESS-KEY
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds creds`

Verwenden Sie diesen Befehl, um die Anmeldeinformationen für ein bestimmtes Speicherkonto abzurufen.

ibmcloud sds creds --url string

Aliasnamen von creds: crl

Beispielbefehl:

ibmcloud sds creds \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds cert-types`

Verwenden Sie diesen Befehl, um die Liste der konfigurierten Zertifikatstypen von „ SSL “ abzurufen.

ibmcloud sds cert-types --url string

Aliasnamen von cert-types: crtt

Beispielbefehl:

ibmcloud sds cert-types \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds cert-create`

Verwenden Sie diesen Befehl, um ein neues „ SSL “-Zertifikat zu erstellen, falls noch keines vorhanden ist.

ibmcloud sds cert-create --cert CERT --body BODY --url string

Aliasnamen von cert-create: crtc

Beispielbefehl:

ibmcloud sds cert-create \
    --cert s3 \
    --body tempdir/test-file.txt \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Der Request-Body, der das „ TLS “-Zertifikat enthält. Das CLI akzeptiert Zertifikatsdateien im .pem-Format.
- Flag:--body BODY
Die Art der Bescheinigung, die in der Anfrage verwendet werden soll. Zulässige Werte sind unter anderem - s3.
- Flag:--cert CERT
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds cert-update`

Verwenden Sie diesen Befehl, um ein vorhandenes „ SSL “-Zertifikat zu aktualisieren.

ibmcloud sds cert-update --cert CERT --body BODY --url string

Aliasnamen von cert-update: crtu

Beispielbefehl:

ibmcloud sds cert-update \
    --cert s3 \
    --body tempdir/test-file.pem \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Der Request-Body, der das „ TLS “-Zertifikat enthält. Das CLI akzeptiert Zertifikatsdateien im .pem-Format.
- Flag:--body BODY
Die Art der Bescheinigung, die in der Anfrage verwendet werden soll. Zulässige Werte sind unter anderem - s3.
- Flag:--cert CERT
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds cert`

Verwenden Sie diesen Befehl, um das Ablaufdatum und den Status des Zertifikats „ SSL “ abzurufen.

ibmcloud sds cert --cert CERT --url string

Beispielbefehl:

ibmcloud sds cert \
    --cert s3
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die Art der Bescheinigung, die in der Anfrage verwendet werden soll. Zulässige Werte sind unter anderem - s3.
- Flag:--cert CERT
API-Endpunkt im URL-Formular.
- Flag:--url string

`ibmcloud sds cert-delete`

Verwenden Sie diesen Befehl, um ein „ SSL “-Zertifikat zu löschen.

ibmcloud sds cert-delete --cert CERT --url string

Aliasnamen von cert-delete: crtd

Beispielbefehl:

ibmcloud sds cert-delete \
    --cert s3
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die Art der Bescheinigung, die in der Anfrage verwendet werden soll. Zulässige Werte sind unter anderem - s3.
- Flag:--cert CERT
API-Endpunkt im URL-Formular.
- Flag:--url string

Schnappschuss-Befehle

`ibmcloud sds volume-snapshot-create`

Verwenden Sie diesen Befehl, um einen Snapshot eines Volumes zu erstellen.

ibmcloud sds volume-snapshot-create [--source-volume (SOURCE-VOLUME | @SOURCE-VOLUME-FILE) | --source-volume-id SOURCE-VOLUME-ID] [--name NAME]

Aliasnamen von volume-snapshot-create: vsnapc

Beispielbefehl:

ic sds volume-snapshot-create --source-volume-id r134-87a59338-a801-4090-a657-72867fc9ba44

Parameter, die angegeben werden müssen:

Die Block-Volume-ID, auf der der neue Snapshot erstellt werden muss.
- Flag:--source-volume-id
Eindeutiger Name für den Snapshot. Optionaler Parameter.
- Flag:--name

`ibmcloud sds volume-snapshot`

Verwenden Sie diesen Befehl, um Details zu einem einzelnen Snapshot abzurufen.

ibmcloud sds volume-snapshot --snap-id SNAP-ID

Aliasnamen von volume-snapshot: vsnap

Beispielbefehl:

ibmcloud sds volume-snapshot \
    --snap-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Kennung des Snapshots, für den Sie die Details abrufen möchten.
- Flag:--snap-id

`ibmcloud sds volume-snapshots`

Verwenden Sie diesen Befehl, um alle Snapshots aufzulisten.

ibmcloud sds volume-snapshots [--start START] [--limit LIMIT] [--name NAME] [--source-volume-id SOURCE-VOLUME-ID]

Aliasnamen von volume-snapshots: vsnaps

Beispielbefehl:

ibmcloud sds volume-snapshots \
    --start r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --limit 20 \
    --name my-host \
    --source-volume-id exampleString \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

Die folgenden Parameter sind optional:

Gibt die Ressourcen-ID an, ab der die Ergebnisseite beginnen soll. Nützlich zum Paginieren in großen Sammlungen.
- Flag:--start
Legt die maximale Anzahl von Ressourcen (Schnappschüssen) fest, die pro Seite zurückgegeben werden sollen.
- Flag:--limit
Filtert die Ergebnisse so, dass nur Schnappschüsse mit einem Namen enthalten sind, der der angegebenen Zeichenfolge entspricht.
- Flag:--name
Filtert die Ergebnisse so, dass nur Snapshots enthalten sind, die zu der angegebenen Quellvolume-ID gehören.
- Flag:source-volume-id
Bei der Auflistung von Datei-Überblicken werden mit dieser Option automatisch mehrere Anfragen gestellt, um alle Ergebnisseiten abzurufen und anzuzeigen, so dass Sie die gesamte Sammlung sehen, ohne manuell durch die Ergebnisse blättern zu müssen.
- Flag:all-pages

`ibmcloud sds volume-snapshot-update`

Verwenden Sie diesen Befehl, um einen Snapshot zu aktualisieren.

ibmcloud sds volume-snapshot-update --snap-id SNAP-ID [--snapshot-patch SNAPSHOT-PATCH | @SNAPSHOT-PATCH-FILE]

Aliasnamen von volume-snapshot-update: vsnapu

Beispielbefehl:

ibmcloud sds volume-snapshot-update \
    --snap-id r134-69d5c3e2-8229-45f1-89c8-e4dXXb2e126e \
    --name snap-2-updated \
    --url $sds_endpoint

Parameter, die angegeben werden müssen:

(Erforderlich) Der eindeutige Bezeichner des Snapshots, den Sie aktualisieren möchten.
- Flag:--snap-id
Gibt den Namen des Snapshots an, der aktualisiert werden muss.
- Flag:--name
Geben Sie den JSON-Merge-Patch-Inhalt für die Aktualisierung des Snapshots an. Dies kann eine JSON-Zeichenkette direkt im Befehl oder ein Pfad zu einer JSON-Datei sein, die die Patch-Daten enthält. Damit können Sie bestimmte Felder des Schnappschusses aktualisieren.
- Flag:--snapshot-patch

`ibmcloud sds volume-snapshot-delete`

Verwenden Sie diesen Befehl, um einen einzelnen Snapshot zu löschen.

ibmcloud sds volume-snapshot-delete --snap-id SNAP-ID

Aliasnamen von volume-snapshot-delete: vsnapd

Beispielbefehl:

ibmcloud sds volume-snapshot-delete \
    --snap-id r134-76a4e08c-aa22-4fd3-9eb5-5cae0e78a285 \
    --url $sds_endpoint
Are you sure you want to delete? [y/n]> y
...
OK

Parameter, die angegeben werden müssen:

Um die Ausführung des Befehls zu erzwingen
- Flagge: -f, --force
Eindeutige Kennung des Snapshots, den Sie löschen möchten.
- Flag:--snap-id

`ibmcloud sds volume-snapshots-delete`

Verwenden Sie diesen Befehl, um alle Snapshots eines Volumes zu löschen.

ibmcloud sds volume-snapshots-delete [--source-volume-id SOURCE-VOLUME-ID]

Aliasnamen von volume-snapshots-delete: vsnapsd

Beispielbefehl:

ibmcloud sds volume-snapshots-delete \
    --source-volume-id r134-76a4e08c-aa22-4fd3-9eb5-5cae0e78a285 \
    --url $sds_endpoint
Are you sure you want to delete? [y/n]> y
...
OK

Parameter, die angegeben werden müssen:

Um die Ausführung des Befehls zu erzwingen
- Flagge: -f, --force
Filtert den Vorgang so, dass er sich nur auf Ressourcen (z. B. Snapshots) auswirkt, deren Eigenschaft source_volume-id mit dem angegebenen Bezeichner übereinstimmt. Wird verwendet, um alle Snapshots für ein bestimmtes Volume anzuvisieren.
- Flag:--source-volume-id

Konfigurationsbefehle

Config Command kann zur Steuerung oder Anzeige der dauerhaften Konfiguration globaler Optionen verwendet werden.

Um dauerhafte Konfigurationen zu kontrollieren oder anzuzeigen, führen Sie den Befehl ibmcloud sds config zusammen mit den globalen Optionen aus, um die Konfigurationswerte aufzulisten, zu setzen oder zu löschen.

Sie können die Variable url so einstellen, dass Sie bei Verwendung mit dem Befehl sds das Flag --url nicht verwenden müssen.

ibmcloud sds config

Beispiel für die Einstellung der URL-Option.

pc@mac ~ % ibmcloud sds config set url http://sds-endpoint.satellite.cloud.ibm.com:33189/v1
OK

Beispiel, das zeigt, wie der Befehl ohne den Config-Satz verwendet wird.

pc@mac ~ % ibmcloud sds volumes --url $endpoint

Das Beispiel zeigt, wie der Befehl mit dem konfigurierten url verwendet wird.

pc@mac ~ % ibmcloud sds volumes

Optionen für den Befehl "Config"

get- Ruft den aktuell eingestellten konfigurierten Wert einer Option ab.
list- Ruft alle aktuell eingestellten konfigurierten Werte ab.
set- Einen Konfigurationswert für eine Option festlegen.
unset- Den Konfigurationswert einer Option zurücksetzen.

`ibmcloud sds config get`

Verwenden Sie diesen Befehl, um den aktuell eingestellten Wert für eine bestimmte Option abzurufen.

Wenn die Option Get zusammen mit der Option url verwendet wird, wird der aktuell eingestellte Wert für die Option "url" abgerufen.

ibmcloud sds config get url

Siehe Beispielausgabe.

pc@mac ~ % ibmcloud sds config get url
http://sds-endpoint.satellite.cloud.ibm.com:33189/v1

`ibmcloud sds config list`

Verwenden Sie diesen Befehl, um alle derzeit festgelegten Konfigurationswerte abzurufen und anzuzeigen.

ibmcloud sds config list

Siehe Beispielausgabe.

pc@mac ~ % ibmcloud sds config list
url
http://sds-endpoint.satellite.cloud.ibm.com:33189/v1

`ibmcloud sds config set`

Verwenden Sie diesen Befehl, um neue Werte für eine bestimmte Option festzulegen.

ibmcloud sds config set [url]

Wenn die Option set zusammen mit der Option url verwendet wird, wird der Wert für die Option "url" festgelegt.

Siehe Beispiel mit der Option url.

pc@mac ~ % ibmcloud sds config set url http://sds-endpoint.satellite.cloud.ibm.com:33189/v1

`ibmcloud sds config unset`

Verwenden Sie diesen Befehl, um die aktuell konfigurierten Werte für eine bestimmte Option zurückzusetzen.

ibmcloud sds config unset [url]

Wenn die Option " unset " zusammen mit der Option " url " verwendet wird, wird der aktuell konfigurierte Wert für die Option "url" zurückgesetzt.

Nächste Schritte

Rufen Sie ibmcloud sds --help auf, um weitere Informationen darüber zu erhalten, welche Befehle Sie ausführen können.