App Configuration 命令列介面指令（僅適用於版本 0.0.1- 1.0.14 ）

此處列出的命令列介面指令僅適用於即將廢棄的版本：0.0.1 至 1.0.14。

IBM Cloud 命令列介面（CLI）為服務方案提供額外功能。IBM Cloud CLI支援擴充功能的插件架構。您可從 IBM Cloud 插件庫安裝 App Configuration 命令列介面 (CLI) 插件。透過 App Configuration 服務命令列介面(CLI)外掛程式，您可輕鬆運用命令列指令管理 App Configuration 服務執行個體。

要執行 IBM Cloud App Configuration 指令，請使用 ibmcloud app-configuration 或 ibmcloud ac。

必要條件

一個 IBM Cloud 帳戶。如果您沒有帳號，請按一下這裡建立帳號。
一個 IBM Cloud App Configuration 服務。
IBM Cloud 命令列介面。
如果要使用 IBM Cloud 平台提供的私有端點支援，請確定啟用 VRF 和服務端點。

安裝 App Configuration CLI 外掛程式

從 IBM 外掛程式套件庫 IBM Cloud 執行下列指令，安裝 App Configuration CLI 外掛程式：

ibmcloud plugin install app-configuration

當 IBM Cloud 命令列介面及外掛程式有更新可用時，系統會透過命令列通知您。請務必將您的 CLI 保持最新狀態，以便能夠使用新指令。您可以執行 ibmcloud plugin list 查看所有已安裝外掛程式的目前版本。

輸出

該指令傳回下列輸出：

Looking up 'app-configuration' from repository 'IBM Cloud'...
Plug-in 'app-configuration' found in repository 'IBM Cloud'
Attempting to download the binary file...
[==============================================================================================================================================] 100.00%
Installing binary...
OK
Plug-in 'app-configuration' was successfully installed into /Users/<username>/.bluemix/plugins/app-configuration. Use 'ibmcloud plugin show app-configuration' to show its details.

為了在使用 CLI 時加強對資料的控制和安全性，您可以選擇使用專用路由到 IBM Cloud 端點。請先在您的帳戶中啟用虛擬路由與轉發功能，然後即可啟用 IBM Cloud 私有服務端點。如需進一步了解如何設定您的帳戶以支援私有連線選項，請參閱《啟用 VRF 與服務端點》。

使用下列指令透過 CLI 登入私人端點：

ibmcloud login -a private.cloud.ibm.com

ibmcloud ac init

在初始化 CLI 外掛程式之前，請確保您已在 IBM Cloud CLI 中選取正確的 API 端點、區域及帳戶。

請使用以下指令初始化 cli 外掛程式：

ibmcloud ac init --instance_id INSTANCE_ID

指令選項

--instance_id INSTANCE_ID（選用）: 要使用之 App Configuration 實例的 GUID。

範例

登入 IBM Cloud CLI 並將 CLI 初始化為 App Configuration 服務實例 App Configuration Instance 1。

ibmcloud ac init

輸出

該命令會返回以下輸出 (Instance name 後面有一個空格以及 GUID)：

Initializing IBM Cloud App Configuration Service plug-in...

Select a App Configuration instance:
1. App_Configuration_Instance_1 123
2. App_Configuration_Instance_2 456
Enter a number> 1
App Configuration instance selected is - App_Configuration_Instance_1 (GUID - 123)

IBM Cloud AC 展示

要查看正在使用的實例的名稱和 GUID，請使用此指令。

ibmcloud ac show

範例

先決條件 - 使用 ibmcloud ac init 指令先選擇一個實體。

ibmcloud ac show

輸出

該指令傳回下列輸出：

App Configuration instance being used is - App_Configuration_Instance_1 (GUID - 123)

ibmcloud ac 環境清單

您可以使用命令列出所有環境：

ibmcloud ac environment list [--expand EXPAND] [--sort SORT] [--tags TAGS] [--include INCLUDE] [--limit LIMIT] [--offset OFFSET]

指令選項

--limit LIMIT（選用）: 用於分頁。要擷取的記錄數目。
--offset OFFSET（選用）: 用於分頁。要跳過的記錄數目。
--tags TAGS（選用）: 根據標籤來過濾。
--sort SORT（選用）: 根據指定的屬性來排序詳細資料。
--expand EXPAND（選用）: 展開的視圖，其中含有項目。
--include INCLUDE（選用）: 將特性和內容詳細資料包含在回應中。

範例

若要列出所有環境，請執行以下指令：

ibmcloud ac environment list

輸出

該指令傳回下列輸出：

name               environment_id
Prod Environment   prodEnvironment
Dev environment    devEnvironment

IBMcloud ac 環境建立

