CLI IBM Storage Ceph as a Service

Il plug-in IBM Storage Ceph as a Service estende l'interfaccia a riga di comando (CLI) di IBM Cloud per dare la possibilità di eseguire comandi che eseguono varie operazioni per il servizio, tra cui, ma non solo, la gestione di volumi, host, mappature, credenziali degli oggetti e certificati.

Prerequisiti

Prima di poter utilizzare il plug-in IBM Storage Ceph as a Service CLI, è necessario installare IBM Cloud CLI, effettuare il login alla CLI e quindi installare il plug-in software-defined-storage CLI. Per istruzioni su come installare la CLI di “ IBM Cloud ”, consultare la guida “Guida introduttiva alla CLI di “ IBM Cloud ”.

Il plug-in è compatibile con le piattaforme linux64, Windows® e macOS® che funzionano su processori a 64 bit.

Installare il plug-in utilizzando il comando plugin install :

ibmcloud plugin install software-defined-storage

Una volta installato il plug-in, è possibile verificarne l'installazione eseguendo il plug-in "software-defined-storage", che visualizzerà la guida:

ibmcloud software-defined-storage --help

L'output elenca le istruzioni di USAGE e i comandi supportati.

Aggiornamento del plug-in

Aggiorna il plug-in utilizzando il comando plugin update.

ibmcloud plugin update software-defined-storage

L'ultima versione plug-in viene scaricata e sostituisce i comandi di servizio plug-in correnti. Se non sono disponibili nuovi aggiornamenti, viene visualizzato il messaggio No updates are available.

Quando sono disponibili aggiornamenti per la CLI di IBM Cloud e per i plug-in, riceverai una notifica sulla riga di comando. Assicurati di mantenere aggiornata la tua CLI in modo da poter utilizzare i comandi più recenti. Puoi visualizzare la versione corrente di tutti i plugin installati eseguendo ibmcloud plugin list.

Indice dei comandi

Per ogni operazione è presente una descrizione che spiega a cosa serve, come utilizzarla e quali sono i parametri opzionali o obbligatori. A meno che non siano specificati come facoltativi, tutti i parametri elencati sono obbligatori.

Il plug-in CLI non supporta ancora la suite completa di funzionalità disponibili in Software Defined Storage.

storage definito dal software

software-defined-storage- una definizione OpenAPI per la CLI IBM Storage Ceph as a Service sulla piattaforma IBM Cloud.

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

Alias di software-defined-storage: sds

Storage a blocchi

ibmcloud sds volume-create

Utilizza questo comando per creare un nuovo volume con la capacità specificata.

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

Alias di volume-create: volc

Esempio: Creazione di un nuovo volume

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

Esempio: Ripristino di un volume da uno snapshot

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

Quando si ripristina un volume da uno snapshot, la capacità deve essere pari o superiore a quella del volume originale.

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Capacità del volume (in gigabyte).

    • Bandiera: --capacity CAPACITY
  • Nome del volume.

    • Bandiera: --name NAME

    Se non si specifica un nome per il nuovo volume, il sistema genera un nome che è un elenco sillabato di parole selezionate a caso.

  • API Endpoint nel modulo URL.

    • Bandiera: --url string
  • L'istantanea di origine da cui è stato creato il volume.

    • Bandiera: --source-snapshot

    Utilizzare questa opzione se si sta creando il volume da un'istantanea.

  • Identificatore univoco dell'istantanea della risorsa.

    • Bandiera: --source-snapshot-id

    Utilizzare questa opzione se si sta creando il volume da un'istantanea.

ibmcloud sds volume

Utilizza questo comando per recuperare i dettagli relativi a un singolo volume.

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

Alias di volume: vol

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • L'identificatore del volume.

    • Bandiera: --volume-id VOLUME-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds volume-update

Utilizzare questo comando insieme alle nuove informazioni fornite nel parametro "patch volume" per aggiornare la capacità o il nome del volume.

È possibile modificare un solo valore di parametro alla volta nel comando. Non è supportato più di un cambiamento nello stesso comando.

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

Alias di volume-update: volu

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • L'identificatore del volume.

    • Bandiera:--volume-id VOLUME-ID
  • Capacità del volume (in gigabyte).

    • Bandiera: --capacity CAPACITY
  • Nome del volume.

    • Bandiera: --name NAME
  • Oggetto JSON [opzionale] che contiene le informazioni sul volume, come il percorso di un file JSON.

    • Bandiera: --volume-patch VOLUME-PATCH
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds volume-delete

