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
- Bandiera:
-
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.
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
-
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.
- Bandiera:
-
Identificatore univoco dell'istantanea della risorsa.
- Bandiera:
--source-snapshot-id
Utilizzare questa opzione se si sta creando il volume da un'istantanea.
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
Capacità del volume (in gigabyte).
- Bandiera:
--capacity CAPACITY
- Bandiera:
-
Nome del volume.
- Bandiera:
--name NAME
- Bandiera:
-
Oggetto JSON [opzionale] che contiene le informazioni sul volume, come il percorso di un file JSON.
- Bandiera:
--volume-patch VOLUME-PATCH
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
Filtra per nome dalla raccolta delle risorse. È possibile specificare una lunghezza della stringa compresa tra 0 e 200 caratteri.
- Bandiera:
--name string
- Bandiera:
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
- Bandiera:
-
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.
- Bandiera:
-
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
- Bandiera:
-
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
Includendo questa opzione si filtra la raccolta di risorse per nome.
- Bandiera:
--name NAME
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
[Opzionale] Specificare il contenuto JSON Merge-Patch per
host_update.- Bandiera:
--host-patch HOST-PATCH
- Bandiera:
-
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.
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
Specificare l'identificatore di volume univoco.
- Bandiera:
--volume-id VOLUME-ID
- Bandiera:
-
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
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
- Bandiera:
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
- Bandiera:
-
Il tipo di certificato da utilizzare nella richiesta. I valori ammessi sono: - s3.
- Bandiera:
--cert CERT
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
Il tipo di certificato da utilizzare nella richiesta. I valori ammessi sono: - s3.
- Bandiera:
--cert CERT
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
API Endpoint nel modulo URL.
- Bandiera:
--url string
- Bandiera:
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
- Bandiera:
-
Nome univoco per lo snapshot. Parametro facoltativo.
- Bandiera:
--name
- Bandiera:
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
- Bandiera:
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
- Bandiera:
-
Imposta il numero massimo di risorse (istantanee) da restituire per pagina...
- Bandiera:
--limit
- Bandiera:
-
Filtra i risultati per includere solo le istantanee con un nome corrispondente alla stringa fornita.
- Bandiera:
--name
- Bandiera:
-
Filtra i risultati per includere solo le istantanee che appartengono all'ID del volume sorgente specificato.
- Bandiera:
source-volume-id
- Bandiera:
-
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
- Bandiera:
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
- Bandiera:
-
Specifica il nome dello snapshot da aggiornare.
- Bandiera:
--name
- Bandiera:
-
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
- Bandiera:
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
- Bandiera:
-
Identificatore univoco dell'istantanea che si desidera eliminare.
- Bandiera:
--snap-id
- Bandiera:
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
- Bandiera:
-
Filtra l'operazione per influenzare solo le risorse (come le istantanee) che hanno una proprietà
source_volume-idcorrispondente all'identificatore specificato. Si usa per indirizzare tutte le istantanee di un volume specifico.- Bandiera:
--source-volume-id
- Bandiera:
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.