az arcdata dc

Note

This reference is part of the arcdata extension for the Azure CLI (version 2.3.1 or higher). The extension will automatically install the first time you run an az arcdata dc command. Learn more about extensions.

Create, delete, and manage data controllers.

Commands

az arcdata dc config

Configuration commands.

az arcdata dc config add

Add a value for a json path in a config file.

az arcdata dc config init

Initialize a data controller configuration profile that can be used with az arcdata dc create.

az arcdata dc config list

List available configuration profile choices.

az arcdata dc config patch

Patch a config file based on a json patch file.

az arcdata dc config remove

Remove a value for a json path in a config file.

az arcdata dc config replace

Replace a value for a json path in a config file.

az arcdata dc config show

Return the config of the data controller custom resource.

az arcdata dc create

Create data controller.

az arcdata dc debug

Debug data controller.

az arcdata dc debug copy-logs

Copy logs.

az arcdata dc debug dump

Trigger memory dump.

az arcdata dc delete

Delete data controller.

az arcdata dc endpoint

Endpoint commands.

az arcdata dc endpoint list

List the data controller endpoint.

az arcdata dc export

Export metrics, logs or usage.

az arcdata dc list-upgrades

List available upgrade versions.

az arcdata dc status

Status commands.

az arcdata dc status show

Show the status of the data controller.

az arcdata dc update

Update data controller.

az arcdata dc upgrade

Upgrade data controller.

az arcdata dc upload

Upload exported data file.

az arcdata dc create

Create data controller.

Create data controller - kube config is required on your system along with credentials for the monitoring dashboards provided by the following environment variables - AZDATA_LOGSUI_USERNAME and AZDATA_LOGSUI_PASSWORD for Logs Dashboard, and AZDATA_METRICSUI_USERNAME and AZDATA_METRICSUI_PASSWORD for Metrics Dashboard. Alternatively AZDATA_USERNAME and AZDATA_PASSWORD will be used as a fallback if either sets of environment variables are missing. When using ARM-targeted arguments, the following optional environment variables are also possible - WORKSPACE_ID for Log Analytics Workspace ID and WORKSPACE_SHARED_KEY for the Log Analytics Primary 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]
                     [--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]

Examples

Deploy an Arc data controller through the Kubernetes API (indirect connectivity mode only).

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

Deploy an Arc data controller through Azure Resource Manager (direct connectivity mode only).

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

Deploy an Arc data controller to a given Arc-enabled Kubernetes cluster through ARM (direct connectivity mode only). This command will deploy the Arc data services extension and custom location if they do not exist already.

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

Required Parameters

--connectivity-mode

The connectivity to Azure - indirect or direct - which the data controller should operate in.

--name -n

The name for the data controller.

--resource-group -g

The Azure resource group in which the data controller resource should be added.

Optional Parameters

--annotations

Comma-separated list of annotations to apply all data controller resources.

--auto-upload-logs

Enable auto upload logs.

accepted values: false, true
--auto-upload-metrics

Enable auto upload metrics.

accepted values: false, true
--cluster-name

Name of the Kubernetes cluster.

--custom-location

The name of the custom location.

--infrastructure

The infrastructure on which the data controller will be running on. Allowed values: ['aws', 'gcp', 'azure', 'alibaba', 'onpremises', 'other', 'auto'].

--k8s-namespace -k

The Kubernetes namespace to deploy the data controller into. If it exists already it will be used. If it does not exist, an attempt will be made to create it first.

--labels

Comma-separated list of labels to apply to all data controller resources.

--location -l

The Azure location in which the data controller metadata will be stored (e.g. eastus).

--logs-ui-private-key-file

Path to the file containing a PEM formatted certificate private key to be used for the Logs UI dashboard endpoint.

--logs-ui-public-key-file

Path to the file containing a PEM formatted certificate to be used for the Logs UI dashboard endpoint.

--metrics-ui-private-key-file

Path to the file containing a PEM formatted certificate private key to be used for the Metrics UI dashboard endpoint.

--metrics-ui-public-key-file

Path to the file containing a PEM formatted certificate to be used for the Metrics UI dashboard endpoint.

--no-wait

Do not wait for the long-running operation to finish.

--path -p

The path to a directory containing a custom configuration profile to use. Run az arcdata dc config init to create a custom configuration profile.

--profile-name

