Cloud Databases CLI

Le plug-in de l'interface de ligne de commande de Cloud Databases offre des méthodes supplémentaires d'accès aux capacités des services Cloud Databases. Vous pouvez utiliser le CLI de Cloud Databases pour gérer les services suivants et vous y connecter :

Le Cloud Databases plug-in CLI nécessite l'installation IBM Cloud de CLI.

Le Cloud Databases plug-in CLI (cdb) prend uniquement en charge les instances Gen 1. Pour gérer les instances Gen 2, consultez la référence Cloud Databases CLI Gen 2.

Interface de ligne de commande d'IBM Cloud

L'interface de ligne de commande d'IBM Cloud est un outil de développement d'usage général qui fournit l'accès à votre compte et à vos services IBM Cloud via une interface de ligne de commande.

Une introduction et des instructions d'installation sont disponibles sur la page IBM Cloud CLI Getting Started. Si vous installez l'interface de ligne de commande à partir de la commande cURL fournie, vous obtenez une sélection de plug-in et d'extensions supplémentaires pour plusieurs environnements IDE.

Installez le paquetage autonome à partir de la page Installation du CLI IBM Cloud autonome.

L'accès aux services via l'interface de ligne de commande d'IBM Cloud est régi par Identity and Access Management. Pour utiliser l'interface de ligne de commande afin d'afficher ou de gérer un service (ou pour accorder des privilèges à un autre utilisateur sur votre compte), vous devez définir les droits appropriés. Pour plus d'informations sur la gestion IAM, voir le tutoriel d'initiation à IAM.

Installation du plug-in d'interface de ligne de commande de Cloud Databases

Une fois que vous avez le CLI IBM Cloud, connectez-vous et installez le plug-in Cloud Databases, en utilisant une commande comme :

ibmcloud plugin install cloud-databases

Pour obtenir une liste des commandes et des informations sur leur utilisation, utilisez une commande telle que :

ibmcloud cdb help

ibmcloud cdb help

La commande ibmcloud cdb help affiche à elle seule les commandes de premier niveau disponibles. Lorsqu'elle est suivie d'une autre commande, elle affiche l'aide spécifique à cette commande.

ibmcloud cdb help [<command>]

Options de commande

Aucune option spécifique à la commande.

Exemples

Obtenir de l'aide sur la commande task-show.

ibmcloud cdb help task-show

Mise en route - Créer une instance

Vous pouvez créer une instance en utilisant la commande suivante :

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>"

Options de commande

Définissez le groupe de ressources si vous souhaitez utiliser un autre groupe au lieu du groupe par défaut. Vous pouvez également omettre ce drapeau.

Exemples

Créer une instance 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"

Déploiement et déployables

Obtenez des informations sur les bases de données et les versions de base de données déployables sur la plateforme Cloud Databases. Obtenez également la liste de toutes les bases de données Cloud Databases sur votre compte IBM Cloud.

ibmcloud cdb deployables-show

Les deployables sont les modèles disponibles pour les nouveaux déploiements de base de données. Cette commande affiche des types de base de données déployables, notamment les versions disponibles des bases de données, ainsi que leur statut (stable ou préféré).

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

Version courte : deployables

Options de commande

  • --stable ou -s Répertoriez uniquement les versions stables des bases de données.
  • --preferred ou -p Répertoriez uniquement les versions préférées des bases de données.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Afficher toutes les versions stables des bases de données disponibles.

ibmcloud cdb deployables-show --stable

ibmcloud cdb deployments

Version courte : ls

Utilisez cette commande pour répertorier les déploiements associés au compte.

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

Options de commande

  • --all ou -a Affichez le nom de l'instance et le nom de ressource de cloud.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Liste de tous les déploiements en cours avec un compte.

ibmcloud cdb ls

ibmcloud cdb deployment-about

Version courte : about

