Cloud Databases CLI

O plug-in da CLI do Cloud Databases oferece métodos adicionais para acessar os recursos dos serviços do Cloud Databases . Você pode usar a CLI do Cloud Databases para gerenciar e se conectar aos seguintes serviços:

O Cloud Databases plug-in CLI requer que IBM Cloud o CLI esteja instalado.

O Cloud Databases plug-in CLI (cdb) suporta apenas instâncias Gen 1. Para gerenciar instâncias Gen 2, consulte a Cloud Databases referência da CLI Gen 2.

A CLI do IBM Cloud

A CLI do IBM Cloud é uma ferramenta de desenvolvedor de finalidade geral e que fornece acesso à conta e aos serviços do IBM Cloud por meio de uma interface de linha de comandos.

Uma introdução e instruções de instalação estão disponíveis na página IBM Cloud CLI Getting Started. Ao instalar a CLI por meio do comando cURL fornecido, você obterá uma seleção de plug-ins e extensões adicionais para vários IDEs.

Instale o pacote autônomo na página Instalando a CLI autônoma do IBM Cloud.

O acesso aos serviços por meio da CLI do IBM Cloud é controlado pelo Gerenciamento de acesso e de identidade. Para usar a CLI para visualizar ou gerenciar um serviço (ou para conceder privilégios a outro usuário em sua conta), deve-se configurar as permissões corretas. Para obter mais informações sobre o gerenciamento do IAM, consulte o tutorial Introdução ao IAM

Instalando o plug-in da CLI do Cloud Databases

Quando tiver a CLI do IBM Cloud, faça login e instale o plug-in Cloud Databases, usando um comando como:

ibmcloud plugin install cloud-databases

Para obter uma lista de comandos e informações de uso, use um comando como:

ibmcloud cdb help

ibmcloud cdb help

Por si só, o comando ibmcloud cdb help exibe os comandos de nível superior disponíveis. Quando seguido por outro comando, exibe a ajuda específica para esse comando.

ibmcloud cdb help [<command>]

Opções de comando

Sem opções de comando específicas.

Exemplos

Obtenha ajuda sobre o comando task-show.

ibmcloud cdb help task-show

Primeiros passos - Criar uma instância

Você pode criar uma instância usando o seguinte 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>"

Opções de comando

Defina o grupo de recursos se quiser usar outro grupo em vez do grupo padrão. Você também pode omitir esse sinalizador.

Exemplos

Crie uma instância do 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"

Implementações e implementáveis

Obtenha informações sobre os bancos de dados implementáveis e as versões de bancos de dados na plataforma do Cloud Databases. Além disso, obtenha uma lista de todos os Cloud Databases em sua conta do IBM Cloud.

ibmcloud cdb deployables-show

deployables são os modelos disponíveis para novas implementações de banco de dados. Este comando mostra os tipos de bancos de dados implementáveis, especificamente as versões de bancos de dados disponíveis e seu status preferencial ou estável.

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

Versão abreviada - deployables

Opções de comando

  • --stable ou -s Listar apenas as versões estáveis de bancos de dados.
  • --preferred ou -p Listar apenas as versões preferenciais de bancos de dados.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Mostrar todas as versões estáveis dos bancos de dados disponíveis.

ibmcloud cdb deployables-show --stable

ibmcloud cdb deployments

Versão abreviada - ls

Use este comando para listar as implementações associadas à conta.

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

Opções de comando

  • --all ou -a Exibir nome da instância e CRN.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Liste todas as implantações atuais com uma conta.

ibmcloud cdb ls

ibmcloud cdb deployment-about

Versão abreviada - about

Use esse comando para obter detalhes sobre qual banco de dados está implantado na instância, qual versão e quaisquer opções aplicadas. Também são exibidos o ID e o GUID do controlador de recursos, os planos de recursos, o estado atual, o tipo e a última operação conhecida.

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

Opções de comando

  • --all ou -a Exibir todos os dados disponíveis a partir dos registros do controlador de recursos.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Liste os detalhes de uma implantação chamada "RedisDBOne".

ibmcloud cdb about RedisDBOne

Conexões

Obter sequências de conexões e informações de certificado a serem usadas ao estabelecer a conexão com sua implementação. Gerenciar conexões dos bancos de dados que dispõem dessa opção.

