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.

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 indirectly connected data controller.

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

Deploy a directly connected data controller.

az arcdata dc create --name name  --connectivity-mode direct --resource-group group  --location location --subscription subscription  --custom-location custom-location

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

[Required] Name of the Kubernetes cluster.

--custom-location

[Required] 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

[Required] The storage class to be use 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

[Required] Create data controller using local Kubernetes APIs.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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 an indirect connected data controller.

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

Delete a directly connected data controller.

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

Required Parameters

--name -n

Data controller name.

Optional Parameters

--force -f

Force delete data controller and all of its data services.

--k8s-namespace -k

[Required] 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 resource should be added.

--use-k8s

Create data controller using local Kubernetes APIs.

--yes -y

Delete data controller without confirmation prompt.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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

Data controller update.

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

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.

--k8s-namespace -k

[Required] 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 maintenance window.

--name -n

Data controller name.

--no-wait

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

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--use-k8s

Create data controller using local Kubernetes APIs.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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

--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 for 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 resource should be added.

--target

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

--use-k8s

Upgrade data controller using local Kubernetes APIs.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.