您可以使用命令來建立環境：

ibmcloud ac environment create {--file FILE-PATH | --name NAME [--environment_id ENVIRONMENT_ID] [--description DESCRIPTION] [--tags TAGS] [--color_code COLOR_CODE]}

指令選項

--name NAME: 環境名稱。必填欄位 - 以旗標或檔案方式輸入。
--environment_id ENVIRONMENT_ID（選用）: 環境 ID。若未提供此值，名稱將自動成為 ID。可選欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION（選用）: 環境描述。可選欄位 - 以旗標或檔案方式輸入。
--tags TAGS（選用）: 與環境相關聯的標籤。可選欄位 - 以旗標或檔案方式輸入。
--color_code COLOR_CODE（選用）: 用來識別環境的顏色代碼。顏色的 Hex 代碼。可選欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標建立名稱為 Production_Environment 的環境 (按一下此處以 --file 旗標使用指令)，請執行下列指令：

ibmcloud ac environment create --name Production_Environment --environment_id prodEnvironment --description sampleDesc --tags sampleTag --color_code "#FF0000"

輸出

該指令傳回下列輸出：

updated_time     2021-05-21T05:28:07.000Z
name             Production_Environment
environment_id   prodEnvironment
description      sampleDesc
tags             sampleTag
color_code       #FF0000
created_time     2021-05-21T05:28:07.000Z

ibmcloud ac 環境獲取

您可以使用指令取得環境詳細資訊：

ibmcloud ac environment get --environment_id ENVIRONMENT_ID [--expand EXPAND] [--include INCLUDE]

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--expand EXPAND（選用）: 展開的視圖，其中含有項目。
--include INCLUDE（選用）: 將特性和內容詳細資料包含在回應中。

範例

若要取得 ID 為 prodEnvironment 的環境，請執行下列指令：

ibmcloud ac environment get --environment_id prodEnvironment

輸出

該指令傳回下列輸出：

name             Production_Environment
environment_id   prodEnvironment

ibmcloud ac 環境更新

您可以使用指令更新環境：

ibmcloud ac environment update (--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME --description DESCRIPTION --tags TAGS --color_code COLOR_CODE)

指令選項

--name NAME: 環境名稱。必填欄位 - 以旗標或檔案方式輸入。
--environment_id ENVIRONMENT_ID（選用）: 環境 ID。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION（選用）: 環境描述。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS（選用）: 與環境相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--color_code COLOR_CODE（選用）: 用來識別環境的顏色代碼。顏色的 Hex 代碼。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標更新 ID 為 prodEnvironment 的環境 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac environment update --name Production_Environment --environment_id prodEnvironment --description sampleUpdatedDesc --tags sampleUpdatedTag --color_code "#FF0000"

輸出

該指令傳回下列輸出：

name             Production_Environment
environment_id   prodEnvironment
description      sampleUpdatedDesc
tags             sampleUpdatedTag
color_code       #FF0000
created_time     2021-05-21T05:28:07.000Z
updated_time     2021-05-21T05:33:00.000Z

ibmcloud ac 環境刪除

您可以使用命令刪除環境：

ibmcloud ac environment delete --environment_id ENVIRONMENT_ID

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID。

範例

若要刪除 ID 為 prodEnvironment 的環境，請執行下列指令：

ibmcloud ac environment delete --environment_id prodEnvironment

輸出

該指令傳回下列輸出：

OK

ibmcloud ac 收集清單

您可以使用指令列出所有收藏集：

ibmcloud ac collection list [--sort SORT] [--limit LIMIT] [--offset OFFSET] [--features FEATURES] [--properties PROPERTIES] [--tags TAGS] [--expand EXPAND] [--include INCLUDE]

指令選項

--limit LIMIT（選用）: 用於分頁。要擷取的記錄數目。
--offset OFFSET（選用）: 用於分頁。要跳過的記錄數目。
--features FEATURES（選用）: 根據以逗號分隔的特徵清單篩選集合。
--properties PROPERTIES（選用）: 根據以逗號分隔的屬性清單篩選集合。
--tags TAGS（選用）: 根據標籤來過濾。
--sort SORT（選用）: 根據指定的屬性來排序詳細資料。
--expand EXPAND（選用）: 展開的視圖，其中含有項目。
--include INCLUDE（選用）: 將特性和內容詳細資料包含在回應中。

範例

若要列出所有集合，請執行以下指令：

ibmcloud ac collection list

輸出

該指令傳回下列輸出：

name                 collection_id
sample               sampleId
GHz Inc              ghzinc1

建立 ibmcloud ac collection

您可以使用指令建立集合：

