az arcdata dc config

Note

This reference is part of the arcdata extension for the Azure CLI (version 2.3.1 or higher). 该扩展会在首次运行 az arcdata dc config 命令时自动安装。 Learn more about extensions.

Configuration commands.

命令

名称	说明	类型	Status
az arcdata dc config add	在配置文件中添加 json 路径的值。	Extension	GA
az arcdata dc config init	初始化可用于 az arcdata dc create的数据控制器配置文件。	Extension	GA
az arcdata dc config list	列出可用的配置文件选项。	Extension	GA
az arcdata dc config patch	基于 json 修补程序文件修补配置文件。	Extension	GA
az arcdata dc config remove	删除配置文件中 json 路径的值。	Extension	GA
az arcdata dc config replace	替换配置文件中 json 路径的值。	Extension	GA
az arcdata dc config show	返回数据控制器自定义资源的配置。	Extension	GA

az arcdata dc config add

在配置文件中添加 json 路径的值。

在配置文件中的 json 路径处添加值。 以下所有示例都在 Bash 中提供。 如果使用另一个命令行，则可能需要适当地转义。 或者，可以使用修补程序文件功能。

az arcdata dc config add --config-file
                         --json-values
                         --path

示例

添加数据控制器存储。

az arcdata dc config add --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必需参数

--config-file -c

已放弃

选项“-c”已弃用，将在将来的版本中删除。 请改用“-p”。

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

--json-values -j

指向值的 json 路径的键值对列表：key1.subkey1=value1，key2.subkey2=value2。 可以提供内联 json 值，例如：key='{“kind”：“cluster”，“name”：“test-cluster”}'或提供文件路径，如 key=./values.json。 add 命令不支持条件。 如果提供的内联值本身是键值对本身与“=”和“，”转义这些字符。 例如，key1=“key2=val2，key3=val3”。 有关路径外观的示例，请参阅 http://jsonpatch.com/。 如果要访问数组，则必须通过指示索引（如 key.0=value）来执行此作。

--path -p

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az arcdata dc config init

初始化可用于 az arcdata dc create的数据控制器配置文件。

初始化可用于 az arcdata dc create的数据控制器配置文件。 可以在参数中指定配置文件的特定源。

az arcdata dc config init [--force]
                          [--path]
                          [--source]
                          [--target]

示例

引导式数据控制器配置初始化体验 - 将收到所需值的提示。

az arcdata dc config init

arcdata dc config init 与参数，在 ./custom 中创建 aks-dev-test 的配置配置文件。

az arcdata dc config init --source azure-arc-kubeadm --path custom

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force -f

强制覆盖目标文件。

--path -p

要放置配置文件的文件路径，默认为 cwd/custom。

--source -s