Utilisez cette commande pour obtenir des détails sur la base de données déployée dans l'instance, sa version et les options appliquées. L'ID et l'identificateur global unique (GUID) du contrôleur de ressources, les plans de ressources, l'état en cours, le type et la dernière opération connue sont également affichés.

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

Options de commande

  • --all ou -a Affichez toutes les données disponibles à partir des enregistrements du contrôleur de ressources.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Liste des détails d'un déploiement nommé "RedisDBOne".

ibmcloud cdb about RedisDBOne

Connexions

Obtenez les chaînes de connexion et les informations de certificat à utiliser lors de la connexion à votre déploiement. Gérez les connexions pour les bases de données qui le permettent.

ibmcloud cdb deployment-connections

Version courte : cxn

Affiche les chaînes de connexion et d'autres détails de connexion pour un déploiement avec ou sans insertion de données d'identification utilisateur.

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

Options de commande

  • --start ou -s Démarrez une connexion en exécutant la commande d'interface de ligne de commande générée. Si aucun mot de passe n'est spécifié dans les indicateurs, la commande vous invite à entrer un mot de passe de façon interactive. Le plug-in utilise les commandes par défaut pour l'interaction de ligne de commande et la gestion du certificat de l'autorité de certification afin de garantir une session TLS sécurisée. Par défaut, la connexion est établie en tant qu'administrateur du déploiement.
  • --user <userid> ou -u Définit l'ID utilisateur à indiquer lors de l'extraction des paramètres de connexion. Il est remplacé dans les chaînes de connexion. La valeur par défaut est l'administrateur du déploiement.
  • --password <password> ou -p Définit le mot de passe qui est utilisé lors de l'extraction des paramètres de connexion. Il est remplacé dans les chaînes de connexion, où $PASSWORD apparaît par défaut.
  • --endpoint-type [public or private] ou -e [public or private] Type de noeud final pour les chaînes de connexion renvoyées. Soit "public", soit "privé". (par défaut : "public"). Le type de noeud final n'est pas appliqué et est destiné à l'affichage uniquement.
  • --all ou -a Répertorie tous les paramètres de connexion disponibles, y compris les composantes des chaînes de connexion.
  • --certroot <path> ou -c Utilisez le chemin comme racine de certificat. S'il n'existe pas, il est créé automatiquement. Fonctionne avec l'indicateur --save. La valeur de la racine de certificat peut également être définie dans la variable d'environnement $CERTROOT.
  • --only [app or cli] ou -o Affichez uniquement les paramètres qui sont pertinents pour les connexions app ou les connexions cli.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --endpoint-type ou -e Type d'extrémité pour les chaînes de connexion renvoyées, soit public ou private. La valeur par défaut est public. Comme la valeur par défaut est public, s'il n'y a pas de points d'extrémité public, aucun ne sera trouvé et vous recevrez une erreur : {"errors":"not_found"}. Utilisez l'option -e private pour utiliser les points d'extrémité private.

Exemples

Afficher comment se connecter à un déploiement.

ibmcloud cdb deployment-connections MyPSQL

