App Configuration CLI

IBM Cloud コマンド・ライン・インターフェース (CLI) は、サービス・オファリングの追加機能を提供します。 IBM Cloud CLI は、その機能を拡張するためにプラグイン・フレームワークをサポートします。 App Configuration プラグイン・リポジトリーから IBM Cloud CLI プラグインをインストールできます。 App Configuration サービス CLI プラグインを使用すると、CLI コマンドを使用して App Configuration サービス・インスタンスを簡単に管理できます。

IBM Cloud App Configuration コマンドを実行するには、ibmcloud app-configuration または ibmcloud ac を使用します。

前提条件

IBM Cloud アカウント。アカウントをお持ちでない場合には、ここをクリックして作成してください。
IBM Cloud App Configuration サービスのインスタンス。
IBM CloudCLI
オプションで、 IBM Cloud プラットフォームによって提供されるプライベート・エンドポイント・サポートを使用する場合は、 VRF およびサービス・エンドポイントを有効にする必要があります。

App Configuration CLI プラグインのインストール

以下のコマンドを実行して、IBM プラグイン・リポジトリー IBM Cloud から、App Configuration CLI プラグインをインストールします。

ibmcloud plugin install app-configuration

IBM Cloud CLI およびプラグインの更新が使用可能になると、コマンド・ラインで通知されます。新しいコマンドを使用できるように、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 にログインし、App Configuration サービス・インスタンス App Configuration Instance 1 に対して CLI を初期化します。

ibmcloud ac init

出力

このコマンドは、以下の出力を返します (インスタンス名の後にスペースと 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)

ibmcloud ac show

使用されているインスタンスの名前と GUID を確認するには、次のコマンドを使用します。

ibmcloud ac show

例

前提条件 - 最初に ibmcloud ac init コマンドを使用してインスタンスを選択します。

ibmcloud ac show

出力

このコマンドは以下の出力を返します。

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

ibmcloud ac environment list

以下のコマンドを使用して、環境をすべてリストできます。

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 environment create

以下のコマンドを使用して、環境を作成できます。

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 (オプション): 環境を区別するための色分け。色の 16 進コード。オプション・フィールド - フラグとして、またはファイルから入力します。
--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 environment get

以下のコマンドを使用して、環境の詳細を取得できます。

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 environment update

以下のコマンドを使用して、環境を更新できます。

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 (オプション): 環境を区別するための色分け。色の 16 進コード。必須フィールド - フラグとして、またはファイルから入力します。
--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 environment delete

以下のコマンドを使用して、環境を削除できます。

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 collection list

以下のコマンドを使用して、コレクションをすべてリストできます。

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 create

以下のコマンドを使用して、コレクションを作成できます。

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 get

以下のコマンドを使用して、コレクションを取得できます。

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

コマンド・オプション

--collection_id COLLECTION_ID: コレクションのコレクション ID。
--expand EXPAND (オプション): コレクションの詳細の拡張ビュー。
--include INCLUDE (オプション): 応答内に機能およびプロパティーの詳細を組み込みます。

例

sampleId という ID のコレクションを取得するには、以下のコマンドを実行します。

ibmcloud ac collection get --collection_id sampleId

出力

このコマンドは以下の出力を返します。

name            sample
collection_id   sampleId

ibmcloud ac collection update

以下のコマンドを使用して、コレクションを更新できます。

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

例

