Cloud Databases CLI

Cloud Databases CLI プラグインは、Cloud Databases サービスの機能にアクセスするための付加的な方式を提供します。 Cloud Databases CLI を使用して、以下のサービスを管理および接続できます：

CLI Cloud Databases プラグインは、CLIが IBM Cloud インストールされている必要があります。

CLIプラグイン Cloud Databases （cdb）はGen 1インスタンスのみをサポートします。 Gen 2 インスタンスを管理するには、 Gen 2 CLI Cloud Databases リファレンスを参照してください。

IBM Cloud CLI

IBM Cloud CLI は、コマンド・ライン・インターフェースを介して IBM Cloud アカウントやサービスへのアクセスを可能にする汎用の開発者用ツールです。

IBM Cloud CLI Getting Started のページで、イントロダクションとインストール手順をご覧いただけます。提供されている cURL コマンドから CLI をインストールすると、複数の IDE の追加のプラグインおよび拡張機能を選択できます。

スタンドアロン・パッケージは、スタンドアロン IBM Cloud CLI のインストール・ページからインストールしてください。

IBM Cloud CLI でサービスにアクセスするときの権限は、ID およびアクセス管理の設定によって決まります。 CLI を使用してサービスを表示または管理する (または自分のアカウントに属する別のユーザーに特権を付与する) ためには、正しい許可を設定する必要があります。 IAM 管理について詳しくは、IAM の入門チュートリアルを参照してください

Cloud Databases CLI プラグインのインストール

IBM Cloud CLIを入手したら、ログインし、以下のようなコマンドを使って、 Cloud Databases プラグインをインストールする：

ibmcloud plugin install cloud-databases

コマンドのリストと使用法については、次のようなコマンドを使う：

ibmcloud cdb help

`ibmcloud cdb help`

ibmcloud cdb help 、利用可能なトップレベルのコマンドが表示される。他のコマンドを続けると、そのコマンドのヘルプが表示される。

ibmcloud cdb help [<command>]

コマンド・オプション

コマンド固有のオプションはありません。

例

task-showコマンドのヘルプを見る。

ibmcloud cdb help task-show

はじめに - インスタンスの作成

以下のコマンドでインスタンスを作成できる：

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

コマンド・オプション

デフォルトのグループではなく、別のグループを使用したい場合は、リソースグループを設定します。このフラグは省略することもできる。

例

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"

デプロイメントとデプロイ可能なデータベース

Cloud Databases プラットフォーム上のデプロイ可能なデータベースとデータベース・バージョンに関する情報を取得します。また、ご使用の Cloud Databases アカウント上にあるすべての IBM Cloud のリストを取得します。

`ibmcloud cdb deployables-show`

deployables は、新規データベース・デプロイメントで使用できるテンプレートです。このコマンドは、デプロイ可能なデータベース・タイプを表示します。具体的には、利用可能なデータベースのバージョンと、状況 (優先または安定) を表示します。

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

短いバージョン - deployables

コマンド・オプション

--stableまたは-s 安定バージョンのデータベースのみをリストします。
--preferredまたは-p 優先バージョンのデータベースのみをリストします。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

利用可能なすべての安定版データベースを表示します。

ibmcloud cdb deployables-show --stable

`ibmcloud cdb deployments`

短いバージョン - ls

このコマンドを使用すると、アカウントに関連付けられているデプロイメントのリストを取得することができます。

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

コマンド・オプション

--allまたは-a インスタンス名と CRN を表示します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

アカウント持つ現在のすべてのデプロイメントを一覧表示します。

ibmcloud cdb ls

`ibmcloud cdb deployment-about`

短いバージョン - about

このコマンドを使用して、インスタンス内にデプロイされているデータベース、バージョン、および適用されているオプションの詳細を取得します。また、リソース・コントローラーの ID と GUID、リソース・プラン、現行の状態、タイプ、最後に確認された操作も表示されます。

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

コマンド・オプション

--allまたは-a リソース・コントローラーのレコードから得られるすべてのデータを表示します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"RedisDBOne" という名前のデプロイの詳細を一覧表示します。

ibmcloud cdb about RedisDBOne

接続

デプロイメントに接続するときに使用する接続ストリングと証明書情報を取得します。オプションが適用されているデータベースの接続を管理します。

`ibmcloud cdb deployment-connections`

短いバージョン - cxn

