Cloud Databases CLI

El plugin de la CLI de Cloud Databases ofrece métodos adicionales para acceder a las prestaciones de los servicios de Cloud Databases. Puede utilizar la CLI Cloud Databases para gestionar y conectarse a los siguientes servicios:

El complemento Cloud Databases CLI requiere que IBM Cloud CLI esté instalado.

El complemento Cloud Databases CLI (cdb) solo es compatible con instancias Gen 1. Para administrar instancias Gen 2, consulte la referencia Cloud Databases de la CLI Gen 2.

La CLI de IBM Cloud

La CLI de IBM Cloud es una herramienta de desarrollador de uso general que proporciona acceso a la cuenta y a los servicios de IBM Cloud mediante una interfaz de línea de mandatos.

Encontrará una introducción e instrucciones de instalación en la página IBM Cloud CLI Getting Started. Si instala la CLI a partir del mandato cURL que se proporciona, obtendrá una selección de plugins y extensiones adicionales para diversos IDE.

Instale el paquete autónomo desde la página Instalación del paquete autónomo IBM Cloud CLI.

El acceso a los servicios a través de la CLI de IBM Cloud se rige por gestión de identidad y acceso (IAM). Para poder utilizar la CLI para ver o gestionar un servicio (o para otorgar privilegios a otro usuario de su cuenta), debe establecer los permisos correctos. Para obtener más información sobre la gestión de IAM, consulte la Guía de aprendizaje de iniciación de IAM

Instalación del plugin de CLI de Cloud Databases

Una vez que tenga la CLI IBM Cloud, inicie sesión e instale el plug-in Cloud Databases, utilizando un comando como:

ibmcloud plugin install cloud-databases

Para obtener una lista de comandos e información de uso, utilice un comando como:

ibmcloud cdb help

ibmcloud cdb help

Por sí solo, el comando ibmcloud cdb help muestra los comandos nivel superior disponibles. Cuando va seguido de otro comando, muestra la ayuda específica de ese comando.

ibmcloud cdb help [<command>]

Opciones de comando

Ninguna opción específica del mandato.

Ejemplos

Obtén ayuda sobre el comando task-show.

ibmcloud cdb help task-show

Primeros pasos - Crear una instancia

Puede crear una instancia utilizando el siguiente 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>"

Opciones de comando

Establezca el grupo de recursos si desea utilizar otro grupo en lugar del grupo predeterminado. También puede omitir este indicador.

Ejemplos

Cree una instancia de 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"

Despliegues y desplegables

Obtenga información sobre las bases de datos desplegables y las versiones de base de datos en la plataforma de Cloud Databases. Además, obtenga una lista de todas las Cloud Databases en su cuenta de IBM Cloud.

ibmcloud cdb deployables-show

Los deployables son las plantillas disponibles para los nuevos despliegues de base de datos. Este mandato muestra los tipos de base de datos desplegables, específicamente las versiones disponibles de las bases de datos y su estado preferido o estable.

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

Versión corta - deployables

Opciones de comando

  • --stable o -s Lista solo las versiones estables de las bases de datos.
  • --preferred o -p Lista solo las versiones preferidas de las bases de datos.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Mostrar todas las versiones estables de bases de datos disponibles.

ibmcloud cdb deployables-show --stable

ibmcloud cdb deployments

Versión corta - ls

Utilice este mandato para listar los despliegues asociados a la cuenta.

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

Opciones de comando

  • --all o -a Muestra el nombre de instancia y el CRN.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Lista todos los despliegues actuales con una cuenta.

ibmcloud cdb ls

ibmcloud cdb deployment-about

Versión corta - about

Utilice este comando para obtener detalles sobre qué base de datos está desplegada en la instancia, qué versión y las opciones aplicadas. También se muestran el ID y el GUID del controlador de recursos, los planes de recursos, el estado actual, el tipo y la última operación conocida.

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

Opciones de comando

  • --all o -a Muestre todos los datos disponibles en los registros del controlador de recursos.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Enumerar los detalles de una implantación denominada "RedisDBOne".

ibmcloud cdb about RedisDBOne

Conexiones

Obtenga las series de conexión y la información de certificado que se utilizarán cuando se conecte a su despliegue. Gestione conexiones para aquellas bases de datos que tienen la opción.