ibmcloud cdb deployment-connections

Versão abreviada - cxn

Exibe sequências e outros detalhes de conexões para uma implementação com ou sem credenciais de usuário inseridas.

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

Opções de comando

  • --start ou -s Inicie uma conexão executando o comando da CLI gerado. Caso as sinalizações não especifiquem uma senha, o comando solicitará uma senha interativamente. O plug-in usa os comandos padrão para interação da linha de comandos e para o gerenciamento do certificado de autoridade de certificação para garantir a segurança da sessão TLS. Padronizado para conexão como usuário administrativo da implementação.
  • --user <userid> ou -u Configura o ID do usuário utilizado ao recuperar configurações de conexão. Ele é substituído nas sequências de conexões. Padronizado como o usuário administrativo da implementação.
  • --password <password> ou -p Configura a senha que é usada ao recuperar configurações de conexão. Ele é substituído nas sequências de conexões em que $PASSWORD aparece como padrão.
  • --endpoint-type [public or private] ou -e [public or private] Tipo de terminal para sequências de conexões retornadas. Pode ser "público" ou "privado". (padrão: "public"). O tipo de terminal não é imposto e é apenas para fins de exibição.
  • --all ou -a Lista todas as configurações de conexões disponíveis, incluindo partes de componentes das sequências de conexões.
  • --certroot <path> ou -c Use o caminho como raiz do certificado. Caso não exista, o caminho será criado automaticamente. Utilizado com a sinalização --save. O valor da raiz do certificado também pode ser configurado na variável de ambiente $CERTROOT.
  • --only [app or cli] ou -o Mostrar apenas as configurações relevantes para as conexões app ou conexões cli.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --endpoint-type ou -e Tipo de ponto de extremidade para cadeias de conexão retornadas, public ou private. O padrão é public. Como o padrão é public, se não houver pontos de extremidade public, nenhum será encontrado e você receberá um erro: {"errors":"not_found"}. Use o sinalizador -e private para usar os pontos de extremidade private.

Exemplos

Exibe como se conectar a uma implantação.

ibmcloud cdb deployment-connections MyPSQL

(Mostra uma sequência de conexões e uma sequência de caracteres de comando da CLI)

Estabelecer uma conexão com uma implementação como administrador.

ibmcloud cdb deployment-connections MyPSQL --start

Quando executado, o plug-in solicita a senha do administrador, em seguida, executa a sequência de caracteres de comando da CLI. O comando utilizado na sequência de caracteres de comando da CLI deve ser instalado.

Mostrar todos os detalhes de como estabelecer uma conexão com uma implementação para uma determinada combinação de usuário e senha.

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

ibmcloud cdb deployment-cacert

Versão abreviada - cacert

Exibir o certificado autoassinado utilizado para verificar as conexões TLS/SSL estabelecidas com a implementação. Por padrão, o resultado é enviado para o console, mas também pode ser salvo em um arquivo.

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

Opções de comando

  • --user <userid> ou -u Por padrão, utiliza-se o usuário administrativo para obter o certificado. Opcionalmente, esta sinalização permite especificar um usuário quando a implementação suportar certificados individuais de usuários.
  • --save ou -s Salve o certificado decodificado no diretório-raiz do certificado. O padrão é $HOME/.cloud/plugins/cdb/cdbcerts/.
  • --certroot <path> ou -c Use o caminho como o diretório-raiz do certificado. Caso não exista, o caminho será criado automaticamente. Utilizado com a sinalização --save. O valor da raiz do certificado também pode ser configurado na variável de ambiente $CERTROOT.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Exibir o certificado para uma implantação chamada MyPostgreSQL.

ibmcloud cdb deployment-cacert MyPostgreSQL

Salvar um certificado para a mesma implementação no diretório atual.

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

Nota: o nome do arquivo é baseado no nome do certificado.

ibmcloud cdb deployment-kill-connections

Versão abreviada - kill-connections

Fecha todas as conexões em uma implementação. Disponível APENAS para PostgreSQL.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de criação do usuário. Exibir detalhes da tarefa de criação do usuário e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Esse comando elimina todas as conexões externas a uma implantação chamada postgresq-preproduction.

ibmcloud cdb deployment-kill-connections postgresq-preproduction

Capacidade