デプロイメントの接続ストリングとその他の接続詳細を、ユーザーの資格情報が挿入されている形式または挿入されていない形式で表示します。

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

コマンド・オプション

--startまたは-s 生成された CLI コマンドを実行して接続を開始します。フラグにパスワードが指定されていない場合は、コマンドによって対話式にパスワードの入力が要求されます。このプラグインは、コマンド・ラインでの対話にデフォルトのコマンドを使用し、安全な TLS セッションを確保するために CA 証明書を管理します。デフォルトでは、デプロイメントの管理者ユーザーとして接続します。
--user <userid>または-u 接続設定を取得する際に使用するユーザー ID を設定します。これは接続ストリングに代入されます。デフォルトはデプロイメントの管理者ユーザーです。
--password <password>または-p 接続設定を取得する際に使用するパスワードを設定します。これは接続ストリングに代入されます。これは、デフォルトでは $PASSWORD と表示されている接続ストリングに代入されます。
--endpoint-type [public or private]または-e [public or private] 返される接続ストリングのエンドポイント・タイプ。「public」または「private」のいずれかです (デフォルトは「public」)。エンドポイント・タイプは表示の目的で使用されるだけで、実行に関係するわけではありません。
--allまたは-a 利用可能なすべての接続設定 (接続ストリングの構成要素となる部分を含む) をリストします。
--certroot <path>または-c パスを証明書のルートとして使用します。パスが存在しない場合は、自動的に作成されます。 --save フラグと連携して機能します。証明書ルートの値は、$CERTROOT 環境変数で設定することもできます。
--only [app or cli]または-o app 接続または cli 接続に関連する設定のみを表示します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--endpoint-typeまたは-e 返される接続文字列のエンドポイント・タイプ。 public または private のいずれか。デフォルトは public。デフォルトは public であるため、 public のエンドポイントがない場合、何も見つからず、 {"errors":"not_found"} というエラーが表示されます。 private エンドポイントを使用するには、 -e private フラグを使用します。

例

配置に接続する方法を表示します。

ibmcloud cdb deployment-connections MyPSQL

(接続ストリングと CLI コマンド・ストリングが表示されます)

管理者としてデプロイメントに接続します。

ibmcloud cdb deployment-connections MyPSQL --start

このプラグインを実行すると、管理者パスワードの入力を求められ、その後 CLI コマンド・ストリングが実行されます。 CLI コマンド・ストリングで使用されるコマンドがインストールされている必要があります。

特定のユーザーとパスワードの組み合わせでデプロイメントへの接続を行う方法の詳細をすべて表示します。

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

`ibmcloud cdb deployment-cacert`

短いバージョン - cacert

デプロイメントへの TLS/SSL 接続の検証に使用される自己署名証明書を表示します。結果は、デフォルトではコンソールに出力されますが、ファイルに保存することもできます。

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

コマンド・オプション

--user <userid>または-u デフォルトでは、証明書の取得に管理者ユーザーが使用されます。ユーザーごとの証明書がサポートされているデプロイメントでは、オプションでこのフラグを使用してユーザーを指定することができます。
--saveまたは-s デコードした証明書を、証明書のルート・ディレクトリーに保存します。デフォルトは $HOME/.cloud/plugins/cdb/cdbcerts/ です。
--certroot <path>または-c パスを証明書のルート・ディレクトリーとして使用します。パスが存在しない場合は、自動的に作成されます。 --save フラグと連携して機能します。証明書ルートの値は、$CERTROOT 環境変数で設定することもできます。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

MyPostgreSQL という名前の配置の証明書を表示します。

ibmcloud cdb deployment-cacert MyPostgreSQL

同じデプロイメント用の証明書を現行ディレクトリーに保存します。

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

注: ファイル名は証明書名に基づく名前です。

`ibmcloud cdb deployment-kill-connections`

短いバージョン - kill-connections

デプロイメント上のすべての接続を閉じます。 PostgreSQL でのみ使用可能です。

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

コマンド・オプション

--nowaitまたは-n ユーザー作成タスクの完了を待機しません。ユーザー作成タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

このコマンドは、 postgresq-preproduction という名前のデプロイメントへの外部接続をすべて停止します。

ibmcloud cdb deployment-kill-connections postgresq-preproduction

機能

ケイパビリティ・コマンドは、データベースやバックアップで利用可能でサポートされている機能を確認するのに役立ちます。

ibmcloud cdb capability

`capability-show`

