Share via


az arcdata dc

Nota:

Esta referencia forma parte de la extensión arcdata para la 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.

Crea, elimina y administra controladores de datos.

Comandos

Nombre Description Tipo Estado
az arcdata dc config

Comandos de configuración.

Extensión GA
az arcdata dc config add

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

Extensión GA
az arcdata dc config init

Inicializa un perfil de configuración de controlador de datos que puede usarse con az arcdata dc create.

Extensión GA
az arcdata dc config list

Muestra las opciones de perfil de configuración disponibles.

Extensión GA
az arcdata dc config patch

Aplica una revisión a un archivo de configuración basándose en un archivo de revisión JSON.

Extensión GA
az arcdata dc config remove

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

Extensión GA
az arcdata dc config replace

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

Extensión GA
az arcdata dc config show

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

Extensión GA
az arcdata dc create

Crear un controlador de datos.

Extensión GA
az arcdata dc debug

Depurar controlador de datos.

Extensión 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.

Extensión GA
az arcdata dc debug copy-logs

Copie registros.

Extensión GA
az arcdata dc debug dump

Volcado de memoria del desencadenador.

Extensión 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.

Extensión GA
az arcdata dc delete

Eliminar un controlador de datos.

Extensión GA
az arcdata dc endpoint

Comandos de punto de conexión.

Extensión GA
az arcdata dc endpoint list

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

Extensión GA
az arcdata dc export

Exportar métricas, registros o utilización.

Extensión GA
az arcdata dc list

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

Extensión GA
az arcdata dc list-upgrades

Enumerar las versiones de actualización disponibles.

Extensión GA
az arcdata dc status

Comandos de estado.

Extensión GA
az arcdata dc status show

Muestra el estado del controlador de datos.

Extensión GA
az arcdata dc update

Actualice el controlador de datos.

Extensión GA
az arcdata dc upgrade

Actualizar el controlador de datos.

Extensión GA
az arcdata dc upload

Cargar el archivo de datos exportado.

Extensión GA

az arcdata dc create

Crear un controlador de datos.

Crear el controlador de datos. Se requiere kubeconfig 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 el identificador del área de trabajo de Log Analytics y WORKSPACE_SHARED_KEY para la clave principal de Log Analytics.

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]

Ejemplos

Implemente un controlador de datos de Arc a través de la API de Kubernetes (solo modo de conectividad indirecta).

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

Implemente un controlador de datos de Arc mediante 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 (indirecta o directa), en la que el controlador de datos debe funcionar.

--name -n

El nombre del controlador de datos.

--resource-group -g

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

Parámetros opcionales

--annotations

Lista separada por comas de anotaciones que se aplicarán a todos los recursos del controlador de datos.

--auto-upload-logs

Habilite los registros de carga automática.

valores aceptados: false, true
--auto-upload-metrics

Habilite las métricas de carga automática.

valores aceptados: false, true
--cluster-name

Nombre del clúster de Kubernetes.

--custom-location

Nombre de la ubicación personalizada.

--image-tag

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

--infrastructure

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

--k8s-namespace -k

El espacio de nombres de Kubernetes en el que se va a implementar el controlador de datos. Si ya existe, se usará. Si no existe, en primer lugar se hará un intento para crearlo.

--labels

Lista separada por comas de etiquetas que se aplicarán a todos los recursos del controlador de datos.

--location -l

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

--logs-ui-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para el punto de conexión del panel de la interfaz de usuario de registros.

--logs-ui-public-key-file

Ruta de acceso al archivo que contiene un certificado con formato PEM que se usará para el punto de conexión del panel de la interfaz de usuario de registros.

--metrics-ui-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para el punto de conexión del panel de la interfaz de usuario de métricas.

--metrics-ui-public-key-file

Ruta de acceso al archivo que contiene un certificado con formato PEM que se usará para el punto de conexión del panel de la interfaz de usuario de métricas.

--no-wait

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

valor predeterminado: False
--path -p

La ruta de acceso a un directorio que contiene un perfil de configuración personalizado que se va a usar. Para crear un perfil de configuración personalizado, ejecute az arcdata dc config init.