ibmcloud ac collection create {--file FILE-PATH | --name NAME [--collection_id COLLECTION_ID] [--description DESCRIPTION] [--tags TAGS]}

指令選項

--name NAME: 集合名稱。必填欄位 - 以旗標或檔案方式輸入。
--collection_id COLLECTION_ID（選用）: 集合 ID。若未提供此值，名稱將自動成為 ID。可選欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION（選用）: 集合的說明。可選欄位 - 以旗標或檔案方式輸入。
--tags TAGS（選用）: 與集合相關聯的標籤。可選欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標建立名稱為 sample 的集合 (按一下此處以 --file 旗標使用指令)，請執行下列指令：

ibmcloud ac collection create --name sample --collection_id sampleId --description sampleDesc --tags sampleTag

輸出

該指令傳回下列輸出：

collection_id   sampleId
description     sampleDesc
created_time    2021-01-18T08:15:45Z
updated_time    2021-01-18T08:15:45Z
name            sample

ibmcloud ac collection 獲得

您可以使用指令取得集合：

ibmcloud ac collection get --collection_id COLLECTION_ID [--expand EXPAND] [--include INCLUDE]

指令選項

--collection_id COLLECTION_ID: 該收藏集的收藏集識別碼。
--expand EXPAND（選用）: 展開的視圖，其中含有集合詳細資料。
--include INCLUDE（選用）: 將特性和內容詳細資料包含在回應中。

範例

若要取得 ID 為 sampleId 的集合，請執行下列指令：

ibmcloud ac collection get --collection_id sampleId

輸出

該指令傳回下列輸出：

name            sample
collection_id   sampleId

ibmcloud ac 系列更新

您可以使用指令更新集合：

ibmcloud ac collection update {--file FILE-PATH | --name NAME --collection_id COLLECTION_ID --description DESCRIPTION --tags TAGS}

指令選項

--collection_id COLLECTION_ID: 集合 ID。必填欄位 - 以旗標或檔案方式輸入。
--name NAME: 集合名稱。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 集合的說明。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS (選購) 支援的檔案格式: 與集合相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 從檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標更新 ID 為 sampleId 的集合 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac collection update --collection_id sampleId --name sample --description sampleDesc --tags sampleTag

輸出

該指令傳回下列輸出：

name            sample
collection_id   sampleId
description     sampleDescUpdated
created_time    2021-01-18T08:15:45Z
updated_time    2021-01-19T05:57:27Z

ibmcloud ac collection 刪除

您可以使用指令刪除一個集合：

ibmcloud ac collection delete --collection_id COLLECTION_ID

指令選項

--collection_id COLLECTION_ID: 集合 ID

範例

若要刪除 ID 為 sampleId 的集合，請執行以下指令：

ibmcloud ac collection delete --collection_id sampleId

輸出

該指令傳回下列輸出：

OK

ibmcloud ac 功能清單

您可以使用指令列出所有功能：

ibmcloud ac feature list --environment_id ENVIRONMENT_ID [--sort SORT] [--limit LIMIT] [--offset OFFSET] [--tags TAGS] [--collections COLLECTIONS] [--segments SEGMENTS] [--expand EXPAND] [--include INCLUDE]

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--limit LIMIT（選用）: 用於分頁。要擷取的記錄數目。
--include INCLUDE（選用）: 回應中包含了關聯集合或規則詳細資料的特性詳細資料。
--offset OFFSET（選用）: 用於分頁。要跳過的記錄數目。
--collections COLLECTIONS（選用）: 根據以逗號分隔的集合清單來篩選功能。
--segments SEGMENTS（選用）: 根據以逗號分隔的區段清單篩選功能。
--expand EXPAND（選用）: 展開的視圖，其中含有項目。
--tags TAGS（選用）: 根據以逗號分隔的標籤清單篩選功能。
--sort SORT（選用）: 根據指定的屬性來排序詳細資料。

範例

若要列出所有功能，請執行以下指令：

ibmcloud ac feature list --environment_id "production"

輸出

該指令傳回下列輸出：

name            feature_id      segment_exists
Indian IBMers   ibm-discount    true
sampleFeature   sampleFeature   true
Cycle Rentals   cycle-rentals   true

建立 ibmcloud ac 功能

您可以使用指令建立功能：