Os comandos de recursos o ajudam a identificar quais recursos estão disponíveis e são compatíveis com seus bancos de dados e backups.

ibmcloud cdb capability

capability-show

Esse comando descobre se um recurso é compatível com um tipo específico de banco de dados.

Versão abreviada - cs

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --api-version ou -v Versão da API usada para a solicitação.
  • --hostflavor Sabor de host para capacidade de grupos.

Opções de ID de capacidade

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

Exemplos

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

Esse comando descobre se um tipo de banco de dados pode ser restaurado a partir de uma instância específica.

Versão abreviada - bcs

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --api-version ou -v Versão da API usada para a solicitação.

Opções de ID de capacidade

  • restores

Exemplos

  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

Esse comando descobre se uma determinada implantação ou formação suporta uma capacidade específica.

Versão abreviada - dcs

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --api-version ou -v Versão da API usada para a solicitação.
  • --target-platform ou -p Plataforma de destino para solicitação
  • --target-location ou -l Local de destino da solicitação

Opções de ID de capacidade

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

Exemplos

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

Usuários

Criar, excluir ou alterar a senha de usuários em sua implementação.

ibmcloud cdb deployment-user-create

Versão abreviada - user-create

Crie um usuário no banco de dados de implementação.

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

É necessário que newusername seja um nome de usuário com formatação correta para ser utilizado no banco de dados de implementação. newpassword deve estar em conformidade com as regras de senha do banco de dados e ter, no mínimo, 10 caracteres de comprimento.

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de criação do usuário. Exibir detalhes da tarefa de criação do usuário e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Crie um usuário de banco de dados chamado "fred" com uma senha de "X1234Y5678" na implementação "MyPSQL".

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

ibmcloud cdb deployment-user-delete

Versão abreviada - user-delete

Remove um usuário existente da implementação do banco de dados especificado.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir detalhes da tarefa de exclusão do usuário e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Remova o usuário do banco de dados chamado "fred" da implementação do "MyPSQL".

ibmcloud cdb deployment-user-delete MyPSQL fred

ibmcloud cdb deployment-user-password

Versão abreviada - user-password

Altera a senha de um determinado usuário em uma implementação de banco de dados especificada.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de mudança de senha do usuário. Exibir detalhes da tarefa de mudança de senha do usuário e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Altere a senha do usuário "fred" na implementação do banco de dados "MyPSQL" para "A9876B5432".

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

Configuração do banco de dados

Listar ou alterar as definições configuráveis em uma implantação. A nova configuração é especificada em um arquivo JSON ou sequência JSON de configurações. As configurações variam de acordo com o tipo de banco de dados; consulte Alteração da configuração do banco de dados para PostgreSQL ou para Redis.

ibmcloud cdb deployment-configuration-schema

Versão abreviada - config-schema

Obtém a configuração padrão da implantação especificada.

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

O site ibmcloud cdb deployment-configuration-schema mostra a configuração padrão. Para verificar um valor de configuração atual, consulte a configuração diretamente em seu banco de dados.

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --description ou -d Mostrar a descrição das configurações.

Exemplos

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

ibmcloud cdb deployment-configuration

Versão abreviada - configuration

Altera a configuração da implementação especificada.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.

Exemplos

Altere o max_connections de uma implantação PostgreSQL chamada " PGSettings4 " para 150.

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

Ajuste de escala

Recuperar e configurar os recursos que são alocados para a sua implementação.

ibmcloud cdb deployables-groups-show

Cada implementação é criada a partir de um modelo implementável. O comando deployables-groups-show mostra o grupo inicial ou padrão de ajuste de escala para um determinado tipo de banco de dados. Para descobrir os nomes dos tipos, é possível usar o comando deployables-show.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Mostrar as configurações de grupo padrão para uma implementação do banco de dados PostgreSQL.

ibmcloud cdb deployables-groups-show postgresql

ibmcloud cdb deployment-groups

Versão abreviada - groups

