Compartir a través de


az arcdata dc

Note

Esta referencia forma parte de la extensión arcdata para el CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az arcdata dc . Obtenga más información sobre las extensiones.

Crear, eliminar y administrar controladores de datos.

Comandos

Nombre Description Tipo Estado
az arcdata dc config

Comandos de configuración.

Extension GA
az arcdata dc config add

Agregue un valor para una ruta de acceso json en un archivo de configuración.

Extension GA
az arcdata dc config init

Inicialice un perfil de configuración del controlador de datos que se puede usar con az arcdata dc create.

Extension GA
az arcdata dc config list

Enumera las opciones de perfil de configuración disponibles.

Extension GA
az arcdata dc config patch

Aplique revisiones a un archivo de configuración basado en un archivo de revisión json.

Extension GA
az arcdata dc config remove

Quite un valor de una ruta de acceso json en un archivo de configuración.

Extension GA
az arcdata dc config replace

Reemplace un valor para una ruta de acceso json en un archivo de configuración.

Extension GA
az arcdata dc config show

Devuelve la configuración del recurso personalizado del controlador de datos.

Extension GA
az arcdata dc create

Cree un controlador de datos.

Extension GA
az arcdata dc debug

Depurar el controlador de datos.

Extension GA
az arcdata dc debug controldb-cdc

Habilite o deshabilite CDC en las tablas y la base de datos del controlador de datos, solo con fines de solución de problemas.

Extension GA
az arcdata dc debug copy-logs

Copiar registros.

Extension GA
az arcdata dc debug dump

Desencadene el volcado de memoria.

Extension GA
az arcdata dc debug restore-controldb-snapshot

Restaura una copia única de ControlDB a partir de la copia de seguridad, solo con fines de solución de problemas.

Extension GA
az arcdata dc delete

Elimine el controlador de datos.

Extension GA
az arcdata dc endpoint

Comandos de punto de conexión.

Extension GA
az arcdata dc endpoint list

Enumere el punto de conexión del controlador de datos.

Extension GA
az arcdata dc list

Enumere Azure Arc controladores de datos por grupo de recursos o suscripción.

Extension GA
az arcdata dc list-upgrades

Enumerar las versiones de actualización disponibles.

Extension GA
az arcdata dc status

Comandos de estado.

Extension GA
az arcdata dc status show

Muestra el estado del controlador de datos.

Extension GA
az arcdata dc update

Actualice el controlador de datos.

Extension GA
az arcdata dc upgrade

Actualizar el controlador de datos.

Extension GA

az arcdata dc create

Cree un controlador de datos.

Crear controlador de datos: se requiere kube config en el sistema junto con las credenciales de los paneles de supervisión proporcionados por las siguientes variables de entorno: AZDATA_LOGSUI_USERNAME y AZDATA_LOGSUI_PASSWORD para el panel de registros y AZDATA_METRICSUI_USERNAME y AZDATA_METRICSUI_PASSWORD para el panel de métricas. Como alternativa, AZDATA_USERNAME y AZDATA_PASSWORD se usarán como reserva si faltan conjuntos de variables de entorno. Al usar argumentos de destino de ARM, también se pueden usar las siguientes variables de entorno opcionales: WORKSPACE_ID para Log Analytics id. del área de trabajo y WORKSPACE_SHARED_KEY para la clave principal de Log Analytics.

az arcdata dc create --connectivity-mode
                     --name
                     --resource-group
                     [--acquire-policy-token]
                     [--auto-upload-logs {false, true}]
                     [--auto-upload-metrics {false, true}]
                     [--change-reference]
                     [--cluster-name]
                     [--custom-location]
                     [--image-tag]
                     [--infrastructure]
                     [--k8s-namespace]
                     [--location]
                     [--no-wait]
                     [--path]
                     [--profile-name]
                     [--storage-class]

Ejemplos

Implemente un controlador de datos de Arc a través de Azure Resource Manager (solo modo de conectividad directa).

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

Implemente un controlador de datos de Arc en un clúster de Kubernetes habilitado para Arc determinado a través de ARM (solo en modo de conectividad directa). Este comando implementará la extensión de servicios de datos de Arc y la ubicación personalizada si aún no existen.

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

Parámetros requeridos

--connectivity-mode

La conectividad a Azure directa, en la que el controlador de datos debe funcionar (el modo indirecto ha quedado en desuso).

--name -n

Nombre del controlador de datos.

--resource-group -g

El Azure grupo de recursos en el que se debe agregar el recurso del controlador de datos.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--auto-upload-logs

Habilite los registros de carga automática.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
Valores aceptados: false, true
--auto-upload-metrics

Habilite las métricas de carga automática.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
Valores aceptados: false, true
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--cluster-name

Nombre del clúster de Kubernetes.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--custom-location

Nombre de la ubicación personalizada.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--image-tag

Etiqueta de imagen de servicios de datos de Arc que se va a usar para el controlador de datos.

--infrastructure

La infraestructura en la que se ejecutará el controlador de datos. Valores permitidos: ['aws', 'gcp', 'azure', 'alibaba', 'onpremises', 'other', 'auto'].

--k8s-namespace -k

Espacio de nombres de Kubernetes en el que se va a implementar el controlador de datos. Si ya existe, se usará. Si no existe, primero se intentará crearlo.

--location -l

La Azure ubicación en la que se almacenarán los metadatos del controlador de datos (por ejemplo, eastus).

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--path -p