The name of an existing configuration profile. Run az arcdata dc config list to see available options. One of the following: ['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

Comma-separated list of annotations to apply to all external data controller services.

--service-labels

Comma-separated list of labels to apply to all external data controller services.

--storage-annotations

Comma-separated list of annotations to apply to all PVCs created by the data controller.

--storage-class

The storage class to be used for all data and logs persistent volumes for all data controller pods that require them.

--storage-labels

Comma-separated list of labels to apply to all PVCs created by the data controller.

--use-k8s

Create data controller using local Kubernetes APIs.

az arcdata dc delete

Delete data controller.

Delete data controller - kube config is required on your system.

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

Examples

Delete a data controller through the Kubernetes API.

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

Delete a data controller through Azure Resource Manager (ARM).

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

Required Parameters

--name -n

Data controller name.

Optional Parameters

--force -f

Force delete data controller and all of its data services.

--k8s-namespace -k

The Kubernetes namespace in which the data controller exists.

--no-wait

Do not wait for the long-running operation to finish.

--resource-group -g

The Azure resource group in which the data controller exists.

--use-k8s

Use local Kubernetes APIs to perform this action.

--yes -y

Delete data controller without confirmation prompt.

az arcdata dc export

Export metrics, logs or usage.

Export metrics, logs or usage to a file.

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

Required Parameters

--k8s-namespace -k

The Kubernetes namespace in which the data controller exists.

--path -p

The full or relative path including the file name of the file to be exported.

--type -t

The type of data to be exported. Options: logs, metrics, and usage.

Optional Parameters

--force -f

Force create output file. Overwrites any existing file at the same path.

--use-k8s

Use local Kubernetes APIs to perform this action.

az arcdata dc list-upgrades

List available upgrade versions.

Attempts to list versions that are available in the docker image registry for upgrade. - kube config is required on your system along with the following environment variables ['AZDATA_USERNAME', 'AZDATA_PASSWORD'].

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

Examples

Data controller upgrade list.

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

Required Parameters

--k8s-namespace -k

The Kubernetes namespace in which the data controller exists.

Optional Parameters

--use-k8s

List available data controller versions using local Kubernetes APIs.

az arcdata dc update

Update data controller.

Updates the datacontroller to enable/disable auto-uploading logs and metrics.

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]

Examples

Enable auto-uploading of logs through Azure Resource Manager (ARM).

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

Enable auto-uploading of metrics through ARM.

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

Optional Parameters

--auto-upload-logs

Enable auto upload logs.

accepted values: false, true
--auto-upload-metrics

Enable auto upload metrics.

accepted values: false, true
--desired-version -v

The desired version tag to which the data controller will be upgraded, or empty to use the latest valid version.

--k8s-namespace -k

The Kubernetes namespace with a deployed data controller.

--maintenance-duration

Duration of the default maintenance window.

--maintenance-enabled

Set the enabled flag on the default maintenance window.

accepted values: false, true
--maintenance-recurrence

Recurring interval for the default maintenance window.

--maintenance-start

Date time of the start of the first default maintenance window.

--maintenance-time-zone

Timezone used to calculate the default maintenance window.

--name -n

Data controller name.

--no-wait

Do not wait for the long-running operation to finish.

--resource-group -g

The Azure resource group in which the data controller exists.

--use-k8s

Use local Kubernetes APIs to perform this action.

az arcdata dc upgrade

Upgrade data controller.

Upgrade data controller to the desired-version specified. If desired-version is not specified, an attempt to upgrade to the latest version will be made. If you are unsure of the desired version, you may use the list-upgrades command to view available versions, or use the --dry-run argument to show which version would be used.

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

Examples

Data controller upgrade.

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

Optional Parameters

--desired-version -v

The desired version tag to which the data controller will be upgraded, or empty to use the latest valid version.

--dry-run -d

Indicates which instance would be upgraded but does not actually upgrade the instances.

--k8s-namespace -k

The Kubernetes namespace in which the data controller exists.

--name -n

The name of the data controller.

--no-wait

If given, the command will start the upgrade, but will not wait for the entire upgrade to complete. Upgrade will continue in the background.

--resource-group -g

The Azure resource group in which the data controller exists.

--target

The desired version tag to which the data controller will be upgraded, or empty to use the latest valid version.

--use-k8s

Upgrade data controller using local Kubernetes APIs.

az arcdata dc upload

Upload exported data file.

Upload data file exported from a data controller to Azure.

az arcdata dc upload --path

Required Parameters

--path -p

The full or relative path including the file name of the file to be uploaded.