az arcdata dc

Note

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

データ コントローラーを作成、削除、管理します。

コマンド

名前	説明	型	Status
az arcdata dc config	構成コマンド。	拡張機能	GA
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 create	データ コントローラーを作成します。	拡張機能	GA
az arcdata dc debug	データ コントローラーをデバッグします。	拡張機能	GA
az arcdata dc debug controldb-cdc	データ コントローラー データベースとテーブルで CDC を有効または無効にする - トラブルシューティングのみを目的としています。	拡張機能	GA
az arcdata dc debug copy-logs	ログをコピーします。	拡張機能	GA
az arcdata dc debug dump	メモリ ダンプをトリガーします。	拡張機能	GA
az arcdata dc debug restore-controldb-snapshot	トラブルシューティングのみを目的として、バックアップから ControlDB の一意のコピーを復元します。	拡張機能	GA
az arcdata dc delete	データ コントローラーを削除します。	拡張機能	GA
az arcdata dc endpoint	エンドポイント コマンド。	拡張機能	GA
az arcdata dc endpoint list	データ コントローラーのエンドポイントを一覧表示します。	拡張機能	GA
az arcdata dc export	メトリック、ログ、使用状況をエクスポートします。	拡張機能	GA
az arcdata dc list	リソース グループまたはサブスクリプション別に Azure Arc データ コントローラーを一覧表示します。	拡張機能	GA
az arcdata dc list-upgrades	使用可能なアップグレード バージョンを一覧表示します。	拡張機能	GA
az arcdata dc status	状態コマンド。	拡張機能	GA
az arcdata dc status show	データ コントローラーの状態を表示します。	拡張機能	GA
az arcdata dc update	データ コントローラーを更新します。	拡張機能	GA
az arcdata dc upgrade	データ コントローラーをアップグレードします。	拡張機能	GA
az arcdata dc upload	エクスポートされたデータ ファイルをアップロードします。	拡張機能	GA

az arcdata dc create

データ コントローラーを作成します。

データ コントローラーを作成します - 次の環境変数によって指定される監視ダッシュボードの資格情報と共に、システムで kube 構成が必要です - ログ ダッシュボード用の AZDATA_LOGSUI_USERNAME と AZDATA_LOGSUI_PASSWORD、およびメトリック ダッシュボード用の AZDATA_METRICSUI_USERNAME と AZDATA_METRICSUI_PASSWORD。 また、いずれかの環境変数のセットが欠落している場合は、フォールバックとして AZDATA_USERNAME と AZDATA_PASSWORD が使用されます。 ARM を対象とする引数を使用する場合は、Log Analytics ワークスペース ID のWORKSPACE_IDと Log Analytics 主キーのWORKSPACE_SHARED_KEYなど、次の省略可能な環境変数も使用できます。

az arcdata dc create --connectivity-mode
                     --name
                     --resource-group
                     [--annotations]
                     [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--cluster-name]
                     [--custom-location]
                     [--image-tag]
                     [--infrastructure]
                     [--k8s-namespace]
                     [--labels]
                     [--location]
                     [--logs-ui-private-key-file]
                     [--logs-ui-public-key-file]
                     [--metrics-ui-private-key-file]
                     [--metrics-ui-public-key-file]
                     [--no-wait]
                     [--path]
                     [--profile-name]
                     [--service-annotations]
                     [--service-labels]
                     [--storage-annotations]
                     [--storage-class]
                     [--storage-labels]
                     [--use-k8s]

例

Kubernetes API を使用して Arc データ コントローラーをデプロイします (間接接続モードのみ)。

az arcdata dc create --name dc-name --k8s-namespace arc --connectivity-mode indirect --resource-group rg-name  --location eastasia --subscription subscription --use-k8s

Azure Resource Manager を使用して Arc データ コントローラーをデプロイします (直接接続モードのみ)。

az arcdata dc create --name dc-name  --connectivity-mode direct --resource-group rg-name --location eastasia --subscription subscription  --custom-location arc-cl

ARM を使用して、特定の Arc 対応 Kubernetes クラスターに Arc データ コントローラーをデプロイします (直接接続モードのみ)。 このコマンドは、Arc データ サービス拡張機能とカスタムの場所がまだ存在しない場合にデプロイします。

az arcdata dc create --name dc-name --subscription subscription --resource-group rg-name  --cluster-name arc-cluster --connectivity-mode direct --custom-location arc-cl

必須のパラメーター

--connectivity-mode

データ コントローラーが動作する Azure への間接的または直接的な接続。

--name -n

データ コントローラーの名前。

--resource-group -g

データ コントローラー リソースを追加する Azure リソース グループ。

