Cloud Databases 命令列介面

Cloud Databases CLI 外掛程式提供存取 Cloud Databases 服務功能的額外方法。您可以使用 Cloud Databases CLI 管理和連接下列服務：

CLI Cloud Databases 外掛程式需要安裝 IBM Cloud CLI。

CLI Cloud Databases 外掛程式 (cdb) 僅支援 Gen 1 執行個體。要管理第二代執行個體，請參閱第二代命令列 Cloud Databases 介面參考文件。

IBM Cloud CLI

IBM Cloud CLI 是通用的開發人員工具，可透過命令列介面存取您的 IBM Cloud 帳戶和服務。

IBM Cloud CLI 入門頁面上有介紹和安裝說明。如果您從提供的 cURL 指令中安裝 CLI，就可以獲得多種 IDE 的額外外掛程式和擴充套件選擇。

透過 IBM Cloud CLI 存取服務受 Identity and Access Management 規範。若要使用 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 平台上可部署資料庫及資料庫版本的相關資訊。此外，請取得 IBM Cloud 帳戶上所有 Cloud Databases 的清單。

`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 指令啟動連線。如果沒有在旗標中指定密碼，命令會以互動方式提示輸入密碼。外掛程式使用預設指令進行指令列互動和管理 CA 證書，以確保 TLS 會話的安全性。預設為以部署的管理員使用者連接。
--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 旗幟搭配使用。證書 root 值也可以在 $CERTROOT 環境變數中設定。
--only [app or cli] 或 -o 僅顯示與 app 連線或 cli 連線相關的設定。
--output 或 -o FORMAT 指定輸出格式。只支援 JSON。
--endpoint-type 或 -e 傳回連線字串的端點類型， public 或 private。預設值為 public。由於預設值是 public，如果沒有 public 端點，就找不到任何端點，您會收到一個錯誤：{"errors":"not_found"}。使用 -e private 標誌來使用 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 預設使用 admin 使用者取得憑證。在部署支援每個使用者憑證的情況下，此旗標可選擇允許指定使用者。
--save 或 -s 將已解碼的憑證儲存至憑證根目錄。預設值為 $ HOME/.cloud/plugins/cdb/cdbcerts/。
--certroot <path> 或 -c 使用該路徑作為憑證根目錄。如果路徑不存在，則會自動建立。可與 --save 旗幟搭配使用。證書 root 值也可以在 $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。

範例

從 "MyPSQL" 部署中移除名為「fred」的資料庫使用者。

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。

範例

將資料庫部署 "MyPSQL" 上使用者 "fred" 的密碼變更為 "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 和磁碟有關。預設群組名稱為「會員」。對於每個群組，群組中的節點數目都會顯示出來，接著是：

記憶體- 總記憶體分配、每個成員的分配、最小分配以及總記憶體可變更的增量。
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 指令找到。通常是「會員」。

指令選項

--memory <memory size> 或 -m 設定指定部署群組的總記憶體，以 MB 為單位。
--disk <disk size> 或 -d 設定指定部署群組的總磁碟大小，以 MB 為單位。
--cpu <value> 或 -c 設定專用 CPU 核心數量。
--hostflavor <val> 設定資料庫的主機類型：從 multitenant 選擇共用運算，或從獨立運算的個別大小選擇。
--nowait 或 -n 不要等待小組設定任務完成。顯示縮放任務的詳細資訊，然後退出。
--output 或 -o FORMAT 結果為 JSON。

範例

設定 PostgreSQL 部署名為 "MyPGSQL"，並設定「會員」群組的總記憶體為 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 在輸出中顯示其他欄位。

範例

列出 PostgreSQL 部署的唯讀複本，名稱為 "MyPGSQL"。

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 在輸出中顯示其他欄位。

範例

列出 PostgreSQL 唯讀複製部署的領導者，名稱為 "MyPGSQL-replica"。

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 請勿等待指令完成。

範例

重新yncs 名為 "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 指令所示。

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" 部署的目前 allowlist。

ibmcloud cdb deployment-whitelist-list MyPSQL

`ibmcloud cdb deployment-allowlist-add`

簡短版本 - wl-add

將 IP 位址或範圍加入部署的目前允許清單。 IP 位址是 IPv4 或 IPv6 位址，而範圍是遮罩的 IPv4 位址，例如 1.2.3.0/24。描述必須是人可讀取的字串，以描述允許清單中的位址或範圍。

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

從部署的目前 allowlist 中移除 IP 位址或範圍。 IP 位址是 IPv4 或 IPv6 位址，而範圍是遮罩的 IPv4 位址，例如 1.2.3.0/24。

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 格式回傳時間點復原的最早可用時間。如需詳細資訊，請參閱 Point in Time Recovery 文件。

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"