Exibe os valores do grupo de ajuste de escala para os membros de uma implementação. Os grupos de ajuste de escala estão relacionados a Memória, CPU e Disco. O grupo padrão é chamado de "member". Para cada grupo, o número de nós no grupo é mostrado seguido por:

  • Memória- A alocação total de memória, a alocação por membro, a alocação mínima e os incrementos pelos quais a memória total pode ser variada.
  • CPU- O número de CPUs dedicadas ao grupo. A seção CPU mostra valores zerados em todos os campos quando não houver nenhuma CPU configurada. O grupo de CPUs só é exibido quando pode ser ajustado.
  • Disco- A alocação total de disco, a alocação por membro, a alocação mínima e os incrementos pelos quais o disco total pode variar.
ibmcloud cdb deployment-groups <deployment name or CRN> [--output, -o FORMAT]

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Exibir as configurações do grupo de dimensionamento para uma implantação de banco de dados chamada "MyRedis".

ibmcloud cdb deployment-groups MyRedis

ibmcloud cdb deployment-groups-set

Versão abreviada - groups-set

Configura os valores para os grupos de ajuste de escala (consulte deployment-groups). O usuário pode configurar o tamanho total da memória em MB ou o armazenamento em disco total em MB, ambos os quais são divididos igualmente entre os membros. Quando disponível, também é possível configurar o número de CPUs alocadas.

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 é o nome do grupo para o qual é possível configurar esses valores. Para localizar o nome, é possível usar o comando deployment-groups. Geralmente, o nome é "member".

Opções de comando

  • --memory <memory size> ou -m Configurar a memória total do grupo de implementação especificado, um valor em MB.
  • --disk <disk size> ou -d Configurar o tamanho total do disco do grupo de implementação especificado, um valor em MB.
  • --cpu <value> ou -c Configurar o número de núcleos de CPU dedicados.
  • --hostflavor <val> Defina o tipo de hospedagem do banco de dados: selecione multitenant para computação compartilhada ou as seleções de tamanho individual para computação isolada.
  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.
  • --output ou -o FORMAT Resultados como JSON.

Exemplos

Defina uma implantação PostgreSQL chamada "MyPGSQL" com um grupo "member" para ter uma memória total de 4096 MB.

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

Regiões

Lista todas as regiões em que as implantações podem ser provisionadas a partir da região atual.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • api-version value Versão da API usada para a solicitação.

Exemplos

Retorna um JSON de todas as regiões nas quais as implantações podem ser provisionadas a partir da região atual.

ibmcloud cdb regions --output, -o FORMAT

Auto-scaling

A configuração Ajuste automático de escala representa as diversas condições que controlam o ajuste de escala de uma implementação.

ibmcloud cdb deployment-autoscaling

Versão abreviada - autoscaling

Recuperar todas as condições de ajuste automático de escala de uma determinada implementação.

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

Atualmente, o Ajuste automático de escala se aplica apenas aos membros de dados na implementação, portanto, o GROUP_ID é member.

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

ibmcloud cdb deployment-autoscaling-set

Versão abreviada - autoscaling-set

Ativar, desativar ou configurar as condições de ajuste automático de escala na implementação.

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

Atualmente, o Ajuste automático de escala se aplica apenas aos membros de dados na implementação, portanto, o GROUP_ID é member. Os parâmetros de ajuste automático de escala a serem configurados ou desconfigurados são definidos em um objeto JSON.

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --nowait ou -n Não esperar a conclusão do comando.

Exemplos

Esse comando define a memória para dimensionamento automático quando a utilização de E/S atinge um determinado limite para uma implantação chamada 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 somente leitura

Recuperar e configurar réplicas somente leitura. Atualmente, apenas implementações PostgreSQL suportam réplicas somente leitura.

ibmcloud cdb deployment-read-replicas

Versão abreviada - read-replicas

Lista todas as réplicas somente leitura para a implementação especificada.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --long ou -l Mostra campos adicionais na saída.

Exemplos

Liste as réplicas somente leitura de uma implantação PostgreSQL chamada "MyPGSQL".

ibmcloud cdb deployment-read-replicas MyPGSQL

ibmcloud cdb read-replica-leader

Versão abreviada - rr-leader

Retornar o líder da implementação da réplica somente leitura especificada.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --long ou -l Mostra campos adicionais na saída.

Exemplos

Liste o líder de uma implantação de réplica somente leitura PostgreSQL chamada "MyPGSQL-replica".

ibmcloud cdb read-replica-leader MyPGSQL-replica

ibmcloud cdb read-replica-promote

Versão abreviada - rr-promote