フラグを使用して sampleId という ID のコレクションを更新するには (コマンドと' -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 delete

以下のコマンドを使用して、コレクションを削除できます。

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 feature list

以下のコマンドを使用して、機能をすべてリストできます。

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 feature create

以下のコマンドを使用して、機能を作成できます。

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 feature get

以下のコマンドを使用して、機能を取得できます。

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 (オプション): 応答内に関連するコレクションを組み込みます。

例

ibm-discount という ID の機能を取得するには、以下のコマンドを実行します。

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 feature update

以下のコマンドを使用して、機能を更新できます。

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。

例

フラグを使用して ibm-discount という ID の機能を更新するには (コマンドと' -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 feature update-values

次のコマンドを使用して、フィーチャーの値を更新することができます (この方法では、フィーチャー名、フィーチャーの 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

例

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 feature delete

以下のコマンドを使用して、機能を削除できます。

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

コマンド・オプション

--environment_id ENVIRONMENT_ID: 環境ID
--feature_id FEATURE_ID: 機能 ID

例

ibm-discount という ID の機能を削除するには、以下のコマンドを実行します。

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

出力

このコマンドは以下の出力を返します。

OK

ibmcloud ac feature toggle

以下のコマンドを使用して、機能値を切り替えることができます。

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: 機能フラグの状態。

例

ibm-discount という ID の機能値を切り替えるには、以下のコマンドを実行します。

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 segment list

以下のコマンドを使用して、セグメントをすべてリストできます。

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 segment create

以下のコマンドを使用して、セグメントを作成できます。

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

例

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 segment get

以下のコマンドを使用して、セグメントを取得できます。

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

コマンド・オプション

--segment_id SEGMENT_ID: セグメント ID。
--include INCLUDE (オプション): セグメントの関連付けに基づいて機能およびプロパティーの詳細を組み込むように指示します。

例

ibm_employees という ID のセグメントを取得するには、以下のコマンドを実行します。

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 segment update

以下のコマンドを使用して、セグメントを更新できます。

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

例

フラグを使用して ibm_employees という ID のセグメントを更新するには (コマンドと' -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 segment delete

以下のコマンドを使用して、セグメントを削除できます。

ibmcloud ac segment delete --segment_id SEGMENT_ID

コマンド・オプション

--segment_id SEGMENT_ID: セグメントID

例

ibm_employees という ID のセグメントを削除するには、以下のコマンドを実行します。

ibmcloud ac segment delete --segment_id ibm_employees

出力

このコマンドは以下の出力を返します。

OK

ibmcloud ac property list

以下のコマンドを使用して、プロパティーをすべてリストできます。

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 property create

以下のコマンドを使用して、プロパティーを作成できます。

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 property get

以下のコマンドを使用して、プロパティーを取得できます。

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 (オプション): 応答に関連付けられているコレクションまたはルールの詳細を含めるためのプロパティーの詳細。

例

email-property という ID のプロパティーを取得するには、以下のコマンドを実行します。

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 property update

以下のコマンドを使用して、プロパティーを更新できます。

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

例

フラグを使用して email-property という ID のプロパティーを更新するには (コマンドと' -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 property update-values

以下のコマンドを使用して、プロパティー値を更新できます (プロパティーの値やターゲット設定ルールを更新することはできますが、この方法ではプロパティーをコレクションに割り当てることはできません)。

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

例

フラグを使用して email-property という ID のプロパティーの説明を更新するには (コマンドと '--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 property delete

以下のコマンドを使用して、プロパティーを削除できます。

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

コマンド・オプション

--environment_id ENVIRONMENT_ID: 環境ID
--property_id PROPERTY_ID: プロパティーID

例

ibm_employees という ID のプロパティーを削除するには、以下のコマンドを実行します。

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

出力

このコマンドは以下の出力を返します。

OK

ibmcloud ac export

以下のコマンドを使用して、選択したインスタンスの構成データをエクスポートできます。

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 import

以下のコマンドを使用して、ファイルからの構成データを、選択したインスタンスにインポートできます。

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]}

「|」記号に注意してください。この記号は、このコマンドの使用法が 2 つあることを示しています。

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

サポートされている JSON 形式を確認するには、API Docs を参照してください。

file フラグを使用して (その他のフラグと組み合わせることはできません)、ファイルのパスを指定します。

例

ファイル corporateDiscountcreate_collection_body.json* 内に保管される、* というID のコレクションを作成するには、以下のコマンドを実行します。

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 Docs を参照してください

ibmcloud plug-in uninstall

以下のコマンドを使用して、App Configuration CLI プラグインをアンインストールします。

ibmcloud plugin uninstall app-configuration

アンインストールでエラーがなければ、成功メッセージが返されます。

App Configuration CLI

前提条件

App Configuration CLI プラグインのインストール

出力

プライベート・エンドポイントを使用した CLI へのログイン

ibmcloud ac init

コマンド・オプション

例

出力

ibmcloud ac show

例

出力

ibmcloud ac environment list

コマンド・オプション

例

出力

ibmcloud ac environment create

コマンド・オプション

例

出力

ibmcloud ac environment get

コマンド・オプション

例

出力

ibmcloud ac environment update

コマンド・オプション

例

出力

ibmcloud ac environment delete

コマンド・オプション

例

出力

ibmcloud ac collection list

コマンド・オプション

例

出力

ibmcloud ac collection create

コマンド・オプション

例

出力

ibmcloud ac collection get

コマンド・オプション

例

出力

ibmcloud ac collection update

コマンド・オプション

例

出力

ibmcloud ac collection delete

コマンド・オプション

例

出力

ibmcloud ac feature list

コマンド・オプション

例

出力

ibmcloud ac feature create

コマンド・オプション

例

出力

ibmcloud ac feature get

コマンド・オプション

例

出力

ibmcloud ac feature update

コマンド・オプション

例

出力

ibmcloud ac feature update-values

コマンド・オプション

例

出力

ibmcloud ac feature delete

コマンド・オプション

例

出力

ibmcloud ac feature toggle

コマンド・オプション

例

出力