ibmcloud cdb deployment-connections

Versión corta - cxn

Muestra las series de conexión y otros detalles de conexión para un despliegue con o sin las credenciales de usuario insertadas.

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

Opciones de comando

  • --start o -s Inicie una conexión ejecutando el mandato de CLI generado. Si no se especifica una contraseña en los distintivos, el mandato solicita una contraseña de forma interactiva. El plug-in utiliza los mandatos predeterminados para la interacción de línea de mandatos y la gestión del certificado de CA para garantizar una sesión TLS segura. El valor predeterminado es conectarse como usuario administrador del despliegue.
  • --user <userid> o -u Establece el ID de usuario que se utiliza al recuperar los valores de conexión. Se sustituye en las series de conexión. El valor predeterminado es el usuario administrador del despliegue.
  • --password <password> o -p Establece la contraseña que se utiliza al recuperar los valores de conexión. Se sustituye en las series de conexión donde $PASSWORD aparece como valor predeterminado.
  • --endpoint-type [public or private] o -e [public or private] Tipo de punto final para las series de conexión devueltas. Puede ser "público" o "privado". (por defecto: "público"). El tipo de punto final no se impone y solo es para fines de visualización.
  • --all o -a Lista todos los valores de conexión disponibles, incluidos los componentes de las series de conexión.
  • --certroot <path> o -c Utiliza la vía de acceso como raíz de certificado. Si la vía de acceso no existe, se crea automáticamente. Funciona con el distintivo --save. El valor raíz del certificado también se puede establecer en la variable de entorno $CERTROOT.
  • --only [app or cli] o -o Solo muestra los valores que son relevantes para las conexiones de app o las conexiones de cli.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --endpoint-type o -e Tipo de punto final para las cadenas de conexión devueltas, ya sea public o private. Por defecto es public. Como el valor predeterminado es public, si no hay puntos finales public, no se encontrará ninguno y recibirá un error: {"errors":"not_found"}. Utilice el indicador -e private para utilizar los puntos finales de private.

Ejemplos

Muestra cómo conectarse a un despliegue.

ibmcloud cdb deployment-connections MyPSQL

(Muestra una serie de conexión y una serie de mandato de CLI)

Conéctese a un despliegue como administrador.

ibmcloud cdb deployment-connections MyPSQL --start

Si se ejecuta, el plugin solicita la contraseña de administrador y, a continuación, ejecuta la serie de mandato de CLI. El mandato que se utiliza en la serie de mandatos de CLI debe estar instalado.

Muestre todos los detalles sobre cómo realizar una conexión a un despliegue para una combinación de usuario y contraseña determinadas.

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

ibmcloud cdb deployment-cacert

Versión corta - cacert

Muestre el certificado autofirmado que se utiliza para verificar las conexiones TLS/SSL con el despliegue. El resultado es, de forma predeterminada, la salida en la consola pero se puede guardar en un archivo también.

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

Opciones de comando

  • --user <userid> o -u De forma predeterminada, se utiliza el usuario administrativo para obtener el certificado. De forma opcional, este distintivo permite que se especifique a un usuario en el que el despliegue da soporte a los certificados de usuario.
  • --save o -s Guarda el certificado descodificado en el directorio raíz del certificado. El valor predeterminado es $HOME/.cloud/plugins/cdb/cdbcerts/.
  • --certroot <path> o -c Utiliza la vía de acceso como directorio raíz del certificado. Si la vía de acceso no existe, se crea automáticamente. Funciona con el distintivo --save. El valor raíz del certificado también se puede establecer en la variable de entorno $CERTROOT.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Visualice el certificado de una implantación denominada MyPostgreSQL.

ibmcloud cdb deployment-cacert MyPostgreSQL

Guarde un certificado para el mismo despliegue en el directorio actual.

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

Nota: El nombre de archivo se basa en el nombre del certificado.

ibmcloud cdb deployment-kill-connections

Versión corta - kill-connections

Cierra todas las conexiones en un despliegue. Disponible sólo para PostgreSQL.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de creación de usuario. Muestre los detalles de la tarea de creación de usuario y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Este comando elimina todas las conexiones externas a una implantación denominada postgresq-preproduction.

ibmcloud cdb deployment-kill-connections postgresq-preproduction

