az arcdata dc config

Note

このリファレンスは、Azure CLI (バージョン 2.3.1 以降) の arcdata 拡張機能の一部です。 拡張機能は、az arcdata dc config コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

構成コマンド。

コマンド

名前	説明	型	Status
az arcdata dc config add	構成ファイル内の json パスの値を追加します。	拡張	GA
az arcdata dc config init	az arcdata dc create で使用できるデータ コントローラーの構成プロファイルを初期化します。	拡張	GA
az arcdata dc config list	使用可能な構成プロファイルの選択肢の一覧を取得します。	拡張	GA
az arcdata dc config patch	json パッチ ファイルに基づいて、構成ファイルにパッチを適用します。	拡張	GA
az arcdata dc config remove	構成ファイル内の json パスの値を削除します。	拡張	GA
az arcdata dc config replace	構成ファイル内の json パスの値を置き換えます。	拡張	GA
az arcdata dc config show	データ コントローラーのカスタム リソースの構成を返します。	拡張	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' を使用してください。

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

--json-values -j

値への json パスのキー値ペア リスト: key1.subkey1=value1,key2.subkey2=value2。 次のようなインライン json 値を指定できます。key='{"kind":"cluster","name":"test-cluster"}' or provide a file path, such as key=./values.json。 add コマンドでは、条件文はサポートされていません。 指定するインライン値が、"=" および "," を使用するキーと値のペア自体である場合は、それらの文字をエスケープします。 たとえば、key1="key2=val2,key3=val3" のようになります。 パスの例については、http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、key.0=value などのインデックスを指定してアクセスする必要があります。

--path -p

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

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

省略可能のパラメーター

--force -f

ターゲット ファイルを強制的に上書きします。

--path -p

構成プロファイルが配置される場所のファイル パス。既定値は /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' を使用してください。

構成プロファイルが配置される場所のファイル パス。既定値は /custom です。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

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

省略可能のパラメーター

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

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc config patch

json パッチ ファイルに基づいて、構成ファイルにパッチを適用します。

指定されたパッチ ファイルに従って、構成ファイルにパッチを適用します。 パスを構成する方法の詳細については、http://jsonpatch.com/ を参照してください。 置き換え操作では、jsonpath ライブラリ https://jsonpath.com/ に従って、そのパス内で条件文を使用できます。 すべての修正プログラム json ファイルは、対応する操作 (add、replace、remove)、パス、および値で構成される修正プログラムの配列を含む "patch" のキーで始まる必要があります。 "remove" 操作には値は必要なく、パスだけが必要です。 次の例を参照してください。

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

例

例 1 - 修正プログラム ファイルを使用して、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' を使用してください。

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

--patch-file -p

jsonpatch ライブラリに基づいた修正プログラム json ファイルへのパス (http://jsonpatch.com/ )。 修正プログラム json ファイルは、実行する修正プログラム適用操作の配列である値を持つ "patch" という名前のキーで始める必要があります。 修正プログラム適用操作のパスの場合は、ドット表記 (ほとんどの操作での key1.key2 など) を使用できます。 置き換え操作を実行するときに、条件文を必要とする配列内の値を置き換えている場合は、パスを $ で始めて jsonpath 表記を使用してください。 これにより、$.key1.key2[?(@.key3=="someValue"].key4. 次の例を参照してください。 条件文に関する追加のヘルプについては、https://jsonpath.com/ を参照してください。

--path

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc config remove

構成ファイル内の json パスの値を削除します。

構成ファイル内の json パスの位置にある値を削除します。 以下の例はすべて Bash で指定されています。 別のコマンド ラインを使用する場合は、エスケープ引用符を適切に使用する必要があります。 あるいは、修正プログラム ファイルの機能を使用することもできます。

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

例

例 1 - データ コントローラー ストレージを削除します。

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

必須のパラメーター

--config-file -c

非推奨

オプション '-c' は非推奨となり、今後のリリースで削除される予定です。 代わりに '-p' を使用してください。

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

--json-path -j

どの値を削除するかを示す jsonpatch ライブラリに基づいた json パスのリスト (key1.subkey1,key2.subkey2 など)。 remove コマンドでは、条件文はサポートされていません。 パスの例については、http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、key.0=value などのインデックスを指定してアクセスする必要があります。

--path -p

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc config replace

構成ファイル内の json パスの値を置き換えます。

構成ファイル内の json パスの位置にある値を置き換えます。 以下の例はすべて Bash で指定されています。 別のコマンド ラインを使用する場合は、エスケープ引用符を適切に使用する必要があります。 あるいは、修正プログラム ファイルの機能を使用することもできます。

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

例

例 1 - 1 つのエンドポイント (データ コントローラー エンドポイント) のポートを置き換えます。

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

例 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' を使用してください。

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

--json-values -j

値への json パスのキー値ペア リスト: key1.subkey1=value1,key2.subkey2=value2。 次のようなインライン json 値を指定できます。key='{"kind":"cluster","name":"test-cluster"}' or provide a file path, such as key=./values.json。 replace コマンドでは、jsonpath ライブラリによる条件文がサポートされています。 これを使用するには、パスを $ で始めます。 これにより、-j $.key1.key2[?(@.key3=="someValue"].key4=value. 指定するインライン値が、"=" および "," を使用するキーと値のペア自体である場合は、それらの文字をエスケープします。 たとえば、key1="key2=val2,key3=val3" のようになります。 以下の例を参照できます。 その他のヘルプについては、次を参照してください https://jsonpath.com/。

--path -p

設定する構成のデータ コントローラー構成ファイル パス (custom/control.json など)。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az arcdata dc config show

データ コントローラーのカスタム リソースの構成を返します。

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

省略可能のパラメーター

--k8s-namespace -k

データ コントローラーが存在している Kubernetes 名前空間。

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告は抑制します。

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。