Promove a réplica somente leitura para uma instância independente.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --nowait ou -n Não esperar a conclusão do comando.
  • --skip-initial-backup ou s Opção para restaurar uma instância sem fazer um backup quando os dados forem restaurados. Permite que a implementação restaurada seja disponibilizada mais rapidamente.

Exemplos

Promove uma implementação de réplica somente leitura PostgreSQL chamada "MyPGSQL-replica" para uma implementação autônoma.

ibmcloud cdb read-replica-promote MyPGSQL-replica

ibmcloud cdb read-replica-resync

Versão abreviada - rr-resync

Ressincroniza a réplica somente leitura.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • --nowait ou -n Não esperar a conclusão do comando.

Exemplos

Sincroniza novamente uma implementação de réplica somente leitura PostgreSQL chamada "MyPGSQL-replica".

ibmcloud cdb read-replica-resync MyPGSQL-replica

Backups

Gerenciar os backups na implementação ou fazer um backup sob demanda.

ibmcloud cdb deployment-backups-list

Versão abreviada - backups

Exibe uma lista de backups que estão associados a uma implementação. O resultado é uma tabela composta por ID, tipo, status e data de criação dos backups. A classificação dos resultados mostra primeiro os backups mais recentes.

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

Opções de comando

  • --scheduled ou -s Mostrar apenas os backups planejados.
  • --first ou -f Mostrar apenas o primeiro (ou o mais recente) backup encontrado.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Exibir os backups disponíveis em uma implementação denominada " Postgres2000 ".

ibmcloud cdb backups Postgres2000

ibmcloud cdb backup-show

Mostrar detalhes sobre um backup. O backup é identificado por seu ID de CRN, conforme mostrado com o comando deployment-backups-list.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Mostrar detalhes de um backup específico.

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

Versão abreviada - backup-now

Inicia um backup sob demanda na implementação. O comando pesquisa o backup em execução e é encerrado após a conclusão.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de backup. Exibir os detalhes e a saída da tarefa de backup.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Crie um backup de uma implantação chamada "PgTips".

ibmcloud cdb deployment-backup-now PgTips

Segurança

Gerenciar a lista de IPs permitidos da implementação.

ibmcloud cdb deployment-allowlist-list

Versão abreviada - wl-ls

Exibe a atual lista de permissões para uma implementação.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Liste a lista de permissões atual para a implementação do "MyPSQL".

ibmcloud cdb deployment-whitelist-list MyPSQL

ibmcloud cdb deployment-allowlist-add

Versão abreviada - wl-add

Incluir um endereço IP ou um intervalo de endereços IP na atual lista de permissões de uma implementação. Um endereço IP é um endereço IPv4 ou IPv6, enquanto um intervalo é um endereço IPv4 mascarado, por exemplo, 1.2.3.0/24. É necessário que a descrição seja uma sequência legível de caracteres, representando o endereço ou o intervalo de endereços contidos na lista de permissões.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de inclusão na lista de permissões. Exibir os detalhes da tarefa de inclusão na lista de permissões e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Adicione o endereço IP 198.51.100.1 à lista de permissões atual da implementação "MyPSQL".

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

Adicione o intervalo de IPs 198.51.100.0 a 198.51.100.255 à lista de permissões atual da implementação "MyPSQL".

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

ibmcloud cdb deployment-allowlist-delete

Versão abreviada - wl-del

Remove um endereço IP ou um intervalo de endereços IP da atual lista de permissões de uma implementação. Um endereço IP é um endereço IPv4 ou IPv6, enquanto um intervalo é um endereço IPv4 mascarado, por exemplo, 1.2.3.0/24.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão da lista de permissões. Exibir detalhes da tarefa de exclusão da lista de permissões e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Remova o endereço IP 198.51.100.1 da lista de permissões atual para a implementação "MyPSQL".

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

Remova o intervalo de IPs 198.51.100.0 a 198.51.100.255 da lista de permissões atual para a implementação "MyPSQL".

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

Tarefas