Utilizza questo comando per eliminare un singolo volume.

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

Alias di volume-delete: vold

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • L'identificatore del volume.

    • Bandiera:--volume-id VOLUME-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds volumes

Utilizza questo comando per visualizzare l'elenco di tutti i volumi.

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

Alias di volumes: vols

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Il numero di risorse da restituire in una pagina. Il valore predefinito è 1. Il valore limite massimo è 1000.

    • Bandiera: --limit int
  • Filtra per nome dalla raccolta delle risorse. È possibile specificare una lunghezza della stringa compresa tra 0 e 200 caratteri.

    • Bandiera: --name string

Host

ibmcloud sds host-create

Utilizza questo comando per creare un nuovo host.

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

Alias di host-create: hstc

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Nome qualificato NVMe (NQN) dell'host configurato nell'ambiente del cliente. La lunghezza massima supportata è di 223 byte.

    • Bandiera: --nqn NQN
  • Nome per il nuovo host. Assicurati che il nuovo nome sia univoco.

    • Bandiera: --name NAME

    Se non si specifica un nome per il nuovo host, il sistema genera un nome che è un elenco di parole selezionate casualmente e separate da trattini.

  • PSK per il nuovo host. Le suite di cifratura Transport Layer Security con chiave pre-condivisa ( TLS-PSK) sono un insieme di protocolli crittografici che garantiscono comunicazioni sicure basate su chiavi pre-condivise (PSK).

    • Bandiera: --psk string
  • L'identificatore univoco del volume da mappare su questo host. Deve essere nel formato [{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}].

    • Bandiera: --volume-mappings VOLUME-MAPPINGS
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host

Utilizza questo comando per recuperare i dettagli relativi a un singolo host.

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

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds hosts

Utilizza questo comando per visualizzare l'elenco di tutti gli host.

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

Alias di hosts: hsts

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Numero di risorse da restituire in una pagina.

    • Bandiera: --limit LIMIT
  • Includendo questa opzione si filtra la raccolta di risorse per nome.

    • Bandiera: --name NAME
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-update

Utilizza questo comando per aggiornare un host.

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

Alias di host-update: hstu

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera aggiornare i dettagli

    • Bandiera: --host-id HOST-ID
  • [Opzionale] Specificare il contenuto JSON Merge-Patch per host_update.

    • Bandiera: --host-patch HOST-PATCH
  • Nome per il nuovo host. Assicurati che il nuovo nome sia univoco.

    • Bandiera: --name NAME

    Se non si specifica un nome per il nuovo host, il sistema genera un nome che è un elenco di parole selezionate casualmente e separate da trattini.

  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-mapping-create

Utilizzare questo comando per associare un volume a un host.

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

Alias di host-mapping-create: hstmc

Comando di esempio:

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

O

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Specificare l'ID dell'host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • Specificare l'identificatore di volume univoco.

    • Bandiera: --volume-id VOLUME-ID
  • L'identificatore univoco del volume da mappare su questo host. Deve essere nel formato [{"volume": {"id": "1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}].

    • Bandiera: --volume VOLUME-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-mappings

Utilizza questo comando per visualizzare tutte le mappature relative a un host.

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

Alias di host-mappings: hstms

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-mapping

Utilizza questo comando per visualizzare la mappatura di un singolo host.

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

Alias di host-mapping: hstm

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • Identificatore unico di mappatura del volume. Questo ID può essere trovato visualizzando il volume associato o l'host con cui si desidera completare l'operazione.

    • Bandiera: --volume-mapping-id VOLUME-MAPPING_ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-delete

Utilizza questo comando per eliminare un host.

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

Alias di host-delete: hstd

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-mapping-delete

Utilizzare questo comando per eliminare una singola mappatura di volume da un host.

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

Alias di host-mapping-delete: hstmd

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • Identificatore unico di mappatura del volume. Questo ID può essere trovato visualizzando il volume associato o l'host con cui si desidera completare l'operazione.

    • Bandiera: --volume-mapping-id VOLUME-MAPPING_ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds host-mapping-delete-all

Utilizza questo comando per eliminare tutte le mappature dei volumi associate a un host.

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

Alias di host-vol-delete-all: hstmda

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • ID host di cui si desidera visualizzare i dettagli

    • Bandiera: --host-id HOST-ID
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