ibmcloud ac feature create {--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME [--feature_id FEATURE_ID] --description DESCRIPTION --type TYPE --enabled_value ENABLED_VALUE --disabled_value DISABLED_VALUE --tags TAGS --enabled ENABLED --segment_rules SEGMENT_RULES --collections COLLECTIONS}

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--name NAME: 特性名稱。必填欄位 - 以旗標或檔案方式輸入。
--feature_id FEATURE_ID（選用）: 特性 ID。若未提供此值，名稱將自動成為 ID。可選欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 功能說明。必填欄位 - 以旗標或檔案方式輸入。
--type TYPE: 特性的類型（布林、字串、數字）。必填欄位 - 以旗標或檔案方式輸入。
--enabled_value ENABLED_VALUE: 已啟用特性的值。必填欄位 - 以旗標或檔案方式輸入。
--disabled_value DISABLED_VALUE: 已停用特性的值。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與特性相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--segment_rules SEGMENT_RULES: 請指定用於針對不同區段設定不同數值的定位規則。
--enabled ENABLED: 特性旗標的狀態。
--collections COLLECTIONS: 集合陣列。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標建立名稱為 sample 的集合 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac feature create --environment_id "production" --name "IBMers" --feature_id "ibm-discount" --description "Discount given to IBM employees" --type "BOOLEAN" --enabled_value true --disabled_value false --segment_rules '[{"rules":[{"segments":["ibm_employees"]}],"value": true,"order": 1}]' --collections '[{"collection_id":"corporatediscount","enabled": true}]'  --tags "discount,sale" --enabled true

輸出

該指令傳回下列輸出：

type             BOOLEAN
enabled_value    true
segment_rules    <Array>
collections      <Array>
name             IBMers
feature_id       ibm-discount
description      Discount given to IBM employees
disabled_value   false
enabled          true
created_time     2021-02-02T17:52:46Z
updated_time     2021-02-02T17:52:46Z

IBMcloud ac 功能獲取

您可以使用指令取得功能：

ibmcloud ac feature get --environment_id ENVIRONMENT_ID --feature_id FEATURE_ID [--include INCLUDE]

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--feature_id FEATURE_ID: 特徵旗標的特徵 ID。
--include INCLUDE（選用）: 將相關聯的集合包含在回應中。

範例

若要取得 ID 為 ibm-discount 的特徵，請執行下列指令：

ibmcloud ac feature get --environment_id "production" --feature_id ibm-discount

輸出

該指令傳回下列輸出：

name    type     disabled_value  updated_time          feature_id    description                      enabled_value  created_time          order  rules    value
IBMers  BOOLEAN  false           2021-02-02T17:52:46Z  ibm-discount  Discount given to IBM employees  true           2021-02-02T17:52:46Z  1      <Array>  true

ibmcloud ac 功能更新

您可以使用指令更新功能：

ibmcloud ac feature update {--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME --feature_id FEATURE_ID --description DESCRIPTION --enabled_value ENABLED_VALUE --disabled_value DISABLED_VALUE --enabled ENABLED --tags TAGS --segment_rules SEGMENT_RULES --collections COLLECTIONS}

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--name NAME: 特性名稱。必填欄位 - 以旗標或檔案方式輸入。
--feature_id FEATURE_ID: 特性 ID。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 功能說明。必填欄位 - 以旗標或檔案方式輸入。
--enabled_value ENABLED_VALUE: 已啟用特性的值。必填欄位 - 以旗標或檔案方式輸入。
--disabled_value DISABLED_VALUE: 已停用特性的值。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與特性相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--enabled ENABLED: 特性旗標的狀態。
--segment_rules SEGMENT_RULES: 請指定用於針對不同區段設定不同數值的定位規則。
--collections COLLECTIONS: 集合陣列。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON。

範例

若要使用旗標更新 ID 為 ibm-discount 的功能描述 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac feature update --environment_id "production" --name "Indian IBMers" --feature_id "ibm-discount" --description "Discount given to IBM Indian employees" --enabled_value true --disabled_value false --segment_rules '[{"rules":[{"segments":["ibm_employees"]}],"value": true,"order": 1}]' --collections '[{"collection_id":"corporatediscount","enabled": true}]'  --tags "discount,sale" --enabled true

輸出

該指令傳回下列輸出：

updated_time     2021-02-02T18:06:03Z
description      Discount given to IBM Indian employees
enabled_value    true
disabled_value   false
segment_rules    <Array>
created_time     2021-02-02T17:52:46Z
name             Indian IBMers
type             BOOLEAN
enabled          true
collections      <Array>

ibmcloud ac 功能更新值

您可以使用指令更新特徵的值 (此方法允許更新特徵名稱、特徵 enabled_value、特徵 disabled_value、標籤、描述和特徵區段規則，但此方法不允許切換特徵旗標和指定特徵到集合。)：