このコマンドは、あるケイパビリティが特定のデータベース・タイプでサポートされているかどうかを調べる。

短いバージョン - cs

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--api-versionまたは-v リクエストに使用された API バージョン。
--hostflavor グループ・ケイパビリティのためのホスト・フレーバー。

能力IDオプション

autoscaling
encryption
endpoints
groups
locations
point_in_time_recovery
remotes
restores
versions

例

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`

このコマンドは、データベース・タイプが特定のインスタンスからリストアできるかどうかを検出します。

短いバージョン - bcs

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--api-versionまたは-v リクエストに使用された API バージョン。

能力IDオプション

restores

例

  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`

このコマンドは、特定の配備やフォーメーションが特定の能力をサポートしているかどうかを調べる。

短いバージョン - dcs

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--api-versionまたは-v リクエストに使用された API バージョン。
--target-platformまたは-p リクエスト対象プラットフォーム
--target-locationまたは-l リクエストの対象場所

能力IDオプション

autoscaling
encryption
endpoints
groups
locations
point_in_time_recovery
remotes
versions

例

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

ユーザー

デプロイメント上のユーザーのパスワードを作成、削除、または変更します。

`ibmcloud cdb deployment-user-create`

短いバージョン - user-create

デプロイメント・データベース上にユーザーを作成します。

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

newusername は、デプロイメントのデータベースで使用するための正しくフォーマットされたユーザ名である必要があります。 newpassword は、データベースのパスワード・ルールに準拠する必要があり、10 文字以上の長さにする必要があります。

コマンド・オプション

--nowaitまたは-n ユーザー作成タスクの完了を待機しません。ユーザー作成タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyPSQL" 配置で、パスワードが "X1234Y5678" のデータベースユーザ「fred」を作成します。

ibmcloud cdb deployment-user-create MyPSQL fred X1234Y5678

`ibmcloud cdb deployment-user-delete`

短いバージョン - user-delete

指定したデータベース・デプロイメントから既存のユーザーを削除します。

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

コマンド・オプション

--nowaitまたは-n ユーザー削除タスクの完了を待機しません。ユーザー削除タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

fred というデータベースユーザを "MyPSQL" 配置から削除します。

ibmcloud cdb deployment-user-delete MyPSQL fred

`ibmcloud cdb deployment-user-password`

短いバージョン - user-password

指定したデータベース・デプロイメント上の指定ユーザーのパスワードを変更します。

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

コマンド・オプション

--nowaitまたは-n ユーザー・パスワード変更タスクの完了を待機しません。ユーザー・パスワード変更タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

データベース・デプロイメントのユーザー "fred "のパスワードを "MyPSQL" から "A9876B5432" に変更する。

ibmcloud cdb deployment-password MyPSQL fred A9876B5432

データベース構成

配置の構成可能な設定を一覧表示または変更します。新しい構成は、JSON ファイル、または JSON ストリングの設定で指定します。設定はデータベースの種類によって異なります_。 _PostgreSQL または Redis.

`ibmcloud cdb deployment-configuration-schema`

短いバージョン - config-schema

指定された配置のデフォルトの設定を取得します。

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

ibmcloud cdb deployment-configuration-schema はデフォルトのコンフィギュレーションを示している。現在の設定値を確認するには、データベースから直接設定をクエリしてください。

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--descriptionまたは-d 設定の説明を表示します。

例

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

`ibmcloud cdb deployment-configuration`

短いバージョン - configuration

指定したデプロイメントの構成を変更します。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。

例

PGSettings4 " という名前の PostgreSQL 配置の max_connections を 150 に変更します。

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

スケーリング

デプロイメントに割り振られているリソースの取得と構成を行います。

`ibmcloud cdb deployables-groups-show`

各デプロイメントはデプロイ可能なテンプレートから作成されます。 deployables-groups-show コマンドは、特定のタイプのデータベースの初期スケーリング・グループまたはデフォルト・スケーリング・グループを表示します。タイプ名は、deployables-show コマンドで検出することができます。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

PostgreSQL データベース展開のデフォルトのグループ設定を表示します。

ibmcloud cdb deployables-groups-show postgresql

`ibmcloud cdb deployment-groups`

短いバージョン - groups

デプロイメントのメンバーのスケーリング・グループ値を表示します。スケーリング・グループは、メモリー、CPU、およびディスクに関連しています。デフォルトのグループ名は「member」です。各グループについて、グループ内のノード数がその後に表示される：