省略可能のパラメーター

--annotations

すべてのデータ コントローラー リソースに適用する注釈のコンマ区切りリスト。

--auto-upload-logs

自動アップロード ログを有効にします。

承認された値: false, true

--auto-upload-metrics

自動アップロード メトリックを有効にします。

承認された値: false, true

--cluster-name

Kubernetes クラスターの名前。

--custom-location

カスタムの場所の名前。

--image-tag

データ コントローラーに使用する Arc データ サービスのイメージ タグ。

--infrastructure

データ コントローラーが実行されるインフラストラクチャ。 使用できる値: ['aws'、'gcp'、'azure'、'alibaba'、'onpremises'、'other'、'auto')。

--k8s-namespace -k

データ コントローラーを配置する Kubernetes 名前空間。 既に存在する場合は、それが使用されます。 存在しない場合は、最初に作成が試みられます。

--labels

すべてのデータ コントローラー リソースに適用するラベルのコンマ区切りリスト。

--location -l

データ コントローラーのメタデータを格納する Azure の場所 (例: eastus)。

--logs-ui-private-key-file

ログ UI ダッシュボード エンドポイントに使用する PEM 形式の証明書秘密キーを含むファイルへのパス。

--logs-ui-public-key-file

ログ UI ダッシュボード エンドポイントに使用する PEM 形式の証明書を含むファイルへのパス。

--metrics-ui-private-key-file

メトリック UI ダッシュボード エンドポイントに使用する PEM 形式の証明書秘密キーを含むファイルへのパス。

--metrics-ui-public-key-file

メトリック UI ダッシュボード エンドポイントに使用する PEM 形式の証明書を含むファイルへのパス。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False

--path -p

使用するカスタム構成プロファイルが格納されているディレクトリへのパス。 カスタム構成プロファイルを作成するには、az arcdata dc config init を実行します。

--profile-name

既存の構成プロファイルの名前。 使用できるオプションを表示するには、az arcdata dc config list を実行します。 次のいずれか: ['azure-arc-ake', 'azure-arc-aks-default-storage'、'azure-arc-aks-hci'、'azure-arc-aks-premium-storage'、'azure-arc-azure-openshift'、'azure-arc-eks'、'azure-arc-gke'、'azure-arc-kubeadm'、'azure-arc-openshift'、'azure-arc-unit-test']。

--service-annotations

すべての外部データ コントローラー サービスに適用する注釈のコンマ区切りリスト。

--service-labels

すべての外部データ コントローラー サービスに適用するラベルのコンマ区切りリスト。

--storage-annotations

データ コントローラーによって作成されるすべての PVC に適用する注釈のコンマ区切りリスト。

--storage-class

すべてのデータに使用されるストレージ クラスと、それらを必要とするすべてのデータ コントローラー ポッドの永続ボリュームをログに記録します。

--storage-labels

データ コントローラーによって作成されるすべての PVC に適用するラベルのコンマ区切りリスト。

--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 を使います。

az arcdata dc delete

データ コントローラーを削除します。

データ コントローラーを削除します。Kube 構成がシステムに必要です。

az arcdata dc delete --name
                     [--force]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]
                     [--yes]

例

Kubernetes API を使用してデータ コントローラーを削除します。

az arcdata dc delete --name dc-name --k8s-namespace arc --use-k8s

Azure Resource Manager (ARM) を使用してデータ コントローラーを削除します。

az arcdata dc delete --name dc-name --resource-group rg-name

必須のパラメーター

--name -n

データ コントローラー名。

省略可能のパラメーター

--force -f

データ コントローラーとそのすべてのデータ サービスを強制的に削除します。

--k8s-namespace -k

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

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False

--resource-group -g

データ コントローラーが存在する Azure リソース グループ。

--use-k8s

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

--yes -y

確認プロンプトを表示せずにデータ コントローラーを削除します。

グローバル パラメーター

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

メトリック、ログ、使用状況をエクスポートします。

メトリック、ログ、または使用状況をファイルにエクスポートします。

az arcdata dc export --k8s-namespace
                     --path
                     --type
                     [--force]
                     [--use-k8s]

必須のパラメーター

--k8s-namespace -k

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

--path -p

エクスポート対象のファイルのファイル名を含む完全パスまたは相対パス。

--type -t

エクスポートするデータの種類。 オプション: logs、metrics、usage。

省略可能のパラメーター

--force -f

出力ファイルを強制的に作成します。 同じパスにある既存のファイルを上書きします。

--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 を使います。

az arcdata dc list

リソース グループまたはサブスクリプション別に Azure Arc データ コントローラーを一覧表示します。