ibmcloud ac feature update-values {--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME --feature_id FEATURE_ID --description DESCRIPTION --enabled_value ENABLED_VALUE --disabled_value DISABLED_VALUE --tags TAGS --segment_rules SEGMENT_RULES}

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--name NAME: 特性名稱。必填欄位 - 以旗標或檔案方式輸入。
--feature_id FEATURE_ID: 特性 ID。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 功能說明。必填欄位 - 以旗標或檔案方式輸入。
--enabled_value ENABLED_VALUE: 已啟用特性的值。必填欄位 - 以旗標或檔案方式輸入。
--disabled_value DISABLED_VALUE: 當該功能不可用時，其值為何。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與特性相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--segment_rules SEGMENT_RULES: 請指定用於針對不同區段設定不同數值的定位規則。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標更新 ID 為 ibm-discount 的功能描述 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac feature update-values --environment_id "production" --name "Indian IBMers" --feature_id "ibm-discount" --description "Discount given to IBM Indian employees" --enabled_value true --disabled_value false --segment_rules '[{"rules":[{"segments":["ibm_employees"]}],"value": true,"order": 1}]'  --tags "discount,sale"

輸出

該指令傳回下列輸出：

updated_time     2021-02-02T18:06:03Z
description      Discount given to IBM Indian employees
enabled_value    true
disabled_value   false
segment_rules    <Array>
created_time     2021-02-02T17:52:46Z
name             Indian IBMers
type             BOOLEAN
collections      <Array>

ibmcloud ac 功能刪除

您可以使用指令刪除功能：

ibmcloud ac feature delete --environment_id ENVIRONMENT_ID --feature_id FEATURE_ID

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--feature_id FEATURE_ID: 特性 ID

範例

若要刪除 ID 為 ibm-discount 的特徵，請執行以下指令：

ibmcloud ac feature delete --environment_id "production" --feature_id ibm-discount

輸出

該指令傳回下列輸出：

OK

ibmcloud ac 功能切換

您可以使用指令切換特徵值：

ibmcloud ac feature toggle --environment_id ENVIRONMENT_ID --feature_id FEATURE_ID --enabled ENABLED

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--feature_id FEATURE_ID: 特性 ID
--enabled ENABLED: 特性旗標的狀態。

範例

若要切換 ID 為 ibm-discount 的特徵值，請執行下列指令：

ibmcloud ac feature toggle --environment_id "production" --feature_id ibm-discount --enabled false

輸出

該指令傳回下列輸出：

name    type     disabled_value  updated_time          feature_id    description                      enabled_value  created_time          order  rules    value
IBMers  BOOLEAN  false           2021-02-02T17:52:46Z  ibm-discount  Discount given to IBM employees  true           2021-02-02T17:52:46Z  1      <Array>  true

ibmcloud ac 區段清單

您可以使用指令列出所有區段：

ibmcloud ac segment list [--limit LIMIT] [--offset OFFSET] [--sort SORT] [--tags TAGS] [--expand EXPAND] [--include INCLUDE]

指令選項

--limit LIMIT（選用）: 用於分頁。要擷取的記錄數目。
--include INCLUDE（選用）: 回應中包含了關聯規則的區段詳細資料。
--offset OFFSET（選用）: 用於分頁。要跳過的記錄數目。
--expand EXPAND（選用）: 展開的視圖，其中含有區段詳細資料。
--tags TAGS（選用）: 根據以逗號分隔的標籤清單篩選區段。
--sort SORT（選用）: 根據指定的屬性來排序詳細資料。

範例

若要列出所有區段，請執行以下指令：

ibmcloud ac segment list

輸出

該指令傳回下列輸出：

name            segment_id
India IBMers    ibm_employees_01
IBM Employees   ibm_employees

建立 ibmcloud ac 區段

您可以使用指令建立區段：

ibmcloud ac segment create {--file FILE-PATH | --name NAME [--segment_id SEGMENT_ID] --description DESCRIPTION --tags TAGS --rules RULES}

指令選項

--name NAME: 區段名稱。必填欄位 - 以旗標或檔案方式輸入。
--segment_id SEGMENT_ID（選用）: 區段 ID。若未提供此值，名稱將自動成為 ID。可選欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 區段描述。必填欄位 - 以旗標或檔案方式輸入。
--rules RULES: 用以判定該實體是否屬於該分部的規則清單。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與區段相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標建立名稱為 sample 的集合 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac segment create --name "IBM Employees" --segment_id "ibm_employees" --description "IBM Employees Segment" --tags "ibm" --rules '[{"attribute_name": "email", "operator": "endsWith", "values": ["@ibm.com"]}]'

輸出

該指令傳回下列輸出：

name           IBM Employees
segment_id     ibm_employees
description    IBM Employees Segment
created_time   2021-02-02T19:04:22Z
updated_time   2021-02-02T19:04:22Z

ibmcloud ac 區段取得

您可以使用指令取得區段：