メモリ- 総メモリ割り当て量、メンバーごとの割り当て量、最小割り当て量、および総メモリの増分で変化させることができます。
CPU- グループ専用のCPU数。専用の CPU が構成されていない場合、CPU セクションのすべてのフィールドに 0 の値が表示されます。 CPU グループは、調整可能な場合にのみ表示されます。
ディスク- ディスクの総割り当て量、メンバーごとの割り当て量、最小割り当て量、およびディスクの総割り当て量を変更できます。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyRedis" という名前のデータベース配置のスケーリンググループ設定を表示します。

ibmcloud cdb deployment-groups MyRedis

`ibmcloud cdb deployment-groups-set`

短いバージョン - groups-set

スケーリング・グループ (deployment-groups を参照) の値を設定します。ユーザーは、合計メモリー・サイズ (MB 単位) または合計ディスク・ストレージ (MB 単位) を設定することができます。これらはいずれも各メンバー間で均等に分割されます。割り振られる CPU の数も、利用可能な範囲で設定することができます。

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 は、これらの値の設定先となるグループの名前です。この名前は deployment-groups コマンドで見つけることができます。通常、これは「member」です。

コマンド・オプション

--memory <memory size>または-m 指定されたデプロイメント・グループの合計メモリーを MB 単位の値で設定します。
--disk <disk size>または-d 指定されたデプロイメント・グループの合計ディスク・サイズを MB 単位の値で設定します。
--cpu <value>または-c 専用 CPU コアの数を設定します。
--hostflavor <val> データベースのホスティングの種類を設定します。Shared Computeの場合は multitenant 、Isolated Computeの場合は各サイズから選択します。
--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。
--output または -o FORMAT 結果はJSONで。

例

"MyPGSQL" という名前の PostgreSQL 配置を「member」グループで設定し、合計メモリが 4096 MB になるようにします。

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

リージョン

現在のリージョンからデプロイメントをプロビジョニングできるすべてのリージョンを一覧表示します。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
api-version value リクエストに使用された API バージョン。

例

現在のリージョンから、デプロイメントをプロビジョニングできるすべてのリージョンを JSON で返す。

ibmcloud cdb regions --output, -o FORMAT

自動スケーリング

自動スケーリング構成は、デプロイメントの自動スケーリングを制御するさまざまな条件を表します。

`ibmcloud cdb deployment-autoscaling`

短いバージョン - autoscaling

特定のデプロイメントのすべての自動スケーリング条件を取得します。

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

自動スケーリングは現在、デプロイメント上のデータ・メンバーにのみ適用されるため、GROUP_ID は member となります。

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

ibmcloud cdb deployment-autoscaling elasticsearch-preproduction member

`ibmcloud cdb deployment-autoscaling-set`

短いバージョン - autoscaling-set

デプロイメント上の自動スケーリングの条件を有効化、無効化、または設定します。

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

自動スケーリングは現在、デプロイメント上のデータ・メンバーにのみ適用されるため、GROUP_ID は member となります。設定または設定解除する自動スケーリング・パラメーターは、JSON オブジェクトで定義します。

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--nowaitまたは-n コマンドの完了を待機しません。

例

このコマンドは、 elasticsearch-preproduction という名前のデプロイメントで、I/O 使用率が特定のしきい値に達したときにメモリをオートスケールするように設定します。

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

読み取り専用レプリカ

読み取り専用レプリカの取得と構成を行います。現時点では、PostgreSQL デプロイメントのみが読み取り専用レプリカをサポートします。

`ibmcloud cdb deployment-read-replicas`

短いバージョン - read-replicas

指定したデプロイメントのすべての読み取り専用レプリカをリストします。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--longまたは-l 出力に追加フィールドを表示します。

例

"MyPGSQL" という名前の PostgreSQL デプロイの読み取り専用レプリカを一覧表示します。

ibmcloud cdb deployment-read-replicas MyPGSQL

`ibmcloud cdb read-replica-leader`

短いバージョン - rr-leader

指定した読み取り専用レプリカ・デプロイメントのリーダーを返します。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--longまたは-l 出力に追加フィールドを表示します。

例

"MyPGSQL-replica" という名前の PostgreSQL 読み取り専用レプリカデプロイメントのリーダーをリストします。

ibmcloud cdb read-replica-leader MyPGSQL-replica

`ibmcloud cdb read-replica-promote`

短いバージョン - rr-promote