(Affiche une chaîne de connexion et une chaîne de commande de l'interface de ligne de commande).

Connectez-vous à un déploiement en tant qu'admin.

ibmcloud cdb deployment-connections MyPSQL --start

Lors de l'exécution, le plug-in vous invite à entrer le mot de passe de l'administrateur, puis exécute la chaîne de commande d'interface de ligne de commande. La commande qui est utilisée dans la chaîne de commande d'interface de ligne de commande doit être installée.

Affichez tous les détails relatifs à l'établissement d'une connexion à un déploiement pour une combinaison d'utilisateur et de mot de passe particulière.

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

ibmcloud cdb deployment-cacert

Version courte : cacert

Affichez le certificat autosigné qui est utilisé pour vérifier les connexions TLS/SSL au déploiement. Par défaut, le résultat est affiché dans la console mais peut également être sauvegardé dans un fichier.

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

Options de commande

  • --user <userid> ou -u Par défaut, l'ID de l'administrateur est utilisé pour obtenir le certificat. En option, cet indicateur permet de spécifier un utilisateur, lorsque le déploiement prend en charge des certificats par utilisateur.
  • --save ou -s Sauvegardez le certificat décodé dans le répertoire racine des certificats. Par défaut, il s'agit de $HOME/.cloud/plugins/cdb/cdbcerts/.
  • --certroot <path> ou -c Utilisez le chemin comme répertoire racine des certificats. S'il n'existe pas, il est créé automatiquement. Fonctionne avec l'indicateur --save. La valeur de la racine de certificat peut également être définie dans la variable d'environnement $CERTROOT.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Affichez le certificat pour un déploiement nommé MyPostgreSQL.

ibmcloud cdb deployment-cacert MyPostgreSQL

Sauvegardez un certificat pour le même déploiement dans le répertoire en cours.

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

Remarque : le nom de fichier dépend du nom du certificat.

ibmcloud cdb deployment-kill-connections

Version courte : kill-connections

Ferme toutes les connexions d'un déploiement. Disponible pour PostgreSQL UNIQUEMENT.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de création de l'utilisateur. Affichez les détails de la tâche de création de l'utilisateur et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Cette commande supprime toutes les connexions externes à un déploiement nommé postgresq-preproduction.

ibmcloud cdb deployment-kill-connections postgresq-preproduction

Capacité

Les commandes de capacité vous aident à identifier les fonctionnalités disponibles et prises en charge pour vos bases de données et vos sauvegardes.

ibmcloud cdb capability

capability-show

Cette commande permet de savoir si une capacité est prise en charge pour un type de base de données particulier.

Version courte : cs

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --api-version ou -v Version de l'API utilisée pour la demande.
  • --hostflavor Saveur d'hôte pour la capacité des groupes.

Options d'identification des capacités

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

Exemples

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

Cette commande permet de déterminer si un type de base de données peut être restauré à partir d'une instance particulière.

Version courte : bcs

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --api-version ou -v Version de l'API utilisée pour la demande.

Options d'identification des capacités

  • restores

Exemples

  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

Cette commande permet de déterminer si un déploiement ou une formation spécifique soutient une capacité particulière.

Version courte : dcs

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --api-version ou -v Version de l'API utilisée pour la demande.
  • --target-platform ou -p Plate-forme cible de la demande
  • --target-location ou -l Lieu cible de la demande

Options d'identification des capacités

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

Exemples

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

Utilisateurs

Créez et supprimez des utilisateurs ou changez leur mot de passe dans votre déploiement.

ibmcloud cdb deployment-user-create

Version courte : user-create

Créez un utilisateur dans la base de données de déploiement.

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

newusername doit être un nom d'utilisateur correctement formaté en vue de son utilisation dans la base de données du déploiement. newpassword doit respecter les règles sur les mots de passe de la base de données et doit comporter au moins 10 caractères.

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de création de l'utilisateur. Affichez les détails de la tâche de création de l'utilisateur et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Créez un utilisateur de base de données appelé "fred" avec un mot de passe de "X1234Y5678" sur le déploiement "MyPSQL".

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

ibmcloud cdb deployment-user-delete

Version courte : user-delete

Retire un utilisateur existant du déploiement de base de données spécifié.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de suppression de l'utilisateur. Affichez les détails de la tâche de suppression de l'utilisateur et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Supprimez l'utilisateur de la base de données appelé "fred" du déploiement "MyPSQL".

ibmcloud cdb deployment-user-delete MyPSQL fred

ibmcloud cdb deployment-user-password

Version courte : user-password

Change le mot de passe d'un utilisateur nommé dans un déploiement de base de données spécifié.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de changement de mot de passe de l'utilisateur. Affichez les détails de la tâche de changement de mot de passe de l'utilisateur et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Modifier le mot de passe de l'utilisateur "fred" sur le déploiement de la base de données "MyPSQL" en "A9876B5432".

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

Configuration de la base de données

Liste ou modification des paramètres configurables d'un déploiement. La nouvelle configuration est spécifiée dans un fichier JSON ou dans une chaîne JSON de paramètres. Les paramètres varient selon le type de base de données, voir Modification de la configuration de la base de données pour PostgreSQL ou pour Redis.

ibmcloud cdb deployment-configuration-schema

Version courte : config-schema

Obtient la configuration par défaut du déploiement spécifié.

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

Le site ibmcloud cdb deployment-configuration-schema présente la configuration par défaut. Pour vérifier une valeur de configuration actuelle, interrogez directement la configuration à partir de votre base de données.

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --description ou -d Affichez la description des paramètres.

Exemples

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

ibmcloud cdb deployment-configuration

Version courte : configuration

Change la configuration du déploiement spécifié.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.

Exemples

Modifiez la valeur de max_connections pour un déploiement PostgreSQL nommé " PGSettings4 " à 150.

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

Mise à l'échelle

Procédez à l'extraction des ressources qui sont allouées à votre déploiement et configurez-les.

ibmcloud cdb deployables-groups-show

Chaque déploiement est créé à partir d'un modèle déployable. La commande deployables-groups-show affiche le groupe de mise à l'échelle initial ou par défaut pour un type de base de données particulier. Les noms de type peuvent être reconnus à l'aide de la commande deployables-show.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Afficher les paramètres de groupe par défaut pour le déploiement d'une base de données PostgreSQL.

ibmcloud cdb deployables-groups-show postgresql

ibmcloud cdb deployment-groups

Version courte : groups

Affiche les valeurs de groupe de mise à l'échelle pour les membres d'un déploiement. Les groupes de mise à l'échelle sont liés à la mémoire, l'unité centrale et l'espace disque. Le groupe par défaut s'appelle "member". Pour chaque groupe, le nombre de nœuds dans le groupe est indiqué, suivi par :

  • Mémoire- L'allocation totale de mémoire, l'allocation par membre, l'allocation minimale et les incréments par lesquels la mémoire totale peut être modifiée.
  • CPU- Le nombre de CPU dédiés au groupe. La section Unité centrale affiche des valeurs 0 dans toutes les zones lorsqu'aucune unité centrale dédiée n'est configurée. Le groupe Unité centrale n'apparaît que s'il peut être ajusté.
  • Disque- L'allocation totale du disque, l'allocation par membre, l'allocation minimale et les incréments par lesquels le disque total peut être modifié.
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Affichez les paramètres du groupe de mise à l'échelle pour un déploiement de base de données nommé "MyRedis".

ibmcloud cdb deployment-groups MyRedis

ibmcloud cdb deployment-groups-set

Version courte : groups-set

Définit les valeurs pour les groupes de mise à l'échelle (voir deployment-groups). L'utilisateur peut définir la taille de mémoire totale en Mo ou le stockage de disque total en Mo, les deux étant répartis également entre les membres. Le cas échéant, le nombre d'unités centrales allouées peut également être défini.

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 est le nom du groupe pour lequel ces valeurs doivent être définies. Le nom peut être identifié à l'aide de la commande deployment-groups. En général, il s'agit de "member".

Options de commande

  • --memory <memory size> ou -m Définissez la mémoire totale du groupe de déploiement spécifié, qui est une valeur exprimée en Mo.
  • --disk <disk size> ou -d Définissez la taille de disque totale du groupe de déploiement spécifié, qui est une valeur exprimée en Mo.
  • --cpu <value> ou -c Définissez le nombre de coeurs d'unité centrale dédiés.
  • --hostflavor <val> Définissez le type d'hébergement de la base de données : sélectionnez multitenant pour l'ordinateur partagé ou les sélections de taille individuelle pour l'ordinateur isolé.
  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.
  • --output ou -o FORMAT Résultats sous forme de JSON.

Exemples

Configurez un déploiement PostgreSQL nommé "MyPGSQL" avec un groupe "member" pour avoir une mémoire totale de 4096 MB.

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

Régions

Liste toutes les régions dans lesquelles des déploiements peuvent être effectués à partir de la région actuelle.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • api-version value Version de l'API utilisée pour la demande.

Exemples

Renvoie une liste JSON de toutes les régions dans lesquelles des déploiements peuvent être effectués à partir de la région actuelle.

ibmcloud cdb regions --output, -o FORMAT

Mise à l'échelle automatique

La configuration Mise à l'échelle automatique représente les diverses conditions qui contrôlent la mise à l'échelle automatique pour un déploiement.

ibmcloud cdb deployment-autoscaling

Version courte : autoscaling

Procédez à l'extraction de toutes les conditions de mise à l'échelle automatique pour un déploiement particulier.

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

Actuellement, la mise à l'échelle automatique s'applique uniquement aux membres de données dans votre déploiement ; par conséquent, GROUP_ID a pour valeur member.

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

ibmcloud cdb deployment-autoscaling-set

Version courte : autoscaling-set

Activez, désactivez ou définissez les conditions de mise à l'échelle dans votre déploiement.

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

Actuellement, la mise à l'échelle automatique s'applique uniquement aux membres de données dans votre déploiement ; par conséquent, GROUP_ID a pour valeur member. Les paramètres de mise à l'échelle que vous voulez définir ou dont vous voulez annuler la définition sont indiqués dans un objet JSON.

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --nowait ou -n N'attendez pas la fin de la commande.

Exemples

Cette commande configure la mémoire pour qu'elle soit mise à l'échelle automatiquement lorsque l'utilisation des E/S atteint un certain seuil pour un déploiement nommé 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épliques en lecture seule

Procédez à l'extraction de répliques en lecture seule et configurez-les. Actuellement, seuls les déploiements PostgreSQL prennent en charge les répliques en lecture seule.

ibmcloud cdb deployment-read-replicas

Version courte : read-replicas

Répertorie toutes les répliques en lecture seule pour le déploiement spécifié.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --long ou -l Affiche des zones supplémentaires dans la sortie.

Exemples

Listez les répliques en lecture seule pour un déploiement PostgreSQL nommé "MyPGSQL".

ibmcloud cdb deployment-read-replicas MyPGSQL

ibmcloud cdb read-replica-leader

Version courte : rr-leader

Renvoie le noeud principal du déploiement de réplique en lecture seule spécifié.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --long ou -l Affiche des zones supplémentaires dans la sortie.

Exemples

Dressez la liste des responsables d'un déploiement de réplicas en lecture seule PostgreSQL nommé "MyPGSQL-replica".

ibmcloud cdb read-replica-leader MyPGSQL-replica

ibmcloud cdb read-replica-promote

Version courte : rr-promote

Promeut la réplique en lecture seule dans une instance autonome.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --nowait ou -n N'attendez pas la fin de la commande.
  • --skip-initial-backup ou s Option de restauration de l'instance sans sauvegarde une fois les données restaurées. Permet la mise à disposition du déploiement restauré plus rapidement.

Exemples

Promouvoir un déploiement de réplique en lecture seule de PostgreSQL nommé "MyPGSQL-replica" à un déploiement autonome.

ibmcloud cdb read-replica-promote MyPGSQL-replica

ibmcloud cdb read-replica-resync

Version courte : rr-resync

Resynchronise la réplique en lecture seule.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • --nowait ou -n N'attendez pas la fin de la commande.

Exemples

Resynchronise un déploiement de réplique en lecture seule de PostgreSQL nommé "MyPGSQL-replica".

ibmcloud cdb read-replica-resync MyPGSQL-replica

Sauvegardes

Gérez les sauvegardes dans votre déploiement ou effectuez une sauvegarde à la demande.

ibmcloud cdb deployment-backups-list

Version courte : backups

Affiche la liste des sauvegardes qui sont associées à un déploiement. Le résultat est une table qui présente l'ID, le type, le statut et la date de création des sauvegardes. Les résultats sont triés et les sauvegardes les plus récentes apparaissent en premier.

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

Options de commande

  • --scheduled ou -s Seules les sauvegardes planifiées apparaissent dans la sortie.
  • --first ou -f Seule la première sauvegarde trouvée (ou la plus récente) apparaît dans la sortie.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Afficher les sauvegardes disponibles sur un déploiement nommé " Postgres2000 ".

ibmcloud cdb backups Postgres2000

ibmcloud cdb backup-show

Affichez des détails sur une sauvegarde. La sauvegarde est identifiée par son ID de nom de ressource de cloud, tel qu'indiqué dans la commande deployment-backups-list.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Afficher les détails d'une sauvegarde particulière.

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

Version courte : backup-now

Lance une sauvegarde à la demande sur le déploiement. La commande interroge la sauvegarde en cours et quitte la fenêtre une fois la sauvegarde terminée.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de sauvegarde. Affichez les détails de la tâche de sauvegarde et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Créer une sauvegarde d'un déploiement appelé "PgTips".

ibmcloud cdb deployment-backup-now PgTips

Sécurité

Gérez la liste autorisée d'IP pour votre déploiement.

ibmcloud cdb deployment-allowlist-list

Version courte : wl-ls

Affiche la liste autorisée en cours pour un déploiement.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Liste des listes d'autorisations actuelles pour le déploiement de "MyPSQL".

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-add

Version courte : wl-add

Ajoutez une adresse IP ou une plage à la liste autorisée en cours pour un déploiement. Une adresse IP est une adresse IPv4 ou IPv6 alors qu'une plage est une adresse IPv4 avec masque, par exemple 1.2.3.0/24. La description doit être une chaîne lisible qui décrit l'adresse ou la plage figurant dans la liste autorisée.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche d'ajout de liste autorisée. Affichez les détails de la tâche d'ajout de liste autorisée et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Ajoutez l'adresse IP 198.51.100.1 à la liste d'autorisations actuelle pour le déploiement "MyPSQL".

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

Ajoutez la plage d'adresses IP 198.51.100.0 à 198.51.100.255 à la liste d'autorisations actuelle pour le déploiement "MyPSQL".

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

ibmcloud cdb deployment-allowlist-delete

Version courte : wl-del

Retire une adresse IP ou une plage de la liste autorisée en cours pour un déploiement. Une adresse IP est une adresse IPv4 ou IPv6 alors qu'une plage est une adresse IPv4 avec masque, par exemple 1.2.3.0/24.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de suppression de liste autorisée. Affichez les détails de la tâche de suppression de liste autorisée et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Supprimer l'adresse IP 198.51.100.1 de la liste d'autorisations actuelle pour le déploiement "MyPSQL".

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

Supprimer la plage d'adresses IP 198.51.100.0 à 198.51.100.255 de la liste d'autorisations actuelle pour le déploiement "MyPSQL".

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

Tâches

Des tâches sont créées à chaque fois que vous effectuez une action dans votre déploiement. Il peut s'agir de l'exécution d'une sauvegarde, de la mise à l'échelle d'un groupe et du changement du mot de passe d'un utilisateur. La plupart des commandes cdb interrogent la tâche en cours d'exécution et quitte la fenêtre une fois la tâche terminée. Vous pouvez changer ce comportement avec l'indicateur --nowait, qui permet d'obtenir des informations sur la tâche et de quitter la fenêtre. Les enregistrements des tâches qui ont abouti sont affichés pendant 24 à 48 heures ; ceux des tâches qui ont échoué le sont pendant 7 à 8 jours. Un enregistrement historique des tâches de toutes les périodes est disponible par le biais de l'intégration d'Activity Tracker.

ibmcloud cdb deployment-tasks-list

Version courte : tasks

Affiche la liste de toutes les tâches qui ont été exécutées dans un déploiement spécifié depuis sa création. Chaque tâche est affichée avec son nom de ressource de cloud, une description lisible, son pourcentage d'achèvement, son statut et sa date de création.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Afficher une liste des tâches qui ont été exécutées par rapport à un déploiement nommé "NewRedis".

ibmcloud cdb deployment-tasks-list NewRedis

ibmcloud cdb task-show

Version courte : task

Affichez le statut d'une tâche particulière. La tâche est identifiée par son ID de nom de ressource de cloud, tel qu'indiqué dans la commande deployment-tasks-list. Si la tâche est en cours d'exécution, la commande attend qu'elle soit terminée et signale les changements de statut lors de ses interrogations régulières.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche. Affichez les détails de la tâche de changement de mot de passe de l'utilisateur et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Affiche les détails d'une tâche de sauvegarde particulière.

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

Effectuez des tâches propres aux déploiements Elasticsearch.

ibmcloud cdb elasticsearch file-sync

Version courte : fs

Synchronise des fichiers depuis l'index ibm_file_sync sur le disque. Pour plus d'informations, voir la documentation Téléchargement de fichiers vers Elasticsearch.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Synchroniser un fichier sur le disque d'un déploiement nommé "MyElasticsearch".

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

Version courte : ul

Répertorie tous les utilisateurs de la base de données d'informations d'identification interne. Pour plus d'informations, voir Récupérer et mettre à jour les mots de passe des utilisateurs.

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

Options de commande

  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • -c DIRECTORY Racine du certificat
  • --api-version Version de l'API utilisée pour la demande.

Exemples

La commande user-list propose diverses options pour la liste des utilisateurs de votre compte.

ibmcloud cdb elasticsearch user-list

PostgreSQL

Effectuez des tâches propres aux déploiements PostgreSQL.

ibmcloud cdb postgresql earliest-pitr-timestamp

Version courte : ept

Renvoie la date et l'heure les plus récentes disponibles pour la récupération à un point de cohérence au format TUC ISO8601. Pour plus d'informations, voir la documentation Récupération à un point de cohérence.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

ibmcloud cdb postgresql replication-slot-create

Version courte : rsc

Crée un nouvel emplacement de réplication PostgreSQL. Pour plus d'informations, voir la documentation Wal2json.

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

Le type de plug-in doit être "wal2json".

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Créez un slot de réplication sur un déploiement nommé "MyPostgres",, une base de données nommée "testdb", et un slot nommé " slot1 ".

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

ibmcloud cdb postgresql replication-slot-delete

Version courte : rsd

Supprime l'emplacement de réplication PostgreSQL spécifié. Voir la documentation Wal2json pour plus d'informations.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.

Exemples

Supprime un slot de réplication sur un déploiement nommé "MyPostgres" et un slot nommé " slot1 ".

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB Entreprise

Effectuer des tâches spécifiques aux déploiements de MongoDB Enterprise.

ibmcloud cdb mongodbee earliest-pitr-timestamp

Version courte : ept

Renvoie la date et l'heure les plus récentes disponibles pour la récupération à un point de cohérence au format TUC ISO8601. Pour plus d'informations, voir Récupération ponctuelle.

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

Options de commande

  • --nowait ou -n N'attendez pas la fin de la tâche de définition du groupe. Affichez les détails de la tâche de mise à l'échelle et quittez la fenêtre.
  • --output ou -o FORMAT Spécifie un format de sortie. Seul JSON est pris en charge.
  • api-version value Version de l'API utilisée pour la demande.

Exemples

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

Redis

Effectuer des tâches spécifiques aux déploiements de Redis.

ibmcloud cdb redis user-set

Modifier les rôles des utilisateurs de Redis. Pour plus d'informations, voir Redis RBAC.

ibmcloud cdb redis user-set <"roles">

Exemples

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