Prestación

Los comandos capacidad le ayudan a identificar qué funciones están disponibles y son compatibles con sus bases de datos y copias de seguridad.

ibmcloud cdb capability

capability-show

Este comando descubre si una capacidad es compatible con un tipo de base de datos en particular.

Versión corta - cs

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --api-version o -v Versión de la API utilizada para la solicitud.
  • --hostflavor Sabor a anfitrión para la capacidad de grupos.

Opciones de ID de capacidad

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

Ejemplos

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

Este comando descubre si un tipo de base de datos puede restaurarse desde una instancia concreta.

Versión corta - bcs

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --api-version o -v Versión de la API utilizada para la solicitud.

Opciones de ID de capacidad

  • restores

Ejemplos

  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

Este comando descubre si un despliegue o formación en particular soporta una capacidad en particular.

Versión corta - dcs

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --api-version o -v Versión de la API utilizada para la solicitud.
  • --target-platform o -p Plataforma de destino de la solicitud
  • --target-location o -l Lugar de destino de la solicitud

Opciones de ID de capacidad

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

Ejemplos

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

Usuarios

Cree, suprima o cambie la contraseña para los usuarios en el despliegue.

ibmcloud cdb deployment-user-create

Versión corta - user-create

Cree un usuario en la base de datos de despliegue.

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

newusername debe ser un nombre de usuario con formato correcto para utilizarlo en la base de datos del despliegue. newpassword debe cumplir con las reglas de contraseña de la base de datos y debe tener al menos 10 caracteres de longitud.

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de creación de usuario. Muestre los detalles de la tarea de creación de usuario y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Cree un usuario de base de datos llamado "fred" con la contraseña "X1234Y5678" en la implantación "MyPSQL".

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

ibmcloud cdb deployment-user-delete

Versión corta - user-delete

Elimina un usuario existente del despliegue de base de datos especificado.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de supresión de usuario. Muestra los detalles de la tarea de supresión de usuario y sale.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Elimine el usuario de base de datos llamado "fred" de la implantación de "MyPSQL".

ibmcloud cdb deployment-user-delete MyPSQL fred

ibmcloud cdb deployment-user-password

Versión corta - user-password

Cambia la contraseña de un usuario determinado en un despliegue de base de datos especificado.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de cambio de contraseña de usuario. Muestre los detalles de la tarea de cambio de contraseña de usuario y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Cambie la contraseña del usuario "fred" en el despliegue de la base de datos "MyPSQL" a "A9876B5432".

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

Configuración de la base de datos

Enumerar o modificar los parámetros configurables de una implantación. La nueva configuración se especifica en un archivo JSON o una serie JSON de valores. Los ajustes varían según el tipo de base de datos; consulte Modificación de la configuración de la base de datos para PostgreSQL o para Redis.

ibmcloud cdb deployment-configuration-schema

Versión corta - config-schema

Obtiene la configuración por defecto del despliegue especificado.

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

En ibmcloud cdb deployment-configuration-schema se muestra la configuración por defecto. Para verificar un valor de configuración actual, consulte la configuración directamente desde su base de datos.

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --description o -d Muestra la descripción de los valores.

Ejemplos

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

ibmcloud cdb deployment-configuration

Versión corta - configuration

Cambia la configuración del despliegue especificado.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.

Ejemplos

Cambie el max_connections para un despliegue PostgreSQL llamado " PGSettings4 " a 150.

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

Escalado

Recupere y configure los recursos asignados a su despliegue.

ibmcloud cdb deployables-groups-show

Cada despliegue se crea a partir de una plantilla desplegable. El mandato deployables-groups-show muestra el grupo de escalado inicial o predeterminado para un determinado tipo de base de datos. Los nombres de tipo se pueden descubrir a través del mandato deployables-show.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Muestra la configuración de grupo predeterminada para una implantación de base de datos PostgreSQL.

ibmcloud cdb deployables-groups-show postgresql

ibmcloud cdb deployment-groups

Versión corta - groups