読み取り専用レプリカをスタンドアロン・インスタンスにプロモートします。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--nowaitまたは-n コマンドの完了を待機しません。
--skip-initial-backupまたはs データがリストアされた後、バックアップを取らずにインスタンスをリストアするオプションです。リストアされたデプロイメントが使用可能になるまでの時間が短縮されます。

例

"MyPGSQL-replica" という名前の PostgreSQL 読み取り専用レプリカ配置をスタンドアロン配置に昇格します。

ibmcloud cdb read-replica-promote MyPGSQL-replica

`ibmcloud cdb read-replica-resync`

短いバージョン - rr-resync

読み取り専用レプリカを再同期します。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
--nowaitまたは-n コマンドの完了を待機しません。

例

"MyPGSQL-replica" という名前の PostgreSQL 読み取り専用レプリカ配置を再同期します。

ibmcloud cdb read-replica-resync MyPGSQL-replica

バックアップ

デプロイメント上のバックアップを管理するか、オンデマンド・バックアップを取ります。

`ibmcloud cdb deployment-backups-list`

短いバージョン - backups

特定のデプロイメントに関連付けられているバックアップのリストを表示します。結果として、バックアップ ID、タイプ、状況、および作成日からなる表が表示されます。結果はソートされ、直近のバックアップが最初になります。

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

コマンド・オプション

--scheduledまたは-s スケジュールされたバックアップのみを出力します。
--firstまたは-f 見つかった最初 (または直近) のバックアップのみを出力します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

Postgres2000 " という名前の配置で使用可能なバックアップを表示します。

ibmcloud cdb backups Postgres2000

`ibmcloud cdb backup-show`

バックアップに関する詳細を表示します。バックアップは、CRN ID (deployment-backups-list コマンドで表示される ID) で識別されます。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