Archiviazione oggetti

ibmcloud sds cred-create

Utilizza questo comando per aggiornare le credenziali di un account di archiviazione o per crearle, se non esistono.

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

Alias di cred-create: crc

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Imposta la chiave di accesso per l'istanza di servizio.

    • Bandiera: --access-key ACCESS-KEY
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds cred-delete

Utilizza questo comando per eliminare le credenziali di un servizio.

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

Alias di cred-delete: crd

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Imposta la chiave di accesso per l'istanza di servizio.

    • Bandiera: --access-key ACCESS-KEY
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds creds

Utilizza questo comando per recuperare le credenziali di un account di archiviazione specifico.

ibmcloud sds creds --url string

Alias di creds: crl

Comando di esempio:

ibmcloud sds creds \
    --url $sds_endpoint

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • API Endpoint nel modulo URL.
    • Bandiera: --url string

ibmcloud sds cert-types

Utilizzare questo comando per recuperare l'elenco dei tipi di certificati configurati in SSL.

ibmcloud sds cert-types --url string

Alias di cert-types: crtt

Comando di esempio:

ibmcloud sds cert-types \
    --url $sds_endpoint

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • API Endpoint nel modulo URL.
    • Bandiera: --url string

ibmcloud sds cert-create

Utilizza questo comando per creare un nuovo certificato SSL, qualora non ne esistesse uno.

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

Alias di cert-create: crtc

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Il corpo della richiesta che contiene il certificato TLS. Il CLI accetta file di certificati in formato .pem.

    • Bandiera: --body BODY
  • Il tipo di certificato da utilizzare nella richiesta. I valori ammessi sono: - s3.

    • Bandiera: --cert CERT
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds cert-update

Utilizzare questo comando per aggiornare un certificato SSL esistente.

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

Alias di cert-update: crtu

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Il corpo della richiesta che contiene il certificato TLS. Il CLI accetta file di certificati in formato .pem.

    • Bandiera: --body BODY
  • Il tipo di certificato da utilizzare nella richiesta. I valori ammessi sono: - s3.

    • Bandiera: --cert CERT
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds cert

Utilizza questo comando per recuperare la data di scadenza e lo stato del certificato " SSL ".

ibmcloud sds cert --cert CERT --url string

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Il tipo di certificato da utilizzare nella richiesta. I valori ammessi sono: - s3.

    • Bandiera: --cert CERT
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

ibmcloud sds cert-delete

Utilizzare questo comando per eliminare un certificato SSL.

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

Alias di cert-delete: crtd

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Il tipo di certificato da utilizzare nella richiesta. I valori ammessi sono: - s3.

    • Bandiera: --cert CERT
  • API Endpoint nel modulo URL.

    • Bandiera: --url string

Comandi di istantanea

ibmcloud sds volume-snapshot-create

Utilizza questo comando per creare uno snapshot di un volume.

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

Alias di volume-snapshot-create: vsnapc

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • L'id del volume a blocchi in cui deve essere creata la nuova istantanea.

    • Bandiera: --source-volume-id
  • Nome univoco per lo snapshot. Parametro facoltativo.

    • Bandiera: --name

ibmcloud sds volume-snapshot

Utilizza questo comando per recuperare i dettagli relativi a una singola istantanea.

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

Alias di volume-snapshot: vsnap

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Identificatore dell'istantanea per la quale si desidera recuperare i dettagli.
    • Bandiera: --snap-id

ibmcloud sds volume-snapshots

Utilizza questo comando per visualizzare l'elenco di tutte le istantanee.

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

Alias di volume-snapshots: vsnaps

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

I seguenti parametri sono facoltativi.

  • Specifica l'ID della risorsa da cui avviare la pagina dei risultati. Utile per sfogliare collezioni di grandi dimensioni.

    • Bandiera: --start
  • Imposta il numero massimo di risorse (istantanee) da restituire per pagina...

    • Bandiera: --limit
  • Filtra i risultati per includere solo le istantanee con un nome corrispondente alla stringa fornita.

    • Bandiera: --name
  • Filtra i risultati per includere solo le istantanee che appartengono all'ID del volume sorgente specificato.

    • Bandiera: source-volume-id
  • Quando si elencano le istantanee del volume, questa opzione esegue automaticamente più richieste per recuperare e visualizzare tutte le pagine dei risultati, in modo da visualizzare l'intera raccolta senza dover sfogliare manualmente i risultati.

    • Bandiera: all-pages