ibmcloud ac segment get --segment_id SEGMENT_ID [--include INCLUDE]

指令選項

--segment_id SEGMENT_ID: 區段 ID。
--include INCLUDE（選用）: 指示應根據區段關聯，納入特徵與屬性的詳細資訊。

範例

若要取得 ID 為 ibm_employees 的區段，請執行下列指令：

ibmcloud ac segment get --segment_id ibm_employees

輸出

該指令傳回下列輸出：

segment_id     description    features  created_time          updated_time          name           attribute_name  operator  values
ibm_employees  IBM Employees  -         2021-02-02T19:04:22Z  2021-02-02T19:04:22Z  IBM Employees  email           endsWith  <Array>

ibmcloud ac 區塊更新

您可以使用指令更新區段：

ibmcloud ac segment update {--file FILE-PATH | --name NAME --segment_id SEGMENT_ID --description DESCRIPTION --tags TAGS --rules RULES}

指令選項

--name NAME: 區段名稱。必填欄位 - 以旗標或檔案方式輸入。
--segment_id SEGMENT_ID: 區段 ID。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 區段描述。必填欄位 - 以旗標或檔案方式輸入。
--rules RULES: 用以判定該實體是否屬於該分部的規則清單。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與區段相關聯的標籤。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標更新 ID 為 ibm_employees 的區段的描述 (按一下此處以使用 '--file' 旗標的指令)，請執行下列指令：

ibmcloud ac segment update --name "IBM India Employees" --segment_id "ibm_employees" --description "IBM India Employees" --tags "ibm" --rules '[{"attribute_name": "email", "operator": "endsWith", "values": ["@in.ibm.com"]}]'

輸出

該指令傳回下列輸出：

description    IBM India Employees
created_time   2021-02-02T19:04:22Z
updated_time   2021-02-02T19:10:01Z
name           IBM India Employees
segment_id     ibm_employees

ibmcloud ac 區段刪除

您可以使用指令刪除區段：

ibmcloud ac segment delete --segment_id SEGMENT_ID

指令選項

--segment_id SEGMENT_ID: 區段 ID

範例

若要刪除 ID 為 ibm_employees 的區段，請執行以下指令：

ibmcloud ac segment delete --segment_id ibm_employees

輸出

該指令傳回下列輸出：

OK

ibmcloud ac 屬性清單

您可以使用指令列出所有屬性：

ibmcloud ac property list --environment_id ENVIRONMENT_ID [--expand EXPAND] [--sort SORT] [--tags TAGS] [--include INCLUDE] [--collections COLLECTIONS] [--segments SEGMENTS] [--limit LIMIT] [--offset OFFSET]

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--limit LIMIT（選用）: 用於分頁。要擷取的記錄數目。
--include INCLUDE（選用）: 回應中包含了關聯規則的區段詳細資料。
--offset OFFSET（選用）: 用於分頁。要跳過的記錄數目。
--collections COLLECTIONS（選用）: 根據以逗號分隔的集合清單來篩選功能。
--segments SEGMENTS（選用）: 根據以逗號分隔的區段清單篩選功能。
--expand EXPAND（選用）: 展開的視圖，其中含有區段詳細資料。
--tags TAGS（選用）: 根據以逗號分隔的標籤清單篩選區段。
--sort SORT（選用）: 根據指定的屬性來排序詳細資料。

範例

若要列出所有屬性，請執行以下指令：

ibmcloud ac property list --environment_id "production"

輸出

該指令傳回下列輸出：

collections   name             property_id      description                 type      value   tags                        segment_rules
-             Email property   email-property   Property for email Update   BOOLEAN   false   version: 1.1, pre-release   -
-             name             name             desc                        NUMERIC   1       tags                        -

建立 ibmcloud ac 屬性

您可以使用指令來建立屬性：

ibmcloud ac property create (--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME [--property_id PROPERTY_ID] --description DESCRIPTION --type TYPE --value VALUE --tags TAGS --segment_rules SEGMENT-RULES --collections COLLECTIONS)

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--name NAME: 財產名稱。必填欄位 - 以旗標或檔案方式輸入。
--property_id PROPERTY_ID（選用）: 內容 ID。若未提供此值，名稱將自動成為 ID。可選欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 內容的說明。必填欄位 - 以旗標或檔案方式輸入。
--segment_rules SEGMENT_RULES: 請指定用於針對不同區段設定不同數值的定位規則。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與該物業相關的標籤。必填欄位 - 以旗標或檔案方式輸入。
--value VALUE: 內容值。必填欄位 - 以旗標或檔案方式輸入。
--type TYPE: 內容類型。必填欄位 - 以旗標或檔案方式輸入。
--collections COLLECTIONS: 代表與指定內容相關聯之集合的集合 ID 清單。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標建立名稱為 email-property 的屬性 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac property create --environment_id "production" --name Email_Property --property_id email-property --description Email_Property --type STRING --value VALUE --tags tags --segment_rules '[{"rules":[{"segments":["kmu9n7px"]}],"value":"$default","order":1}]' --collections '[]'