Muestra los valores de grupo de escalado para los miembros de un despliegue. Los grupos de escalado se relacionan con la memoria, la CPU y el disco. El grupo predeterminado se denomina "member". Para cada grupo, se muestra el número de nodos que lo componen, seguido de:

  • Memoria- La asignación total de memoria, la asignación por miembro, la asignación mínima y los incrementos con los que se puede variar la memoria total.
  • CPU- El número de CPUs dedicadas al grupo. La sección de CPU muestra 0 valores en todos los campos cuando no se ha configurado ninguna CPU dedicada. El grupo de CPU sólo se muestra cuando es ajustable.
  • Disco- La asignación total de disco, la asignación por miembro, la asignación mínima y los incrementos en los que se puede variar el disco total.
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Visualice la configuración del grupo de escalado para una implantación de base de datos denominada "MyRedis".

ibmcloud cdb deployment-groups MyRedis

ibmcloud cdb deployment-groups-set

Versión corta - groups-set

Establece los valores para los grupos de escalado (consulte deployment-groups). El usuario puede establecer el tamaño total de la memoria en MB o el almacenamiento total de disco en MB, que se dividen uniformemente entre los miembros. Si está disponible, también se puede establecer el número de CPU asignadas.

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

El memberid es el nombre del grupo para el que se deben establecer estos valores. El nombre se puede encontrar mediante el mandato deployment-groups. Normalmente, es "member".

Opciones de comando

  • --memory <memory size> o -m Establezca la memoria total del grupo de despliegue especificado, un valor en MB.
  • --disk <disk size> o -d Establezca el tamaño total de disco del grupo de despliegue especificado, un valor en MB.
  • --cpu <value> o -c Establezca el número de núcleos de CPU dedicados.
  • --hostflavor <val> Establezca el tipo de alojamiento de la base de datos: seleccione entre multitenant para Shared Compute o las selecciones de tamaño individuales para Isolated Compute.
  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.
  • --output o -o FORMATO Resultados como JSON.

Ejemplos

Configure un despliegue PostgreSQL llamado "MyPGSQL" con un grupo "miembro" para que tenga una memoria total de 4096 MB.

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

Regiones

Enumera todas las regiones en las que se pueden realizar despliegues desde la región actual.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • api-version value Versión de la API utilizada para la solicitud.

Ejemplos

Devuelve un JSON de todas las regiones en las que se pueden realizar despliegues desde la región actual.

ibmcloud cdb regions --output, -o FORMAT

Escalado automático

La configuración de escalado automático representa las diversas condiciones que controlan el escalado automático para un despliegue.

ibmcloud cdb deployment-autoscaling

Versión corta - autoscaling

Recupere todas las condiciones de escalado automático para un despliegue determinado.

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

Actualmente el escalado automático sólo se aplica a los miembros de datos en el despliegue, por lo que el GROUP_ID es member.

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

ibmcloud cdb deployment-autoscaling-set

Versión corta - autoscaling-set

Habilite, inhabilite o establezca las condiciones para el escalado automático en el despliegue.

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

Actualmente el escalado automático sólo se aplica a los miembros de datos en el despliegue, por lo que el GROUP_ID es member. Los parámetros de escalado automático que desea establecer o desactivar se definen en un objeto JSON.

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --nowait o -n No espere a que finalice el mandato.

Ejemplos

Este comando configura la memoria para el autoescalado cuando la utilización de E/S alcanza un determinado umbral para una implantación denominada 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"}}}}'

Réplicas de solo lectura

Recupere y configure réplicas de solo lectura. Actualmente, solo los despliegues PostgreSQL dan soporte a réplicas de solo lectura.

ibmcloud cdb deployment-read-replicas

Versión corta - read-replicas

Lista todas las réplicas de sólo lectura para el despliegue especificado.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --long o -l Muestra campos adicionales en la salida.

Ejemplos

Enumere las réplicas de sólo lectura de una implantación de PostgreSQL denominada "MyPGSQL".

ibmcloud cdb deployment-read-replicas MyPGSQL

ibmcloud cdb read-replica-leader

Versión corta - rr-leader

Devuelve el líder para el despliegue de réplica de sólo lectura especificado.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --long o -l Muestra campos adicionales en la salida.

Ejemplos

Enumerar el líder para un despliegue de réplica de sólo lectura PostgreSQL llamado "MyPGSQL-replica".

ibmcloud cdb read-replica-leader MyPGSQL-replica

ibmcloud cdb read-replica-promote

Versión corta - rr-promote

