Cloud Databases CLI

Il plug-in Cloud Databases CLI offre metodi aggiuntivi per accedere alle funzionalità dei servizi Cloud Databases. È possibile utilizzare la CLI di Cloud Databases per gestire e connettersi ai seguenti servizi:

Il Cloud Databases plug-in CLI richiede l'installazione IBM Cloud di CLI.

Il plugin Cloud Databases CLI (cdb) supporta solo istanze Gen 1. Per gestire le istanze Gen 2, consulta il riferimento Cloud Databases CLI Gen 2.

La CLI di IBM Cloud

La CLI di IBM Cloud è uno strumento per sviluppatori di uso generale che consente di accedere all'account e ai servizi di IBM Cloud tramite un'interfaccia a riga di comando.

Un'introduzione e le istruzioni per l'installazione sono disponibili alla pagina Getting Started di IBM Cloud CLI. Se si installa la CLI dal comando cURL che viene fornito, si ottiene una selezione di plug-in ed estensioni extra per più IDE.

Installare il pacchetto stand-alone dalla pagina Installazione della CLI stand-alone IBM Cloud.

L'accesso ai servizi tramite IBM Cloud CLI è regolato da Identity and Access Management. Per utilizzare la CLI per visualizzare o gestire un servizio (o per concedere i privilegi a un altro utente del proprio account), è necessario impostare le autorizzazioni corrette. Per ulteriori informazioni sulla gestione IAM, consultare l'esercitazione "Guida introduttiva a IAM "

Installazione del plugin della CLI Cloud Databases

Una volta ottenuta la CLI di IBM Cloud, effettuare il login e installare il plug-in Cloud Databases, utilizzando un comando come:

ibmcloud plugin install cloud-databases

Per un elenco di comandi e informazioni sull'uso, utilizzare un comando come:

ibmcloud cdb help

ibmcloud cdb help

Da solo, il comando ibmcloud cdb help visualizza i comandi di primo livello disponibili. Se seguito da un altro comando, visualizza la guida specifica per quel comando.

ibmcloud cdb help [<command>]

Opzioni comando

Nessuna opzione specifica per il comando.

Esempi

Ottenere assistenza per il comando task-show.

ibmcloud cdb help task-show

Per iniziare - Creare un'istanza

È possibile creare un'istanza utilizzando il seguente comando:

ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> -g <RESOURCE_GROUP> -p '{"members_host_flavor": "<members_host_flavor value>"}' --service-endpoints="<endpoint>"

Opzioni comando

Impostare il gruppo di risorse se si desidera utilizzare un altro gruppo invece di quello predefinito. È possibile anche omettere questo flag.

Esempi

Creare un'istanza di MongoDB.

ibmcloud resource service-instance-create test-database databases-for-mongodb standard us-south -p '{"members_host_flavor": "multitenant", "members_memory_allocation_mb": "12288"}' --service-endpoints="private"

Implementazioni e implementazioni

Ottenere informazioni sui database distribuibili e sulle versioni dei database sulla piattaforma Cloud Databases. Inoltre, ottenere un elenco di tutti i Cloud Databases sul proprio account IBM Cloud.

ibmcloud cdb deployables-show

deployables sono i modelli disponibili per le nuove implementazioni del database. Questo comando mostra i tipi di database distribuibili, in particolare le versioni disponibili dei database e il loro stato preferito o stabile.

ibmcloud cdb deployables-show [--stable] [--preferred] [--output, -o FORMAT]

Versione breve - deployables

Opzioni comando

  • --stable oppure -s Elencare solo le versioni stabili dei database.
  • --preferred oppure -p Elencare solo le versioni preferite dei database.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Mostra tutte le versioni stabili dei database disponibili.

ibmcloud cdb deployables-show --stable

ibmcloud cdb deployments

Versione breve - ls

Usare questo comando per elencare le distribuzioni associate all'account.

ibmcloud cdb deployments [--all] [--output json]

Opzioni comando

  • --all oppure -a Visualizza il nome dell'istanza e il CRN.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Elenca tutte le distribuzioni correnti con un account.

ibmcloud cdb ls

ibmcloud cdb deployment-about

Versione breve - about