輸出

該指令傳回下列輸出：

name             Email_Property
description      Email_Property
type             STRING
value            VALUE
segment_rules    <Array>
property_id      email-property
segment_exists   true
tags             tags
collections      -

ibmcloud ac 屬性取得

您可以使用指令取得屬性：

ibmcloud ac property get --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID [--include INCLUDE]

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--property_id PROPERTY_ID: 屬性標誌的屬性 ID。
--include INCLUDE（選用）: 回應中包含了關聯集合或規則詳細資料的內容詳細資料。

範例

若要取得 ID 為 email-property 的屬性，請執行下列指令：

ibmcloud ac property get --environment_id "production" --property_id email-property

輸出

該指令傳回下列輸出：

tags                        collections   name             property_id      description                 type      value   rules     value   order
version: 1.1, pre-release   -             Email_Property   email-property   Property for email Update   BOOLEAN   false   <Array>   true    1

ibmcloud ac 財產更新

您可以使用指令更新屬性：

ibmcloud ac property update (--file FILE-PATH | --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID [--name NAME] [--description DESCRIPTION] [--value VALUE] [--tags TAGS] [--segment_rules SEGMENT-RULES] [--collections COLLECTIONS])

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--name NAME: 財產名稱。必填欄位 - 以旗標或檔案方式輸入。
--property_id PROPERTY_ID: 內容 ID。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 內容的說明。必填欄位 - 以旗標或檔案方式輸入。
--segment_rules SEGMENT_RULES: 請指定用於針對不同區段設定不同數值的定位規則。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與該物業相關的標籤。必填欄位 - 以旗標或檔案方式輸入。
--value VALUE: 內容值。必填欄位 - 以旗標或檔案方式輸入。
--collections COLLECTIONS: 代表與指定內容相關聯之集合的集合 ID 清單。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標更新 ID 為 email-property 的屬性描述 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac property update --environment_id "production" --name Email_Property --property_id email-property --description Email_Property_Updated --value VALUE --tags Updated_Tags --segment_rules '[{"rules":[{"segments":["kmu9n7px"]}],"value":"$default","order":1}]' --collections '[]'

輸出

該指令傳回下列輸出：

name             Email_Property
value            VALUE
segment_rules    <Array>
collections      -
tags             Updated_Tags
property_id      email-property
segment_exists   true
description      Email_Property_Updated
type             STRING

ibmcloud ac 屬性更新值

您可以使用指令更新屬性值(可以更新屬性值和目標規則，但此方法不允許指定屬性為集合。)：

ibmcloud ac property update-values (--file FILE-PATH | --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID [--name NAME] [--description DESCRIPTION][--value VALUE] [--tags TAGS] [--segment_rules SEGMENT-RULES])

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--name NAME: 財產名稱。必填欄位 - 以旗標或檔案方式輸入。
--property_id PROPERTY_ID: 內容 ID。必填欄位 - 以旗標或檔案方式輸入。
--description DESCRIPTION: 內容的說明。必填欄位 - 以旗標或檔案方式輸入。
--segment_rules SEGMENT_RULES: 請指定用於針對不同區段設定不同數值的定位規則。必填欄位 - 以旗標或檔案方式輸入。
--tags TAGS: 與該物業相關的標籤。必填欄位 - 以旗標或檔案方式輸入。
--value VALUE: 內容值。必填欄位 - 以旗標或檔案方式輸入。
--file FILE: 透過檔案輸入。支援的檔案格式 - JSON

範例

若要使用旗標更新 ID 為 email-property 的屬性描述 (按一下此處以 '--file' 旗標使用指令)，請執行下列指令：

ibmcloud ac property update-values --environment_id "production" --name Email_Property --property_id email-property --description Email_Property_Updated --value VALUE --tags Updated_Tags --segment_rules '[{"rules":[{"segments":["kmu9n7px"]}],"value":"$default","order":1}]'

輸出

該指令傳回下列輸出：

name             Email_Property
value            VALUE
segment_rules    <Array>
tags             Updated_Tags
property_id      email-property
segment_exists   true
description      Email_Property_Updated
type             STRING

ibmcloud ac 屬性刪除

您可以使用指令刪除屬性：

ibmcloud ac property delete --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID

指令選項

--environment_id ENVIRONMENT_ID: 環境 ID
--property_id PROPERTY_ID: 內容 ID

