IBM Cloud Docs
App Configuration CLI

App Configuration CLI

IBM Cloud 命令行界面 (CLI) 为服务产品提供额外功能。IBM Cloud CLI 支持插件框架以扩展其功能。 可以从 IBM Cloud 插件存储库安装 App Configuration CLI 插件。 通过 App Configuration 服务 CLI 插件，您可以使用 CLI 命令轻松管理 App Configuration 服务实例。

要运行 IBM Cloud App Configuration 命令，请使用 ibmcloud app-configuration 或 ibmcloud ac。

先决条件

安装 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

为了在使用 CLI 时增强对数据的控制和安全性，您可以选择使用到 IBM Cloud 端点的专用路由。 必须首先在帐户中启用虚拟路由和转发，然后才能启用 IBM Cloud 专用服务端点。 有关设置帐户以支持专用连接选项的更多信息，请参阅 启用 VRF 和服务端点。

使用以下命令通过 CLI 登录到专用端点:

ibmcloud login -a private.cloud.ibm.com

ibmcloud ac 初始化

在继续初始化 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

输出

此命令返回以下输出 (实例名称后跟一个空格以及 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 环境列表

您可以使用以下命令列出所有环境:

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（可选）
环境标识。 如果未提供此值，那么名称将自动成为标识。 可选字段-作为标志或来自文件的输入。
--description DESCRIPTION（可选）
环境的描述。 可选字段-作为标志或来自文件的输入。
--tags TAGS（可选）
环境相关的标记。 可选字段-作为标志或来自文件的输入。
--color_code COLOR_CODE（可选）
区分环境的颜色代码。 颜色的十六进制代码。 可选字段-作为标志或来自文件的输入。
--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
环境标识
--expand EXPAND（可选）
该项的展开视图。
--include INCLUDE（可选）
包含响应中的功能和属性详细信息。

示例

要获取标识为 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（可选）
环境标识。 必需字段-作为标志或来自文件的输入。
--description DESCRIPTION（可选）
环境的描述。 必需字段-作为标志或来自文件的输入。
--tags TAGS（可选）
环境相关的标记。 必需字段-作为标志或来自文件的输入。
--color_code COLOR_CODE（可选）
区分环境的颜色代码。 颜色的十六进制代码。 必需字段-作为标志或来自文件的输入。
--file FILE
通过文件输入。 支持的文件格式-JSON

示例

要使用标志更新标识为 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
环境标识。

示例

要删除标识为 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 集合创建

您可以使用以下命令来创建集合:

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

命令选项

--name NAME
集合名称。 必需字段-作为标志或来自文件的输入。
--collection_id COLLECTION_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 集合获取

您可以使用以下命令获取集合:

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

命令选项

--collection_id COLLECTION_ID
集合的集合标识。
--expand EXPAND（可选）
集合详细信息的展开视图。
--include INCLUDE（可选）
包含响应中的功能和属性详细信息。

示例

要获取标识为 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
集合标识。 必需字段-作为标志或来自文件的输入。
--name NAME
集合名称。 必需字段-作为标志或来自文件的输入。
--description DESCRIPTION
集合描述。 必需字段-作为标志或来自文件的输入。
--tags TAGS (可选) 支持文件格式
集合相关标记。 必需字段-作为标志或来自文件的输入。
--file FILE
来自文件的输入。 支持的文件格式-JSON

示例

要使用标志更新标识为 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 集合删除

您可以使用以下命令来删除集合:

ibmcloud ac collection delete --collection_id COLLECTION_ID

命令选项

--collection_id COLLECTION_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
环境标识
--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
环境标识
--name NAME
功能名称。 必需字段-作为标志或来自文件的输入。
--feature_id FEATURE_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
环境标识
--feature_id FEATURE_ID
功能部件标志的功能部件标识。
--include INCLUDE（可选）
包含响应中的关联的集合。

示例

要获取标识为 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
环境标识
--name NAME
功能名称。 必需字段-作为标志或来自文件的输入。
--feature_id FEATURE_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 的功能部件的描述 (单击此处 以使用带有 "-- 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
环境标识
--name NAME
功能名称。 必需字段-作为标志或来自文件的输入。
--feature_id FEATURE_ID
功能标识。 必需字段-作为标志或来自文件的输入。
--description DESCRIPTION
功能部件的描述。 必需字段-作为标志或来自文件的输入。
--enabled_value ENABLED_VALUE
功能启用时的值。 必需字段-作为标志或来自文件的输入。
--disabled_value DISABLED_VALUE
功能部件不可用时的值。 必需字段-作为标志或来自文件的输入。
--tags TAGS
功能相关的标记。 必需字段-作为标志或来自文件的输入。
--segment_rules SEGMENT_RULES
指定用于为不同细分市场设置不同值的目标规则。
--file FILE
通过文件输入。 支持的文件格式-JSON

示例

要使用标志更新标识为 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
环境标识
--feature_id FEATURE_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
环境标识
--feature_id FEATURE_ID
功能标识
--enabled ENABLED
功能标志的状态。

示例

要切换标识为 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（可选）
分段标识。 如果未提供此值，那么名称将自动成为标识。 可选字段-作为标志或来自文件的输入。
--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
分段标识。
--include INCLUDE（可选）
指示根据段关联包含功能部件和属性详细信息。

示例

要获取标识为 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
分段标识。 必需字段-作为标志或来自文件的输入。
--description DESCRIPTION
段的描述。 必需字段-作为标志或来自文件的输入。
--rules RULES
确定实体是否属于分段的规则列表。 必需字段-作为标志或来自文件的输入。
--tags TAGS
分段相关标记。 必需字段-作为标志或来自文件的输入。
--file FILE
通过文件输入。 支持的文件格式-JSON

示例

要使用标志更新标识为 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
分段标识

示例

要删除标识为 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
环境标识
--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
环境标识
--name NAME
属性名。 必需字段-作为标志或来自文件的输入。
--property_id PROPERTY_ID（可选）
属性标识。 如果未提供此值，那么名称将自动成为标识。 可选字段-作为标志或来自文件的输入。
--description DESCRIPTION
属性的描述。 必需字段-作为标志或来自文件的输入。
--segment_rules SEGMENT_RULES
指定用于为不同细分市场设置不同值的目标规则。 必需字段-作为标志或来自文件的输入。
--tags TAGS
与属性关联的标记。 必需字段-作为标志或来自文件的输入。
--value VALUE
属性值。 必需字段-作为标志或来自文件的输入。
--type TYPE
属性类型。 必需字段-作为标志或来自文件的输入。
--collections COLLECTIONS
列出代表与指定属性关联的集合的集合标识。 必需字段-作为标志或来自文件的输入。
--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
环境标识
--property_id PROPERTY_ID
属性标志的属性标识。
--include INCLUDE（可选）
属性详细信息，用于在响应中包含相关集合或规则详细信息。

示例

要获取标识为 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
环境标识
--name NAME
属性名。 必需字段-作为标志或来自文件的输入。
--property_id PROPERTY_ID
属性标识。 必需字段-作为标志或来自文件的输入。
--description DESCRIPTION
属性的描述。 必需字段-作为标志或来自文件的输入。
--segment_rules SEGMENT_RULES
指定用于为不同细分市场设置不同值的目标规则。 必需字段-作为标志或来自文件的输入。
--tags TAGS
与属性关联的标记。 必需字段-作为标志或来自文件的输入。
--value VALUE
属性值。 必需字段-作为标志或来自文件的输入。
--collections COLLECTIONS
列出代表与指定属性关联的集合的集合标识。 必需字段-作为标志或来自文件的输入。
--file FILE
通过文件输入。 支持的文件格式-JSON

示例

要使用标志更新标识为 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 属性 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
环境标识
--name NAME
属性名。 必需字段-作为标志或来自文件的输入。
--property_id PROPERTY_ID
属性标识。 必需字段-作为标志或来自文件的输入。
--description DESCRIPTION
属性的描述。 必需字段-作为标志或来自文件的输入。
--segment_rules SEGMENT_RULES
指定用于为不同细分市场设置不同值的目标规则。 必需字段-作为标志或来自文件的输入。
--tags TAGS
与属性关联的标记。 必需字段-作为标志或来自文件的输入。
--value VALUE
属性值。 必需字段-作为标志或来自文件的输入。
--file FILE
通过文件输入。 支持的文件格式-JSON

示例

要使用标志更新标识为 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
环境标识
--property_id PROPERTY_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 文档。

使用文件标志 (不能与任何其他标志组合) 来给出文件的路径。

示例

要创建标识为 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

如果没有错误，那么卸载将返回成功消息。