特定のバックアップの詳細を表示します。

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`

短いバージョン - backup-now

配置のオンデマンドバックアップを開始します。このコマンドは、実行中のバックアップをポーリングし、それが完了したら終了します。

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

コマンド・オプション

--nowaitまたは-n バックアップ・タスクの完了を待機しません。バックアップ・タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"PgTips" という配置のバックアップを作成します。

ibmcloud cdb deployment-backup-now PgTips

セキュリティー

デプロイメントの IP 許可リストを管理します。

`ibmcloud cdb deployment-allowlist-list`

短いバージョン - wl-ls

デプロイメントの現行許可リストを表示します。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyPSQL" 配置の現在の許可リストを一覧表示します。

ibmcloud cdb deployment-whitelist-list MyPSQL

`ibmcloud cdb deployment-allowlist-add`

短いバージョン - wl-add

デプロイメントの現行許可リストに IP アドレスまたは IP 範囲を追加します。 IP アドレスは IPv4 または IPv6 アドレスで、範囲は 1.2.3.0/24 のようなマスクされた IPv4 アドレスです。説明は、許可リストに記載されたアドレスまたは範囲を説明する、人間が読めるストリングであることが必要です。

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

コマンド・オプション

--nowaitまたは-n 許可リスト追加タスクの完了を待機しません。許可リスト追加タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

IP アドレス 198.51.100.1 を "MyPSQL" 配備の現在の allowlist に追加します。

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

IP 範囲 198.51.100.0 から 198.51.100.255 を "MyPSQL" 配置の現在の allowlist に追加します。

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

`ibmcloud cdb deployment-allowlist-delete`

短いバージョン - wl-del

デプロイメントの現行許可リストから IP アドレスまたは IP 範囲を削除します。 IP アドレスは IPv4 または IPv6 アドレスで、範囲は 1.2.3.0/24 のようなマスクされた IPv4 アドレスです。

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

コマンド・オプション

--nowaitまたは-n 許可リスト削除タスクの完了を待機しません。許可リスト削除タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyPSQL" 展開の現在の allowlist から IP アドレス 198.51.100.1 を削除します。

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

"MyPSQL" 配置の現在の allowlist から IP 範囲 198.51.100.0 から 198.51.100.255 を削除します。

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

タスク

デプロイメントに対してアクションを実行するたびにタスクが作成されます。タスクには、バックアップの作成、グループ・スケーリング、ユーザー・パスワードの変更などがあります。ほとんどの cdb コマンドは、実行中のタスクをポーリングし、それが完了したら終了します。この動作は、--nowait フラグを使って、タスク情報を返して終了するように変更することができます。成功したタスクのレコードは 24 時間から 48 時間表示され、失敗したタスクは 7 日から 8 日間表示されます。どの期間のタスクの履歴レコードも、Activity Tracker 統合を通じて入手できます。

`ibmcloud cdb deployment-tasks-list`

短いバージョン - tasks

指定したデプロイメントが作成されてからそこで実行されたすべてのタスクのリストを表示します。各タスクには、CRN、分かりやすい説明、完了比率、状況、および作成日が表示されます。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"NewRedis" という名前の配置に対して実行されたタスクのリストを表示します。

ibmcloud cdb deployment-tasks-list NewRedis

`ibmcloud cdb task-show`

短いバージョン - task

特定のタスクの状況を表示します。タスクは、CRN ID (deployment-tasks-list コマンドで表示される) で識別されます。タスクが実行中の場合、コマンドはタスクの完了を待機し、定期的にポーリングしながら状況の変化を報告します。

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

コマンド・オプション

--nowaitまたは-n タスクの完了を待機しません。ユーザー・パスワード変更タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

特定のバックアップタスクの詳細を表示する。

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

Elasticsearch デプロイメントに固有のタスクを実行します。

`ibmcloud cdb elasticsearch file-sync`

短いバージョン - fs

ibm_file_sync 索引にあるファイルをディスクに同期します。詳しくは、Elasticsearch へのファイルのアップロードの資料を参照してください。

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

コマンド・オプション

--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyElasticsearch" という名前の配置で、ファイルをディスクに同期します。

ibmcloud cdb elasticsearch file-sync MyElasticsearch

`ibmcloud cdb elasticsearch user-list`

短いバージョン - ul

データベース内部クレデンシャル・ストアからすべてのユーザをリストします。詳細については、ユーザーパスワードの取得と更新を参照してください。

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

コマンド・オプション

--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
-c DIRECTORY 証明書ルート
--api-version リクエストに使用された API バージョン。

例

user-list コマンドは、あなたのアカウントユーザーリストに様々なオプションを出力する。

ibmcloud cdb elasticsearch user-list

PostgreSQL

PostgreSQL デプロイメントに固有のタスクを実行します。

`ibmcloud cdb postgresql earliest-pitr-timestamp`

短いバージョン - ept

ポイント・イン・タイム・リカバリーが可能な最も古い時刻を ISO8601 UTC 形式で返します。詳しくは、ポイント・イン・タイム・リカバリーの資料を参照してください。

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

コマンド・オプション

--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

ibmcloud cdb postgresql earliest-pitr-timestamp postgresql-preproduction

`ibmcloud cdb postgresql replication-slot-create`

短いバージョン - rsc

新しい PostgreSQL レプリケーション・スロットを作成します。詳しくは、Wal2json の資料を参照してください。

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

プラグイン・タイプは「wal2json」にすることが必要です。

コマンド・オプション

--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyPostgres", "という名前の配置に、"testdb "という名前のデータベースと" slot1 "という名前のスロットをレプリケーションスロットとして作成します。

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

`ibmcloud cdb postgresql replication-slot-delete`

短いバージョン - rsd

指定した PostgreSQL レプリケーション・スロットを削除します。詳しくは、Wal2json の資料を参照してください。

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

コマンド・オプション

--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。

例

"MyPostgres" という名前の配置と " slot1 " という名前のスロットのレプリケーションスロットを削除します。

ibmcloud cdb postgresql replication-slot-delete MyPostgres slot1

MongoDB エンタープライズ

MongoDB Enterprise の展開に固有のタスクを実行する。

`ibmcloud cdb mongodbee earliest-pitr-timestamp`

短いバージョン - ept

ポイント・イン・タイム・リカバリーが可能な最も古い時刻を ISO8601 UTC 形式で返します。詳しくは Point in Time Recoveryを参照。

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

コマンド・オプション

--nowaitまたは-n グループ設定タスクの完了を待機しません。スケーリング・タスクの詳細を表示して終了します。
--output または -o FORMAT 出力フォーマットを指定します。 JSON のみがサポートされます。
api-version value リクエストに使用された API バージョン。

例

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

Redis

Redis 展開に特有のタスクを実行する。

`ibmcloud cdb redis user-set`

Redis ユーザーのロールを編集する。詳細については、 Redis RBACの管理を参照してください。

ibmcloud cdb redis user-set <"roles">

例

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