Ruta de acceso a un directorio que contiene un perfil de configuración personalizado que se va a usar. Ejecute az arcdata dc config init para crear un perfil de configuración personalizado.

--profile-name

Nombre de un perfil de configuración existente. Ejecute az arcdata dc config list para ver las opciones disponibles. Uno de los siguientes: ['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'].

--storage-class

Clase de almacenamiento que se usará para todos los volúmenes persistentes de datos y registros para todos los pods del controlador de datos que los requieran.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc delete

Elimine el controlador de datos.

Eliminar controlador de datos: se requiere kube config en el sistema.

az arcdata dc delete --name
                     [--acquire-policy-token]
                     [--change-reference]
                     [--force]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]
                     [--yes]

Ejemplos

Elimine un controlador de datos a través de la API de Kubernetes.

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

Elimine un controlador de datos a través de Azure Resource Manager (ARM).

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

Parámetros requeridos

--name -n

Nombre del controlador de datos.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--force -f

Forzar la eliminación del controlador de datos y todos sus servicios de datos.

--k8s-namespace -k

Espacio de nombres de Kubernetes en el que existe el controlador de datos.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

El Azure grupo de recursos en el que existe el controlador de datos.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--yes -y

Elimine el controlador de datos sin mensaje de confirmación.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc list

Enumere Azure Arc controladores de datos por grupo de recursos o suscripción.

az arcdata dc list [--resource-group]

Ejemplos

Enumera todos los controladores de datos de Arc del grupo de recursos especificado.

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

Enumera todos los controladores de datos de Arc de la suscripción especificada.

az arcdata dc list --subscription subscriptionId

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

El grupo de recursos Azure que contiene los controladores de datos de Arc.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc list-upgrades

Enumerar las versiones de actualización disponibles.

Intenta enumerar las versiones disponibles en el registro de imágenes de Docker para la actualización. : se requiere kube config en el sistema junto con las siguientes variables de entorno ['AZDATA_USERNAME', 'AZDATA_PASSWORD'].

az arcdata dc list-upgrades --k8s-namespace
                            [--acquire-policy-token]
                            [--change-reference]
                            [--use-k8s]

Ejemplos

Lista de actualización del controlador de datos.

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

Parámetros requeridos

--k8s-namespace -k

Espacio de nombres de Kubernetes en el que existe el controlador de datos.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--use-k8s

Enumere las versiones disponibles del controlador de datos mediante las API locales de Kubernetes.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc update

Actualice el controlador de datos.

Actualiza el datacontroller para habilitar o deshabilitar la carga automática de registros y métricas.

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

Ejemplos

Habilite la carga automática de registros a través de Azure Resource Manager (ARM).

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

Habilite la carga automática de métricas a través de ARM.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--auto-upload-logs

Habilite los registros de carga automática.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
Valores aceptados: false, true
--auto-upload-metrics

Habilite las métricas de carga automática.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
Valores aceptados: false, true
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--desired-version -v

Etiqueta de versión deseada a la que se actualizará el controlador de datos o está vacía para usar la versión válida más reciente.

--k8s-namespace -k

Espacio de nombres de Kubernetes con un controlador de datos implementado.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--maintenance-duration
Vista previa

Duración de la ventana de mantenimiento predeterminada.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--maintenance-enabled
Vista previa

Establezca la marca habilitada en la ventana de mantenimiento predeterminada.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Valores aceptados: false, true
--maintenance-recurrence
Vista previa

Intervalo periódico para la ventana de mantenimiento predeterminada.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--maintenance-start
Vista previa

Fecha y hora del inicio de la primera ventana de mantenimiento predeterminada.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--maintenance-time-zone
Vista previa

Zona horaria usada para calcular la ventana de mantenimiento predeterminada.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--name -n

Nombre del controlador de datos.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

El Azure grupo de recursos en el que existe el controlador de datos.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az arcdata dc upgrade

Actualizar el controlador de datos.

Actualice el controlador de datos a la versión deseada especificada. Si no se especifica desired-version, se realizará un intento de actualizar a la versión más reciente. Si no está seguro de la versión deseada, puede usar el comando list-upgrades para ver las versiones disponibles o usar el argumento --dry-run para mostrar qué versión se usaría.

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

Ejemplos

Actualización del controlador de datos.

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--desired-version -v

Etiqueta de versión deseada a la que se actualizará el controlador de datos o está vacía para usar la versión válida más reciente.

--dry-run -d

Indica qué instancia se actualizaría, pero no actualiza realmente las instancias.

--k8s-namespace -k

Espacio de nombres de Kubernetes en el que existe el controlador de datos.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
--name -n

Nombre del controlador de datos.

--no-wait

Si se da, el comando iniciará la actualización, pero no esperará a que se complete toda la actualización. La actualización continuará en segundo plano.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

El Azure grupo de recursos en el que existe el controlador de datos.

Propiedad Valor
Grupo de parámetros: Azure Resource Manager – targeted Arguments
--target
Obsoleto

La opción "--target" está en desuso y se quitará en una versión futura. Use "--desired-version" en su lugar.

Etiqueta de versión deseada a la que se actualizará el controlador de datos o está vacía para usar la versión válida más reciente.

--use-k8s

Actualice el controlador de datos mediante las API locales de Kubernetes.

Propiedad Valor
Grupo de parámetros: Kubernetes API – targeted Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False