ibmcloud sds volume-snapshot-update

Utilizza questo comando per aggiornare uno snapshot.

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

Alias di volume-snapshot-update: vsnapu

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • (Obbligatorio) L'identificatore univoco dell'istantanea che si desidera aggiornare.

    • Bandiera: --snap-id
  • Specifica il nome dello snapshot da aggiornare.

    • Bandiera: --name
  • Fornire il contenuto JSON Merge-Patch per l'aggiornamento dell'istantanea. Può essere una stringa JSON direttamente nel comando o un percorso a un file JSON contenente i dati della patch. Consente di aggiornare campi specifici dell'istantanea.

    • Bandiera: --snapshot-patch

ibmcloud sds volume-snapshot-delete

Utilizza questo comando per eliminare una singola istantanea.

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

Alias di volume-snapshot-delete: vsnapd

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Per forzare l'esecuzione del comando

    • Bandiera: -f, --force
  • Identificatore univoco dell'istantanea che si desidera eliminare.

    • Bandiera: --snap-id

ibmcloud sds volume-snapshots-delete

Utilizza questo comando per eliminare tutte le istantanee di un volume.

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

Alias di volume-snapshots-delete: vsnapsd

Comando di esempio:

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

$sds_endpoint è una variabile d'ambiente che punta all'endpoint fornito al momento della configurazione di IBM Storage Ceph as a Service. È nella forma dell' URL. Ad esempio, https://sds-cephaas.<cephaas-instance-id>.software-defined-storage.appdomain.cloud:{port number}/v1. È possibile impostare l' URL e una volta sola e non doverlo aggiungere per ogni comando. Per indicazioni su come impostare l' URL, vedere Comandi di configurazione.

Parametri da fornire:

  • Per forzare l'esecuzione del comando

    • Bandiera: -f, --force
  • Filtra l'operazione per influenzare solo le risorse (come le istantanee) che hanno una proprietà source_volume-id corrispondente all'identificatore specificato. Si usa per indirizzare tutte le istantanee di un volume specifico.

    • Bandiera: --source-volume-id

Comandi di configurazione

Config Il comando può essere utilizzato per controllare o visualizzare la configurazione persistente delle opzioni globali.

Per controllare o visualizzare le configurazioni persistenti, eseguire il comando ibmcloud sds config con le opzioni globali per elencare, impostare e annullare i valori di configurazione.

È possibile impostare la variabile " url " in modo da non dover utilizzare il flag " --url " quando si utilizza il comando " sds ".

ibmcloud sds config

Esempio di impostazione dell'opzione url.

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

Esempio che mostra come utilizzare il comando senza il config set.

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

L'esempio mostra come utilizzare il comando con l' url.

pc@mac ~ % ibmcloud sds volumes

Opzioni del comando config

  • get- Recupera il valore attualmente impostato di un'opzione.

  • list- Recupera tutti i valori attualmente impostati.

  • set- Impostare un valore di configurazione per un'opzione.

  • unset- Annulla l'impostazione di un'opzione.

ibmcloud sds config get

Utilizza questo comando per recuperare il valore attualmente impostato per un'opzione specifica.

Quando l'opzion Get viene utilizzata insieme all'opzion url, viene recuperato il valore attualmente impostato per l'opzione 'url'.

ibmcloud sds config get url

Vedere l'esempio di output.

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

ibmcloud sds config list

Utilizza questo comando per recuperare e visualizzare tutti i valori configurati attualmente impostati.

ibmcloud sds config list

Vedere l'esempio di output.

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

ibmcloud sds config set

Utilizza questo comando per configurare nuovi valori per un'opzione specifica.

ibmcloud sds config set [url]

Quando l'opzion set viene utilizzata insieme all'opzion url, viene impostato il valore per l'opzione 'url'.

Vedere l'esempio con l'opzione " url ".

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

ibmcloud sds config unset

Utilizzare questo comando per ripristinare i valori attualmente configurati per un'opzione specifica.

ibmcloud sds config unset [url]

Quando l'opzion unset viene utilizzata insieme all'opzion url, il valore attualmente configurato per l'opzione 'url' viene resettato.

Passi successivi

Visita ibmcloud sds --help per maggiori informazioni sui comandi che puoi eseguire.