Usare questo comando per ottenere dettagli su quale database è distribuito nell'istanza, quale versione e qualsiasi opzione applicata. Vengono visualizzati anche l'ID e il GUID del controllore delle risorse, i piani delle risorse, lo stato attuale, il tipo e l'ultima operazione nota.

ibmcloud cdb deployment-about <deployment name or CRN> [--all] [--output, -o FORMAT]

Opzioni comando

  • --all oppure -a Visualizza tutti i dati disponibili dai record del controllore di risorse.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Elencare i dettagli di un'installazione client denominata "RedisDBOne".

ibmcloud cdb about RedisDBOne

Connessioni

Ottenere le stringhe di connessione e le informazioni sul certificato da usare quando ci si connette all'installazione client. Gestire le connessioni per i database che hanno questa opzione.

ibmcloud cdb deployment-connections

Versione breve - cxn

Visualizza le stringhe di connessione e altri dettagli di connessione per un'installazione client con o senza credenziali utente inserite.

ibmcloud cdb deployment-connections [--user <userid>] [--password <password>] [--endpoint-type <endpoint type>] [--all] [--only] [--start] [--certroot <path>] [--output, -o FORMAT]

Opzioni comando

  • --start oppure -s Avviare una connessione eseguendo il comando CLI generato. Se la password non è specificata nei flag, il comando richiede la password in modo interattivo. Il plug-in utilizza i comandi predefiniti per l'interazione con la riga di comando e la gestione del certificato CA per garantire una sessione sicura di TLS. L'impostazione predefinita è la connessione come utente amministratore dell'installazione client.
  • --user <userid> oppure -u Imposta l'ID utente utilizzato per recuperare le impostazioni di connessione. Viene sostituita nelle stringhe di connessione. L'impostazione predefinita è l'utente amministratore dell'installazione client.
  • --password <password> oppure -p Imposta la password utilizzata per recuperare le impostazioni di connessione. Viene sostituita nelle stringhe di connessione in cui $PASSWORD compare come valore predefinito.
  • --endpoint-type [public or private] oppure -e [public or private] Tipo di endpoint per le stringhe di connessione restituite. O "pubblico" o "privato". (valore predefinito: "pubblico"). Il tipo di endpoint non viene imposto ed è solo a scopo di visualizzazione.
  • --all oppure -a Elenca tutte le impostazioni di connessione disponibili, compresi i componenti delle stringhe di connessione.
  • --certroot <path> oppure -c Utilizzare il percorso come root del certificato. Se il percorso non esiste, viene creato automaticamente. Funziona con il flag --save. Il valore del certificato root può essere impostato anche nella variabile d'ambiente $CERTROOT.
  • --only [app or cli] oppure -o Mostra solo le impostazioni rilevanti per le connessioni app o cli.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --endpoint-type oppure -e Tipo di endpoint per le stringhe di connessione restituite, public o private. L'impostazione predefinita è public. Poiché l'impostazione predefinita è public, se non ci sono endpoint public non ne verrà trovato nessuno e si riceverà un errore: {"errors":"not_found"}. Utilizzare il flag -e private per utilizzare gli endpoint private.

Esempi

Visualizza come connettersi a un'installazione client.

ibmcloud cdb deployment-connections MyPSQL

(Mostra una stringa di connessione e una stringa di comando CLI)

Collegarsi a un'installazione client come amministratore.

ibmcloud cdb deployment-connections MyPSQL --start

Quando viene eseguito, il plug-in richiede la password di amministrazione, quindi esegue la stringa di comando CLI. Il comando utilizzato nella stringa di comando CLI deve essere installato.

Mostra tutti i dettagli su come effettuare una connessione a un'installazione client per una particolare combinazione di utente e password.

ibmcloud cdb cxn MyPSQL -a -u auser -p auserpassword

ibmcloud cdb deployment-cacert

Versione breve - cacert

Visualizzare il certificato autofirmato utilizzato per verificare le connessioni TLS / SSL all'installazione client. Per impostazione predefinita, il risultato viene inviato alla console, ma può anche essere salvato in un file.

ibmcloud cdb deployment-cacert <deployment name or CRN> [--user <userid>] [--save] [--certroot <path>] [--output, -o FORMAT]