Promueve la réplica de sólo lectura en una instancia autónoma.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --nowait o -n No espere a que finalice el mandato.
  • --skip-initial-backup o s Opción para restaurar la instancia sin realizar una copia de seguridad una vez que se han restaurado los datos. Permite que el despliegue restaurado esté disponible antes.

Ejemplos

Convierte una implantación de réplica de sólo lectura de PostgreSQL denominada "MyPGSQL-replica" en una implantación autónoma.

ibmcloud cdb read-replica-promote MyPGSQL-replica

ibmcloud cdb read-replica-resync

Versión corta - rr-resync

Resincroniza la réplica de sólo lectura.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • --nowait o -n No espere a que finalice el mandato.

Ejemplos

Resincroniza un despliegue de réplica de sólo lectura de PostgreSQL denominado "MyPGSQL-replica".

ibmcloud cdb read-replica-resync MyPGSQL-replica

Copias de seguridad

Gestione las copias de seguridad en el despliegue o realice una copia de seguridad bajo demanda.

ibmcloud cdb deployment-backups-list

Versión corta - backups

Muestra una lista de las copias de seguridad que están asociadas a un despliegue. El resultado es una tabla que se compone del ID, el tipo, el estado y la fecha de creación de las copias de seguridad. Los resultados se ordenan primero con las copias de seguridad más recientes.

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

Opciones de comando

  • --scheduled o -s Genere solo copias de seguridad planificadas.
  • --first o -f Genere sólo la primera copia de seguridad (o más reciente) encontrada.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Muestra las copias de seguridad disponibles en una implantación denominada " Postgres2000 ".

ibmcloud cdb backups Postgres2000

ibmcloud cdb backup-show

Muestre detalles sobre una copia de seguridad. La copia de seguridad se identifica mediante su ID de CRN tal como se muestra en el mandato deployment-backups-list.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Mostrar detalles de una copia de seguridad concreta.

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

Versión corta - backup-now

Inicia una copia de seguridad a petición en la implantación. El mandato sondea la copia de seguridad en ejecución y sale cuando se ha completado.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de copia de seguridad. Muestre los detalles de la tarea de copia de seguridad y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Cree una copia de seguridad de una implantación denominada "PgTips".

ibmcloud cdb deployment-backup-now PgTips

Seguridad

Gestione la lista de IP permitidas para su despliegue.

ibmcloud cdb deployment-allowlist-list

Versión corta - wl-ls

Muestra la lista de actual de elementos permitidos para un despliegue.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Enumera la lista de permisos actual para la implantación de "MyPSQL".

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-add

Versión corta - wl-add

Añada una dirección o un rango de IP a la lista actual de elementos permitidos para un despliegue. Una dirección IP es una dirección IPv4 o IPv6 mientras que un rango es una dirección IPv4 enmascarada, por ejemplo, 1.2.3.0/24. La descripción debe ser una serie que se pueda leer que describa la dirección o el rango de la lista de elementos permitidos.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de adición a la lista de elementos permitidos. Muestre los detalles de la tarea de adición a la lista de elementos permitidos y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Añada la dirección IP 198.51.100.1 a la lista de permisos actual para la implantación de "MyPSQL".

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

Añada el intervalo de IP 198.51.100.0 a 198.51.100.255 a la lista de permisos actual para la implantación "MyPSQL".

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

ibmcloud cdb deployment-allowlist-delete

Versión corta - wl-del

Elimina una dirección o un rango de IP de la lista actual de elementos permitidos para un despliegue. Una dirección IP es una dirección IPv4 o IPv6 mientras que un rango es una dirección IPv4 enmascarada, por ejemplo, 1.2.3.0/24.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de supresión de la lista de elementos permitidos. Visualice los detalles de la tarea de supresión de la lista de elementos permitidos y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Elimine la dirección IP 198.51.100.1 de la lista de permisos actual para la implantación de "MyPSQL".

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

Elimine el intervalo de IP de 198.51.100.0 a 198.51.100.255 de la lista de permisos actual para la implantación de "MyPSQL".

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

Tareas