São criadas tarefas sempre que uma ação é executada na implementação. Estas tarefas incluem ações como obtenção de um backup, ajuste de escala de um grupo e alteração de uma senha de usuário. A maioria dos comandos cdb pesquisa a tarefa em execução e é encerrado após a conclusão. Para alterar esse comportamento, é possível usar a sinalização --nowait, que retorna informações sobre a tarefa e, em seguida, é encerrada. Os registros das tarefas bem-sucedidas são mantidos por 24h a 48h e os das tarefas malsucedidas são mantidos durante 7 a 8 dias. Um registro histórico de tarefas de qualquer período está disponível por meio da integração do Rastreador de atividade.

ibmcloud cdb deployment-tasks-list

Versão abreviada - tasks

Exibe uma lista de todas as tarefas que foram executadas em uma implementação especificada desde desde sua criação. Cada tarefa é exibida com suas próprias informações, como CRN, descrição legível, porcentagem de conclusão, status e data de criação.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Exibir uma lista das tarefas que foram executadas em uma implantação chamada "NewRedis".

ibmcloud cdb deployment-tasks-list NewRedis

ibmcloud cdb task-show

Versão abreviada - task

Mostrar o status de uma determinada tarefa. A tarefa é identificada por seu ID de CRN, conforme mostrado com o comando deployment-tasks-list. Caso a tarefa esteja em execução, o comando aguarda sua conclusão e o status de relatório é alterado de acordo com as pesquisas feitas regularmente.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa. Exibir detalhes da tarefa de mudança de senha do usuário e sair.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Mostrar detalhes de uma tarefa de backup específica.

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

Executar tarefas específicas para implementações do Elasticsearch.

ibmcloud cdb elasticsearch file-sync

Versão abreviada - fs

Sincroniza arquivos do índice ibm_file_sync para disco. Para obter mais informações, consulte a documentação Fazendo upload de arquivos para Elasticsearch.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Sincronize um arquivo com o disco em uma implantação chamada "MyElasticsearch".

ibmcloud cdb elasticsearch file-sync MyElasticsearch

ibmcloud cdb elasticsearch user-list

Versão abreviada - ul

Lista todos os usuários do armazenamento interno de credenciais do banco de dados. Para obter mais informações, consulte Recuperar e atualizar senhas de usuários.

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

Opções de comando

  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • -c DIRECTORY Raiz do certificado
  • --api-version Versão da API usada para a solicitação.

Exemplos

O comando user-list gera várias opções para a lista de usuários da sua conta.

ibmcloud cdb elasticsearch user-list

PostgreSQL

Executar tarefas específicas para implementações PostgreSQL.

ibmcloud cdb postgresql earliest-pitr-timestamp

Versão abreviada - ept

Retorna o primeiro horário disponível para recuperação point-in-time, no formato UTC ISO8601. Para obter mais informações, consulte a documentação Recuperação point-in-time.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

ibmcloud cdb postgresql replication-slot-create

Versão abreviada - rsc

Cria um novo slot de replicação PostgreSQL. Para obter mais informações, consulte a documentação Wal2json.

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

É necessário que o tipo de plug-in seja "wal2json".

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Crie um slot de replicação em uma implementação chamada "MyPostgres", banco de dados chamado "testdb" e um slot chamado " slot1 ".

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

ibmcloud cdb postgresql replication-slot-delete

Versão abreviada - rsd

Exclui o slot de replicação PostgreSQL especificado. Consulte a documentação Wal2json para obter mais informações.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.

Exemplos

Exclui um slot de replicação em uma implementação denominada "MyPostgres" e um slot denominado " slot1 ".

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB Empresa

Executar tarefas específicas das implementações do MongoDB Enterprise.

ibmcloud cdb mongodbee earliest-pitr-timestamp

Versão abreviada - ept

Retorna o primeiro horário disponível para recuperação point-in-time, no formato UTC ISO8601. Para obter mais informações, consulte Point in Time Recovery.

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

Opções de comando

  • --nowait ou -n Não esperar a conclusão da tarefa de exclusão do usuário. Exibir os detalhes e a saída da tarefa de ajuste de escala.
  • --output ou -o FORMAT Especifique um formato de saída. Somente JSON é suportado.
  • api-version value Versão da API usada para a solicitação.

Exemplos

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

Redis

Executar tarefas específicas das implementações do Redis.

ibmcloud cdb redis user-set

Edite as funções dos usuários do Redis. Para obter mais informações, consulte Gerenciamento do Redis RBAC.

ibmcloud cdb redis user-set <"roles">

Exemplos

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