Opzioni comando

  • --user <userid> oppure -u Per impostazione predefinita, l'utente admin viene utilizzato per ottenere il certificato. Questo flag consente di specificare un utente se l'installazione supporta i certificati per utente.
  • --save oppure -s Salvare il certificato decodificato nella directory della radice del certificato. L'impostazione predefinita è $ HOME/.cloud/plugins/cdb/cdbcerts/.
  • --certroot <path> oppure -c Utilizzare il percorso come directory principale del certificato. Se il percorso non esiste, viene creato automaticamente. Funziona con il flag --save. Il valore del certificato root può essere impostato anche nella variabile d'ambiente $CERTROOT.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Visualizzare il certificato per un'installazione client denominata MyPostgreSQL.

ibmcloud cdb deployment-cacert MyPostgreSQL

Salva un certificato per la stessa distribuzione nella directory corrente.

ibmcloud cdb deployment-cacert MyPostgreSQL --save --certroot .

Nota: il nome del file si basa sul nome del certificato.

ibmcloud cdb deployment-kill-connections

Versione breve - kill-connections

Chiude tutte le connessioni di un'installazione client. Disponibile solo per PostgreSQL.

ibmcloud cdb deployment-kill-connections <deployment name or CRN> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di creazione dell'utente. Visualizzare i dettagli dell'attività di creazione dell'utente e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Questo comando elimina tutte le connessioni esterne a un'installazione client denominata postgresq-preproduction.

ibmcloud cdb deployment-kill-connections postgresq-preproduction

Funzionalità

I comandi di capacità aiutano a identificare le funzioni disponibili e supportate per i database e i backup.

ibmcloud cdb capability

capability-show

Questo comando scopre se una funzionalità è supportata per un particolare tipo di database.

Versione breve - cs

ibmcloud cdb capability-show CAPABILITY_ID TYPE VERSION PLATFORM LOCATION TARGET_PLATFORM TARGET_LOCATION [--output, -o FORMAT] [--api-version]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --api-version oppure -v Versione API utilizzata per la richiesta.
  • --hostflavor Sapore di host per la capacità dei gruppi.

Opzioni dell'ID della capacità

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • restores
  • versions

Esempi

ibmcloud cdb capability-show 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e database 3.2.1 IBMCloud us-south

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor multitenant

ibmcloud cdb capability-show groups postgresql 15 classic eu-gb classic us-south --hostflavor b3c.4x16.encrypted

backup-capability-show

Questo comando scopre se un tipo di database può essere ripristinato da una particolare istanza.

Versione breve - bcs

ibmcloud cdb discover-capability-information-from-backup (BACKUP_ID) (CAPABILITY_ID) (TARGET_PLATFORM) (TARGET_LOCATION) [--output, -o FORMAT] [--api-version] [--nowait]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --api-version oppure -v Versione API utilizzata per la richiesta.

Opzioni dell'ID della capacità

  • restores

Esempi

  ibmcloud cdb discover-capability-information-from-backup f7d318b6-6d4e-4d2a-9be4-7c1efbc94a52 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e IBMCloud us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

deployment-capability-show

Questo comando scopre se un particolare schieramento o formazione supporta una particolare capacità.

Versione breve - dcs

ibmcloud cdb deployment-capability-show (NAME|ID) (CAPABILITY_ID) [--target-platform] [--target-location] [--output, -o FORMAT] [--api-version] [--nowait]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --api-version oppure -v Versione API utilizzata per la richiesta.
  • --target-platform oppure -p Piattaforma di destinazione per la richiesta
  • --target-location oppure -l Luogo di destinazione della richiesta

Opzioni dell'ID della capacità

  • autoscaling
  • encryption
  • endpoints
  • groups
  • locations
  • point_in_time_recovery
  • remotes
  • versions

Esempi

ibmcloud cdb deployment-capability-show my-deployment 5f2d37a0-40a5-4a39-bf6a-0dbb1249ac5e --target-location us-south --output, -o FORMAT --api-version 2021-09-30 --nowait

Utenti

Creare, eliminare o modificare la password degli utenti dell'installazione client.

ibmcloud cdb deployment-user-create