az arcdata dc list [--resource-group]

例

特定のリソース グループ内のすべての Arc データ コントローラーを一覧表示します。

az arcdata dc list --resource-group rg-name

指定されたサブスクリプション内のすべての Arc データ コントローラーを一覧表示します。

az arcdata dc list --subscription subscriptionId

省略可能のパラメーター

--resource-group -g

Arc データ コントローラーを含む Azure リソース グループ。

グローバル パラメーター

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

使用可能なアップグレード バージョンを一覧表示します。

Docker イメージ レジストリでアップグレードに使用できるバージョンを一覧表示します。 - 次の環境変数と共にシステムで kube 構成が必要です: ['AZDATA_USERNAME', 'AZDATA_PASSWORD']。

az arcdata dc list-upgrades --k8s-namespace
                            [--use-k8s]

例

データ コントローラーのアップグレードの一覧。

az arcdata dc list-upgrades --k8s-namespace 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 を使います。

az arcdata dc update

データ コントローラーを更新します。

datacontroller を更新して、ログとメトリックの自動アップロードを有効または無効にします。

az arcdata dc update [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--desired-version]
                     [--k8s-namespace]
                     [--maintenance-duration]
                     [--maintenance-enabled {false, true}]
                     [--maintenance-recurrence]
                     [--maintenance-start]
                     [--maintenance-time-zone]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]

例

Azure Resource Manager (ARM) を使用してログの自動アップロードを有効にします。

az arcdata dc update --auto-upload-logs true --name dc-name --resource-group rg-name

ARM を使用してメトリックの自動アップロードを有効にします。

az arcdata dc update --auto-upload-metrics true --name dc-name --resource-group rg-name

省略可能のパラメーター

--auto-upload-logs

自動アップロード ログを有効にします。

承認された値: false, true

--auto-upload-metrics

自動アップロード メトリックを有効にします。

承認された値: false, true

--desired-version -v

データ コントローラーをアップグレードする目的のバージョン タグ。最新の有効なバージョンを使用するには空です。

--k8s-namespace -k

デプロイされたデータ コントローラーを持つ Kubernetes 名前空間。

--maintenance-duration

プレビュー

既定のメインテナント ウィンドウの期間。

--maintenance-enabled

プレビュー

既定の [メインテナント] ウィンドウで有効フラグを設定します。

承認された値: false, true

--maintenance-recurrence

プレビュー

既定のメインテナント ウィンドウの繰り返し間隔。

--maintenance-start

プレビュー

最初の既定のメインテナント ウィンドウの開始日時。

--maintenance-time-zone

プレビュー

既定のメインテナント ウィンドウの計算に使用されるタイムゾーン。

--name -n

データ コントローラー名。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False

--resource-group -g

データ コントローラーが存在する Azure リソース グループ。

--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 を使います。

az arcdata dc upgrade

データ コントローラーをアップグレードします。

指定された目的のバージョンにデータ コントローラーをアップグレードします。 目的のバージョンが指定されていない場合、最新バージョンへのアップグレードが試行されます。 目的のバージョンがわからない場合は、list-upgrades コマンドを使用して使用可能なバージョンを表示するか、--dry-run 引数を使用して使用するバージョンを表示できます。

az arcdata dc upgrade [--desired-version]
                      [--dry-run]
                      [--k8s-namespace]
                      [--name]
                      [--no-wait]
                      [--resource-group]
                      [--target]
                      [--use-k8s]

例

データ コントローラーのアップグレード。

az arcdata dc upgrade --k8s-namespace arc --use-k8s

省略可能のパラメーター

--desired-version -v

データ コントローラーをアップグレードする目的のバージョン タグ。最新の有効なバージョンを使用するには空です。

--dry-run -d

アップグレードするインスタンスを示しますが、実際にはインスタンスをアップグレードしません。

--k8s-namespace -k

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

--name -n

データ コントローラーの名前。

--no-wait

指定した場合、コマンドはアップグレードを開始しますが、アップグレード全体が完了するまで待機しません。 アップグレードはバックグラウンドで続行されます。

既定値: False

--resource-group -g

データ コントローラーが存在する Azure リソース グループ。

--target

非推奨

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

データ コントローラーをアップグレードする目的のバージョン タグ。最新の有効なバージョンを使用するには空です。

--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 を使います。

az arcdata dc upload

エクスポートされたデータ ファイルをアップロードします。

データ コントローラーからエクスポートされたデータ ファイルを Azure にアップロードします。

az arcdata dc upload --path

必須のパラメーター

--path -p

アップロード対象のファイルのファイル名を含む完全パスまたは相対パス。

グローバル パラメーター

--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 を使います。