Las tareas se crean siempre que realice una acción en el despliegue. Las tareas incluyen cosas como realizar una copia de seguridad, escalado de grupo y cambiar una contraseña de usuario. La mayoría de los mandatos cdb sondean la tarea en ejecución y salen cuando se completa. Puede cambiar este comportamiento con el distintivo --nowait, que devuelve información sobre la tarea y sale. Los registros de las tareas satisfactorias aparecen durante 24-48 horas y las tareas no satisfactorias aparecen durante 7-8 días. Un registro histórico de tareas de cualquier periodo de tiempo está disponible a través de la integración de Activity Tracker.

ibmcloud cdb deployment-tasks-list

Versión corta - tasks

Muestra una lista de todas las tareas que se han ejecutado en un despliegue especificado desde que se ha creado. Cada tarea se muestra con su CRN, descripción legible, integridad de porcentaje, estado y fecha de creación.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Muestra una lista de las tareas que se han ejecutado en una implantación denominada "NewRedis".

ibmcloud cdb deployment-tasks-list NewRedis

ibmcloud cdb task-show

Versión corta - task

Muestre el estado de una determinada tarea. La tarea se identifica mediante su ID de CRN tal como se muestra en el mandato deployment-tasks-list. Si la tarea está en ejecución, el mandato espera a que se complete la tarea, informando de los cambios en el estado de los mismos a medida que va sondeando regularmente.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea. Muestre los detalles de la tarea de cambio de contraseña de usuario y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Mostrar detalles de una tarea de copia de seguridad concreta.

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

Realice tareas específicas de los despliegues de Elasticsearch.

ibmcloud cdb elasticsearch file-sync

Versión corta - fs

Sincroniza archivos del índice ibm_file_sync en el disco. Para obtener más información, consulte la documentación en la Carga de archivos en Elasticsearch para obtener más información.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Sincronizar un archivo en el disco en un despliegue llamado "MyElasticsearch".

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

Versión corta - ul

Lista todos los usuarios del almacén interno de credenciales de la base de datos. Para más información, consulte Recuperar y actualizar contraseñas de usuario.

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

Opciones de comando

  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • -c DIRECTORY Certificado raíz
  • --api-version Versión de la API utilizada para la solicitud.

Ejemplos

El comando user-list muestra varias opciones para la lista de usuarios de su cuenta.

ibmcloud cdb elasticsearch user-list

PostgreSQL

Realice tareas específicas de los despliegues de PostgreSQL.

ibmcloud cdb postgresql earliest-pitr-timestamp

Versión corta - ept

Devuelve la hora más temprana disponible para la recuperación en un punto en el tiempo en formato ISO8601 UTC. Para obtener más información, consulte la documentación de Recuperación del punto en el tiempo para obtener más información.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

ibmcloud cdb postgresql replication-slot-create

Versión corta - rsc

Crea una nueva ranura de réplica de PostgreSQL. Para obtener más información, consulte la documentación de Wal2json para obtener más información.

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

El tipo de plug-in debe ser "wal2json".

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Crear una ranura de replicación en un despliegue llamado "MyPostgres", base de datos llamada "testdb", y ranura llamada " slot1 ".

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

ibmcloud cdb postgresql replication-slot-delete

Versión corta - rsd

Suprime la ranura de réplica de PostgreSQL especificada. Consulte la documentación de Wal2json para obtener más información.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.

Ejemplos

Elimina una ranura de replicación en un despliegue denominado "MyPostgres" y una ranura denominada " slot1 ".

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB Empresa

Realizar tareas específicas de las implantaciones de MongoDB Enterprise.

ibmcloud cdb mongodbee earliest-pitr-timestamp

Versión corta - ept

Devuelve la hora más temprana disponible para la recuperación en un punto en el tiempo en formato ISO8601 UTC. Para más información, Recuperación puntual.

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

Opciones de comando

  • --nowait o -n No espere a que se complete la tarea de valor de grupo. Muestre los detalles de la tarea de escalado y salga.
  • --output o -o FORMATO Especifique un formato de salida. Solo se admite JSON.
  • api-version value Versión de la API utilizada para la solicitud.

Ejemplos

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

Redis

Realizar tareas específicas de las implantaciones de Redis.

ibmcloud cdb redis user-set

Edite las funciones de los usuarios de Redis. Para obtener más información, consulte Gestión de Redis RBAC.

ibmcloud cdb redis user-set <"roles">

Ejemplos

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