--profile-name

El nombre de un perfil de configuración existente. Para ver las opciones disponibles, ejecute az arcdata dc config list. 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'].

--service-annotations

Lista separada por comas de anotaciones que se aplicarán a todos los servicios de controlador de datos externos.

--service-labels

Lista separada por comas de etiquetas que se aplicarán a todos los servicios de controlador de datos externos.

--storage-annotations

Lista separada por comas de anotaciones que se aplicarán a todas las PVC creadas por el controlador de datos.

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

--storage-labels

Lista separada por comas de etiquetas que se aplicarán a todas las PVC creadas por el controlador de datos.

--use-k8s

Crear un controlador de datos mediante API locales de Kubernetes.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc delete

Eliminar un controlador de datos.

Elimina el controlador de datos: se requiere kubeconfig en el sistema.

az arcdata dc delete --name
                     [--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

--force -f

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

--k8s-namespace -k

El espacio de nombres de Kubernetes en el que existe el controlador de datos.

--no-wait

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

valor predeterminado: False
--resource-group -g

Grupo de recursos de Azure en el que existe el controlador de datos.

--use-k8s

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

--yes -y

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc export

Exportar métricas, registros o utilización.

Exporta métricas, registros o utilización a un archivo.

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

Parámetros requeridos

--k8s-namespace -k

El espacio de nombres de Kubernetes en el que existe el controlador de datos.

--path -p

La ruta de acceso completa o relativa, incluido el nombre del archivo que se va a exportar.

--type -t

El tipo de datos que se van a exportar. Opciones: registros, métricas y utilización.

Parámetros opcionales

--force -f

Fuerza la creación de un archivo de salida. Sobrescribe cualquier archivo existente en la misma ruta de acceso.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc list

Enumere los controladores de datos de Azure Arc 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

--resource-group -g

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc list-upgrades

Enumerar las versiones de actualización disponibles.

Intenta enumerar las versiones que están disponibles en el registro de imágenes de Docker para su actualización. - Se requiere kubeconfig en el sistema junto con las variables de entorno siguientes: ["AZDATA_USERNAME", "AZDATA_PASSWORD"].

az arcdata dc list-upgrades --k8s-namespace
                            [--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

El espacio de nombres de Kubernetes en el que existe el controlador de datos.

Parámetros opcionales

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc update

Actualice el controlador de datos.

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

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]

Ejemplos

Habilite la carga automática de registros mediante 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

--auto-upload-logs

Habilite los registros de carga automática.

valores aceptados: false, true
--auto-upload-metrics

Habilite las métricas de carga automática.

valores aceptados: false, true
--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.

--maintenance-duration
Vista previa

Duración de la ventana de mantenimiento predeterminada.

--maintenance-enabled
Vista previa

Establezca la marca habilitada en la ventana de mantenimiento predeterminada.

valores aceptados: false, true
--maintenance-recurrence
Vista previa

Intervalo periódico para la ventana de mantenimiento predeterminada.

--maintenance-start
Vista previa

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

--maintenance-time-zone
Vista previa

Zona horaria usada para calcular la ventana de mantenimiento predeterminada.

--name -n

Nombre del controlador de datos.

--no-wait

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

valor predeterminado: False
--resource-group -g

Grupo de recursos de Azure en el que existe el controlador de datos.

--use-k8s

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc upgrade

Actualizar el controlador de datos.

Actualice el controlador de datos a la versión deseada especificada. Si la versión deseada no se ha especificado, se intentará 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 [--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

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

El espacio de nombres de Kubernetes en el que existe el controlador de datos.

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

valor predeterminado: False
--resource-group -g

Grupo de recursos de Azure en el que existe el controlador de datos.

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az arcdata dc upload

Cargar el archivo de datos exportado.

Carga el archivo de datos exportado desde un controlador de datos a Azure.

az arcdata dc upload --path

Parámetros requeridos

--path -p

La ruta de acceso completa o relativa, incluido el nombre del archivo que se va a cargar.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.