App Configuration CLI コマンド ( 0.0.1- 1.0.14 のバージョンのみ有効)

ここに記載されているCLIコマンドは、廃止予定のバージョン 0.0.1 ～ 1.0.14 でのみ有効です。

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ドキュメントを参照してください。

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ドキュメントを参照してください

ibmcloud plug-in uninstall

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

ibmcloud plugin uninstall app-configuration

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

App Configuration CLI コマンド ( 0.0.1- 1.0.14 のバージョンのみ有効)

App Configuration CLI コマンド ( 0.0.1- 1.0.14 のバージョンのみ有効)

前提条件

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

コマンド・オプション

例