Versione breve - user-create

Creare un utente sul database di distribuzione.

ibmcloud cdb deployment-user-create <deployment name or CRN> <newusername> <newpassword> [--nowait] [--output, -o FORMAT]

L'indirizzo newusername deve essere un nome utente formattato correttamente da utilizzare nel database dell'installazione client. L'indirizzo newpassword deve essere conforme alle regole di password del database e deve essere lungo almeno 10 caratteri.

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di creazione dell'utente. Visualizzare i dettagli dell'attività di creazione dell'utente e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Creare un utente del database chiamato "fred" con una password di "X1234Y5678" sul deployment "MyPSQL".

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

ibmcloud cdb deployment-user-delete

Versione breve - user-delete

Rimuove un utente esistente dall'installazione del database specificato.

ibmcloud cdb deployment-user-delete <deployment name or CRN> <username> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di eliminazione dell'utente. Visualizzare i dettagli dell'attività di eliminazione dell'utente e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Rimuovere l'utente del database chiamato "fred" dalla distribuzione "MyPSQL".

ibmcloud cdb deployment-user-delete MyPSQL fred

ibmcloud cdb deployment-user-password

Versione breve - user-password

Modifica la password di un utente nominato su una distribuzione di database specificata.

ibmcloud cdb deployment-user-password <deployment name or CRN> <username> <newpassword> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di modifica della password utente. Visualizzare i dettagli dell'attività di modifica della password utente e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Cambiare la password dell'utente "fred" sul deployment del database "MyPSQL" in "A9876B5432".

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

Configurazione Database

Elencare o modificare le impostazioni configurabili di un'installazione client. La nuova configurazione è specificata in un file JSON o in una stringa JSON di impostazioni. Le impostazioni variano a seconda del tipo di database, vedere Modifica della configurazione del database per PostgreSQL o per Redis.

ibmcloud cdb deployment-configuration-schema

Versione breve - config-schema

Ottiene la configurazione predefinita dell'installazione client specificata.

ibmcloud cdb deployment-configuration-schema <deployment name or CRN> [--description] [--output, -o FORMAT]

Il sito ibmcloud cdb deployment-configuration-schema mostra la configurazione predefinita. Per verificare un valore di configurazione corrente, interrogare la configurazione direttamente dal database.

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --description oppure -d Mostra la descrizione delle impostazioni.

Esempi

ibmcloud cdb deployment-configuration-schema my-redis-cache

ibmcloud cdb deployment-configuration

Versione breve - configuration

Modifica la configurazione dell'installazione client specificata.

ibmcloud cdb deployment-configuration <deployment name or CRN> [@JSON_FILE | JSON_STRING] [--output, -o FORMAT] [--nowait]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.

Esempi

Modificare il valore di max_connections per un'installazione client PostgreSQL denominata " PGSettings4 " in 150.

ibmcloud cdb deployment-configuration PGSettings4 '{"configuration":{"max_connections":150}}'

Ridimensionamento

Recuperare e configurare le risorse assegnate all'installazione client.

ibmcloud cdb deployables-groups-show

Ogni installazione client viene creata da un modello distribuibile. Il comando deployables-groups-show mostra il gruppo di ridimensionamento iniziale o predefinito per un particolare tipo di database. I nomi dei tipi possono essere scoperti tramite il comando deployables-show.