範例

若要刪除 ID 為 ibm_employees 的屬性，請執行以下指令：

ibmcloud ac property delete --environment_id "production" --property_id ibm_employees

輸出

該指令傳回下列輸出：

OK

ibmcloud ac 匯出

您可以使用命令匯出所選實例的組態資料：

ibmcloud ac export [--file FILE] [--output OUTPUT]

指令選項

--file FILE（選用）: 要將設定匯出至該位置的檔案路徑。
--output OUTPUT（選用）: 選擇輸出格式 - 可以是「JSON」或「yaml」。(預設為 "JSON")

範例

若要匯出所選實例的組態資料，請執行下列指令：

ibmcloud ac export --file exportedConfig.json

輸出

該指令傳回下列輸出：

OK
Configuration exported to file exportedConfig.json

ibmcloud ac 匯入

您可以使用指令，從檔案匯入設定資料到選取的實例：

ibmcloud ac import --file FILE [--clean CLEAN]

指令選項

--file FILE: 將從該檔案路徑匯入設定。
--clean CLEAN（選用）: 若設定為「true」，則會在匯入配置資料之前，清除服務實例中的現有資料。

範例

若要從檔案匯入設定資料到選取的實例，請執行下列指令：

ibmcloud ac import --file exportedConfig.json

輸出

該指令傳回下列輸出：

OK
Configuration imported from file exportedConfig.json

從檔案建立或更新項目

該外掛程式提供您以儲存於檔案中的 JSON 格式建立或更新項目的功能。

這就是從檔案建立集合的方法。

ibmcloud ac collection create {--file FILE-PATH | --name NAME [--collection_id COLLECTION_ID] [--description DESCRIPTION] [--tags TAGS]}

請注意「|」符號。這表示有兩種使用指令的方式。

ibmcloud ac collection create --file FILE-PATH
OR
ibmcloud ac collection create --name NAME [--collection_id COLLECTION_ID] [--description DESCRIPTION] [--tags TAGS]

若要檢視支援的 JSON 格式，請參閱 API 文件。

使用 file 標誌 (不能與任何其他標誌結合) 來提供檔案的路徑。

範例

若要建立一個 ID 為 corporateDiscount 的集合，並儲存在檔案中 create_collection_body.json，執行以下指令：

ibmcloud ac collection create --file create_collection_body.json

以下是 create_collection_body.json 的內容：

{
    "name": "Corporate Discount",
    "collection_id": "corporateDiscount",
    "description": "Discount for partner Organizations",
    "tags": "discount,sale"
}

輸出

該指令傳回下列輸出：

name            Corporate Discount
collection_id   corporateDiscount
description     Discount for partner Organizations
created_time    2021-02-02T19:17:07Z
updated_time    2021-02-02T19:17:07Z

建立和更新集合、特徵或區段的行為與前述相似。有關接受的 JSON 格式結構，請參閱 API 文件

解除安裝 ibmcloud 外掛程式

使用此指令卸載 App Configuration CLI 外掛程式。

ibmcloud plugin uninstall app-configuration

如果沒有錯誤，解除安裝會返回成功訊息。

App Configuration 命令列介面指令（僅適用於版本 0.0.1- 1.0.14 ）

App Configuration 命令列介面指令（僅適用於版本 0.0.1- 1.0.14 ）

必要條件

安裝 App Configuration CLI 外掛程式

輸出

使用私有端點登入 CLI

ibmcloud ac init

指令選項

範例

輸出

IBM Cloud AC 展示

範例

輸出

ibmcloud ac 環境清單

指令選項

範例

輸出

IBMcloud ac 環境建立

指令選項

範例

輸出

ibmcloud ac 環境獲取

指令選項

範例

輸出

ibmcloud ac 環境更新

指令選項

範例

輸出

ibmcloud ac 環境刪除

指令選項

範例

輸出

ibmcloud ac 收集清單

指令選項

範例

輸出

建立 ibmcloud ac collection

指令選項

範例

輸出

ibmcloud ac collection 獲得

指令選項

範例

輸出

ibmcloud ac 系列更新

指令選項

範例

輸出

ibmcloud ac collection 刪除

指令選項

範例

輸出

ibmcloud ac 功能清單

指令選項

範例

輸出

建立 ibmcloud ac 功能

指令選項

範例

輸出

IBMcloud ac 功能獲取

指令選項

範例

輸出

ibmcloud ac 功能更新

指令選項

範例

輸出

ibmcloud ac 功能更新值

指令選項

範例

輸出

ibmcloud ac 功能刪除

指令選項

範例

輸出

ibmcloud ac 功能切換

指令選項

範例