配置文件源：['azure-arc-ake'， 'azure-arc-aks-default-storage'， 'azure-arc-aks-dev-test'， “azure-arc-aks-hci”、“azure-arc-aks-premium-storage”、“azure-arc-azure-openshift”、“azure-arc-eks”、“azure-arc-gke”、“azure-arc-kubeadm”、“azure-arc-kubeadm-dev-test”、“azure-arc-openshift”、“azure-arc-unit-test”。

--target -t

已放弃

选项“-t”已弃用，将在将来的版本中删除。 请改用“-p”。

要放置配置文件的文件路径，默认为 cwd/custom。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az arcdata dc config list

列出可用的配置文件选项。

列出可用于 arcdata dc config init的可用配置文件选项。

az arcdata dc config list [--config-profile]

示例

显示所有可用的配置文件名称。

az arcdata dc config list

显示特定配置文件的 json。

az arcdata dc config list --config-profile aks-dev-test

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--config-profile -c

默认配置文件：['azure-arc-ake'， 'azure-arc-aks-default-storage'， 'azure-arc-aks-dev-test'， “azure-arc-aks-hci”、“azure-arc-aks-premium-storage”、“azure-arc-azure-openshift”、“azure-arc-eks”、“azure-arc-gke”、“azure-arc-kubeadm”、“azure-arc-kubeadm-dev-test”、“azure-arc-openshift”、“azure-arc-unit-test”。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az arcdata dc config patch

基于 json 修补程序文件修补配置文件。

根据给定的修补程序文件修补配置文件。 请查阅 http://jsonpatch.com/，以便更好地了解路径的撰写方式。 由于 jsonpath 库 https://jsonpath.com/，替换作可以使用其路径中的条件。 所有修补程序 json 文件都必须以具有具有其相应作（添加、替换、删除）、路径和值的修补程序数组的“patch”键开头。 “remove”作不需要值，只需路径。 请参阅以下示例。

az arcdata dc config patch --config-file
                           --patch-file
                           --path

示例

Ex 1 - 将单个终结点（数据控制器终结点）的端口替换为修补程序文件。

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

前 2 - 将数据控制器存储替换为修补程序文件。

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

必需参数

--config-file -c

已放弃

选项“-c”已弃用，将在将来的版本中删除。 请改用“--path”。

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

--patch-file -p

基于 jsonpatch 库的修补 json 文件的路径：http://jsonpatch.com/。 必须使用名为“patch”的密钥启动修补程序 json 文件，其值为要进行的修补程序作数组。 对于修补作的路径，可以使用点表示法，例如 key1.key2，用于大多数作。 如果要执行替换作，并且要替换需要条件的数组中的值，请使用 jsonpath 表示法，方法是将路径开头为 $。 这将允许你执行 $.key1.key2 等条件[？（@.key3==“someValue”].key4。 请参阅以下示例。 有关条件的其他帮助，请参阅：https://jsonpath.com/。

--path

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az arcdata dc config remove

删除配置文件中 json 路径的值。

删除配置文件中 json 路径处的值。 以下所有示例都在 Bash 中提供。 如果使用另一个命令行，则可能需要适当地转义。 或者，可以使用修补程序文件功能。

az arcdata dc config remove --config-file
                            --json-path
                            --path

示例

Ex 1 - 删除数据控制器存储。

az arcdata dc config remove --path custom/control.json --json-path '.spec.storage'

必需参数

--config-file -c

已放弃

选项“-c”已弃用，将在将来的版本中删除。 请改用“-p”。

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

--json-path -j

基于 jsonpatch 库的 json 路径列表，该库指示要删除的值，例如：key1.subkey1，key2.subkey2。 remove 命令不支持条件。 有关路径外观的示例，请参阅 http://jsonpatch.com/。 如果要访问数组，则必须通过指示索引（如 key.0=value）来执行此作。

--path -p

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az arcdata dc config replace

替换配置文件中 json 路径的值。

替换配置文件中 json 路径处的值。 Bash 中提供了所有示例。 如果使用另一个命令行，则可能需要适当地转义。 或者，可以使用修补程序文件功能。

az arcdata dc config replace --config-file
                             --json-values
                             --path

示例

Ex 1 - 替换单个终结点（数据控制器终结点）的端口。

az arcdata dc config replace --path custom/control.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

Ex 2 - 替换数据控制器存储。

az arcdata dc config replace --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

必需参数

--config-file -c

已放弃

选项“-c”已弃用，将在将来的版本中删除。 请改用“-p”。

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

--json-values -j

指向值的 json 路径的键值对列表：key1.subkey1=value1，key2.subkey2=value2。 可以提供内联 json 值，例如：key='{“kind”：“cluster”，“name”：“test-cluster”}'或提供文件路径，如 key=./values.json。 replace 命令通过 jsonpath 库支持条件。 若要使用此选项，请使用 $启动路径。 这将允许你执行条件，如 -j $.key1.key2[？（@.key3==“someValue”].key4=value。 如果提供的内联值本身是键值对本身与“=”和“，”转义这些字符。 例如，key1=“key2=val2，key3=val3”。 你可能会看到以下示例。 有关其他帮助，请参阅：https://jsonpath.com/。

--path -p

要设置的配置的数据控制器配置文件路径，即自定义/control.json。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az arcdata dc config show

返回数据控制器自定义资源的配置。

az arcdata dc config show [--k8s-namespace]
                          [--use-k8s]

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--k8s-namespace -k

数据控制器所在的 Kubernetes 命名空间。

--use-k8s

使用本地 Kubernetes API 来执行此操作。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性	值
默认值:	False