ibmcloud cdb deployables-groups-show <deployable type> [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Mostra le impostazioni di gruppo predefinite per una distribuzione del database PostgreSQL.

ibmcloud cdb deployables-groups-show postgresql

ibmcloud cdb deployment-groups

Versione breve - groups

Visualizza i valori del gruppo di ridimensionamento per i membri di un'installazione client. I gruppi di ridimensionamento si riferiscono a Memoria, CPU e Disco. Il gruppo predefinito si chiama "membro". Per ogni gruppo, viene indicato il numero di nodi che lo compongono, seguito da:

  • Memoria- L'allocazione totale della memoria, l'allocazione per membro, l'allocazione minima e gli incrementi di memoria totale che possono essere variati.
  • CPU- Il numero di CPU dedicate al gruppo. La sezione CPU mostra valori 0 in tutti i campi quando non sono configurate CPU dedicate. Il gruppo CPU viene visualizzato solo quando è regolabile.
  • Disco- L'allocazione totale del disco, l'allocazione per membro, l'allocazione minima e gli incrementi con cui è possibile variare il disco totale.
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Visualizzare le impostazioni del gruppo di ridimensionamento per una distribuzione di database denominata "MyRedis".

ibmcloud cdb deployment-groups MyRedis

ibmcloud cdb deployment-groups-set

Versione breve - groups-set

Imposta i valori per i gruppi di ridimensionamento (vedere gruppi di distribuzione). L'utente può impostare la dimensione totale della memoria in MB o l'archiviazione totale su disco in MB, entrambi suddivisi equamente tra i membri. Se disponibile, è possibile impostare anche il numero di CPU allocate.

ibmcloud cdb deployment-groups-set <deployment name or CRN> <memberid> [--memory <memory size>] [--disk <disk size>] [--cpu <value>] [--hostflavor <val>] [--nowait] [--output, -o FORMAT]

memberid è il nome del gruppo per il quale devono essere impostati questi valori. Il nome può essere trovato tramite il comando deployment-groups. In genere, si tratta di "membro".

Opzioni comando

  • --memory <memory size> oppure -m Imposta la memoria totale del gruppo di distribuzione specificato, un valore in MB.
  • --disk <disk size> oppure -d Imposta la dimensione totale del disco del gruppo di distribuzione specificato, un valore in MB.
  • --cpu <value> oppure -c Impostare il numero di core CPU dedicati.
  • --hostflavor <val> Impostare il tipo di hosting del database: scegliere tra multitenant per Shared Compute o le selezioni delle dimensioni individuali per Isolated Compute.
  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.
  • --output o -o FORMATO Risultati come JSON.

Esempi

Impostare un'installazione client PostgreSQL denominata "MyPGSQL" con un gruppo "membro" per avere una memoria totale di 4096 MB.

ibmcloud cdb deployment-groups-set MyPGSQL member --memory 4096

Regioni

Elenca tutte le regioni in cui è possibile effettuare il provisioning delle distribuzioni a partire dalla regione corrente.

ibmcloud cdb regions [--output, -o FORMAT] [--api-version]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • api-version value Versione API utilizzata per la richiesta.

Esempi

Restituisce un JSON di tutte le regioni in cui è possibile effettuare il provisioning delle distribuzioni a partire dalla regione corrente.

ibmcloud cdb regions --output, -o FORMAT

Ridimensionamento automatico

La configurazione dell'autoscaling rappresenta le varie condizioni che controllano l'autoscaling per un'installazione client.

ibmcloud cdb deployment-autoscaling

Versione breve - autoscaling

Recupera tutte le condizioni di autoscaling per una particolare distribuzione.

ibmcloud cdb deployment-autoscaling <deployment name or CRN> GROUP_ID [--output, -o FORMAT]

Attualmente l'autoscaling si applica solo ai membri dei dati dell'installazione client, quindi GROUP_ID è member.

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

ibmcloud cdb deployment-autoscaling-set

Versione breve - autoscaling-set

Abilitare, disabilitare o impostare le condizioni per l'autoscaling sulla distribuzione.

ibmcloud cdb deployment-autoscaling-set (NAME|ID) GROUP_ID (@JSON_FILE|JSON_STRING) [--output, -o FORMAT] [--nowait]

Attualmente l'autoscaling si applica solo ai membri dei dati dell'installazione client, quindi GROUP_ID è member. I parametri di autoscaling che si desidera impostare o disattivare sono definiti in un oggetto JSON.

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --nowait oppure -n Non attendere il completamento del comando.

Esempi

Questo comando imposta l'autoscala della memoria quando l'utilizzo dell'I/O raggiunge una certa soglia per un'installazione client denominata elasticsearch-preproduction.

ibmcloud cdb deployment-autoscaling-set elasticsearch-preproduction member '{"autoscaling": { "memory": {"scalers": {"io_utilization": {"enabled": true, "over_period": "5m","above_percent": 90}},"rate": {"increase_percent": 10.0, "period_seconds": 300,"limit_mb_per_member": 125952,"units": "mb"}}}}'

Repliche di sola lettura

Recuperare e configurare le repliche di sola lettura. Attualmente, solo le distribuzioni PostgreSQL supportano le repliche di sola lettura.

ibmcloud cdb deployment-read-replicas

Versione breve - read-replicas

Elenca tutte le repliche di sola lettura per l'installazione client specificata.

ibmcloud cdb deployment-read-replicas <deployment name or CRN> [--long] [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --long oppure -l Mostra campi aggiuntivi nell'output.

Esempi

Elencare le repliche di sola lettura per un'installazione client PostgreSQL denominata "MyPGSQL".

ibmcloud cdb deployment-read-replicas MyPGSQL

ibmcloud cdb read-replica-leader

Versione breve - rr-leader

Restituisce il leader per l'installazione di replica di sola lettura specificata.

ibmcloud cdb read-replica-leader <deployment name or CRN> [--long] [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --long oppure -l Mostra campi aggiuntivi nell'output.

Esempi

Elencare il leader per una distribuzione di replica di sola lettura PostgreSQL denominata "MyPGSQL-replica".

ibmcloud cdb read-replica-leader MyPGSQL-replica

ibmcloud cdb read-replica-promote

Versione breve - rr-promote

Promuove la replica di sola lettura a istanza autonoma.

ibmcloud cdb read-replica-promote <deployment name or CRN> [--output, -o FORMAT] [--nowait] [--skip-initial-backup]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --nowait oppure -n Non attendere il completamento del comando.
  • --skip-initial-backup oppure s Possibilità di ripristinare l'istanza senza eseguire un backup una volta ripristinati i dati. Consente di rendere disponibile prima la distribuzione ripristinata.

Esempi

Promuove un'installazione di replica di sola lettura PostgreSQL denominata "MyPGSQL-replica" a un'installazione indipendente.

ibmcloud cdb read-replica-promote MyPGSQL-replica

ibmcloud cdb read-replica-resync

Versione breve - rr-resync

Risincronizza la replica di sola lettura.

ibmcloud cdb read-replica-resync <deployment name or CRN> [--output, -o FORMAT] [--nowait]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • --nowait oppure -n Non attendere il completamento del comando.

Esempi

Risincronizza una distribuzione di replica di sola lettura PostgreSQL denominata "MyPGSQL-replica".

ibmcloud cdb read-replica-resync MyPGSQL-replica

Backup

Gestite i backup sulla vostra installazione o eseguite un backup su richiesta.

ibmcloud cdb deployment-backups-list

Versione breve - backups

Visualizza un elenco di backup associati a un'installazione client. Il risultato è una tabella composta da ID, tipo, stato e data di creazione dei backup. I risultati sono ordinati in base ai backup più recenti.

ibmcloud cdb deployment-backups-list <deployment name or CRN> [--scheduled] [--first] [--output, -o FORMAT]

Opzioni comando

  • --scheduled oppure -s Emette solo i backup pianificati.
  • --first oppure -f Visualizza solo il primo (o il più recente) backup trovato.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Visualizza i backup disponibili su un'installazione client denominata " Postgres2000 ".

ibmcloud cdb backups Postgres2000

ibmcloud cdb backup-show

Mostra i dettagli di un backup. Il backup è identificato dal suo ID CRN, come mostrato dal comando deployment-backups-list.

ibmcloud cdb backup-show <CRN> [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Mostra i dettagli di un particolare backup.

ibmcloud cdb backup-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:ebcea542-8d8c-4b6e-a7d4-922ffd08eb50

ibmcloud cdb deployment-backup-now

Versione breve - backup-now

Avvia un backup su richiesta dell'installazione client. Il comando esegue il polling del backup in corso ed esce al termine.

ibmcloud cdb deployment-backup-now <deployment name or CRN> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di backup. Visualizzare i dettagli dell'attività di backup e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Creare un backup di un'installazione client chiamata "PgTips".

ibmcloud cdb deployment-backup-now PgTips

Sicurezza

Gestire l'elenco dei permessi IP per l'installazione.

ibmcloud cdb deployment-allowlist-list

Versione breve - wl-ls

Visualizza l'elenco dei permessi corrente per un'installazione client.

ibmcloud cdb deployment-allowlist-list <deployment name or CRN> [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Elenca l'elenco dei permessi correnti per l'installazione client "MyPSQL".

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-add

Versione breve - wl-add

Aggiungere un indirizzo IP o un intervallo all'elenco di permessi corrente per un'installazione client. Un indirizzo IP è un indirizzo IPv4 o IPv6 mentre un intervallo è un indirizzo IPv4 mascherato, ad esempio 1.2.3.0/24. La descrizione deve essere una stringa leggibile dall'uomo che descriva l'indirizzo o l'intervallo consentito.

ibmcloud cdb deployment-allowlist-add <deployment name or CRN> <allowlist address or range> <description> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di aggiunta di allowlist. Visualizzare i dettagli dell'operazione allowlist add e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Aggiungere l'indirizzo IP 198.51.100.1 all'attuale allowlist dell'installazione client "MyPSQL".

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.1 "allowlisted for testing"

Aggiungere l'intervallo IP da 198.51.100.0 a 198.51.100.255 alla allowlist corrente per l'installazione client "MyPSQL".

ibmcloud cdb deployment-whitelist-add MyPSQL 198.51.100.0/24 "Testing range is now open"

ibmcloud cdb deployment-allowlist-delete

Versione breve - wl-del

Rimuove un indirizzo IP o un intervallo dall'elenco dei permessi corrente per un'installazione client. Un indirizzo IP è un indirizzo IPv4 o IPv6 mentre un intervallo è un indirizzo IPv4 mascherato, ad esempio 1.2.3.0/24.

ibmcloud cdb deployment-allowlist-delete <deployment name or CRN> <allowlist address or range> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non attendere il completamento dell'attività di eliminazione di allowlist. Visualizzare i dettagli dell'attività di eliminazione di allowlist e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Rimuovere l'indirizzo IP 198.51.100.1 dall'elenco dei permessi corrente per l'installazione client "MyPSQL".

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.1 "allowlisted for testing"

Rimuovere l'intervallo IP da 198.51.100.0 a 198.51.100.255 dall'attuale allowlist per l'installazione client "MyPSQL".

ibmcloud cdb deployment-whitelist-delete MyPSQL 198.51.100.0/24 "Testing range is now open"

Attività

Le attività vengono create ogni volta che si esegue un'azione sull'installazione client. Le attività comprendono ad esempio l'esecuzione di un backup, il ridimensionamento di un gruppo e la modifica della password di un utente. La maggior parte dei comandi di cdb esegue il polling del task in esecuzione ed esce al suo completamento. È possibile modificare questo comportamento con il flag --nowait, che restituisce le informazioni sul task ed esce. Le registrazioni delle attività riuscite vengono visualizzate per 24 - 48 ore, mentre quelle non riuscite per 7 - 8 giorni. L' integrazione con Activity Tracker consente di avere un registro storico delle attività di qualsiasi periodo di tempo.

ibmcloud cdb deployment-tasks-list

Versione breve - tasks

Visualizza un elenco di tutte le attività eseguite su un'installazione client specificata da quando è stata creata. Ogni attività viene visualizzata con il suo CRN, una descrizione leggibile, la percentuale di completamento, lo stato e la data di creazione.

ibmcloud cdb deployment-tasks-list <deployment name or CRN> [--output, -o FORMAT]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Visualizza un elenco dei task eseguiti su un'installazione client denominata "NewRedis".

ibmcloud cdb deployment-tasks-list NewRedis

ibmcloud cdb task-show

Versione breve - task

Mostra lo stato di un'attività particolare. Il task è identificato dal suo ID CRN, come mostrato dal comando deployment-tasks-list. Se il task è in esecuzione, il comando attende il completamento del task, segnalando i cambiamenti di stato durante i sondaggi regolari.

ibmcloud cdb task-show <CRN> [--nowait] [--output, -o FORMAT]

Opzioni comando

  • --nowait oppure -n Non aspettate che il compito venga completato. Visualizzare i dettagli dell'attività di modifica della password utente e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Mostra i dettagli di una particolare attività di backup.

ibmcloud cdb task-show crn:v1:bluemix:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:task:0faea465-de5a-4f14-a5ff-b402fefbd652

Elasticsearch

Eseguire compiti specifici per le implementazioni di Elasticsearch.

ibmcloud cdb elasticsearch file-sync

Versione breve - fs

Sincronizza i file dall'indice ibm_file_sync al disco. Per ulteriori informazioni, consultare la documentazione sul caricamento dei file in Elasticsearch.

ibmcloud cdb elasticsearch file-sync <deployment name or CRN> [--output, -o FORMAT] [--nowait]

Opzioni comando

  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Sincronizzare un file su disco su un'installazione client denominata "MyElasticsearch".

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

Versione breve - ul

Elenca tutti gli utenti dell'archivio credenziali interno del database. Per ulteriori informazioni, vedere Recupero e aggiornamento delle password utente.

ibmcloud cdb elasticsearch user-list (NAME|ID) (ADMIN_PASSWORD) [--output, -o FORMAT] [-c DIRECTORY] [--api-version]

Opzioni comando

  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • -c DIRECTORY Certificato di radice
  • --api-version Versione API utilizzata per la richiesta.

Esempi

Il comando user-list fornisce varie opzioni per l'elenco degli utenti dell'account.

ibmcloud cdb elasticsearch user-list

PostgreSQL

Eseguire compiti specifici per le implementazioni di PostgreSQL.

ibmcloud cdb postgresql earliest-pitr-timestamp

Versione breve - ept

Restituisce il primo orario disponibile per il recupero del punto nel tempo nel formato ISO8601 UTC. Per ulteriori informazioni, consultare la documentazione di Point in Time Recovery.

ibmcloud cdb postgresql earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--nowait]

Opzioni comando

  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

ibmcloud cdb postgresql replication-slot-create

Versione breve - rsc

Crea un nuovo slot di replica PostgreSQL. Per ulteriori informazioni, consultare la Wal2json per ulteriori informazioni.

ibmcloud cdb postgresql replication-slot-create <deployment name or CRN> <databasename> <slotname> <plugintype> [--output, -o FORMAT] [--nowait]

Il tipo di plug-in deve essere " wal2json ".

Opzioni comando

  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Creare uno slot di replica su un'installazione client denominata "MyPostgres", database denominato "testdb" e slot denominato " slot1 ".

ibmcloud cdb postgresql replication-slot-create MyPostgres testdb slot1 wal2json

ibmcloud cdb postgresql replication-slot-delete

Versione breve - rsd

Elimina lo slot di replica PostgreSQL specificato. Per ulteriori informazioni, consultare la Wal2json per ulteriori informazioni.

ibmcloud cdb postgresql replication-slot-delete <deployment name or CRN> <slotname> [--output, -o FORMAT] [--nowait]

Opzioni comando

  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.

Esempi

Elimina uno slot di replica su un'installazione client denominata "MyPostgres" e uno slot denominato " slot1 ".

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB Impresa

Eseguire attività specifiche per le distribuzioni di MongoDB Enterprise.

ibmcloud cdb mongodbee earliest-pitr-timestamp

Versione breve - ept

Restituisce il primo orario disponibile per il recupero del punto nel tempo nel formato ISO8601 UTC. Per ulteriori informazioni, Point in Time Recovery.

ibmcloud cdb mongodb-enterprise earliest-pitr-timestamp <deployment name or CRN> [--output, -o FORMAT] [--nowait]

Opzioni comando

  • --nowait oppure -n Non aspettare il completamento dell'attività di impostazione del gruppo. Visualizzare i dettagli dell'attività di ridimensionamento e uscire.
  • --output o -o FORMATO Specifica un formato di uscita. È supportato solo JSON.
  • api-version value Versione API utilizzata per la richiesta.

Esempi

ibmcloud cdb mongodb earliest-pitr-timestamp (NAME|ID)

Redis

Eseguire compiti specifici per le implementazioni di Redis.

ibmcloud cdb redis user-set

Modificare i ruoli degli utenti di Redis. Per ulteriori informazioni, vedere Gestione di Redis RBAC.

ibmcloud cdb redis user-set <"roles">

Esempi

ibmcloud cdb redis user-set "-all +@read"