az arcdata dc

Note

Cette référence fait partie de l’extension arcdata pour la Azure CLI (version 2.3.1 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az arcdata dc. Apprenez-en davantage sur les extensions.

Créez, supprimez et gérez des contrôleurs de données.

Commandes

Nom Description Type État
az arcdata dc config

Commandes de configuration.

Extension GA
az arcdata dc config add

Ajoutez une valeur pour un chemin json dans un fichier config.

Extension GA
az arcdata dc config init

Initialisez un profil de configuration de contrôleur de données qui peut être utilisé avec az arcdata dc create.

Extension GA
az arcdata dc config list

Répertorier les choix de profil de configuration disponibles.

Extension GA
az arcdata dc config patch

Corrigez un fichier de configuration basé sur un fichier de correctif json.

Extension GA
az arcdata dc config remove

Supprimez une valeur pour un chemin json dans un fichier config.

Extension GA
az arcdata dc config replace

Remplacez une valeur pour un chemin json dans un fichier config.

Extension GA
az arcdata dc config show

Retournez la configuration de la ressource personnalisée du contrôleur de données.

Extension GA
az arcdata dc create

Créez un contrôleur de données.

Extension GA
az arcdata dc debug

Déboguer le contrôleur de données.

Extension GA
az arcdata dc debug controldb-cdc

Activez/désactivez la capture de données modifiées sur la base de données et les tables du contrôleur de données , à des fins de résolution des problèmes uniquement.

Extension GA
az arcdata dc debug copy-logs

Copiez les journaux.

Extension GA
az arcdata dc debug dump

Déclenchez le vidage de la mémoire.

Extension GA
az arcdata dc debug restore-controldb-snapshot

Restaure une copie unique de ControlDB à partir de la sauvegarde , à des fins de résolution des problèmes uniquement.

Extension GA
az arcdata dc delete

Supprimez le contrôleur de données.

Extension GA
az arcdata dc endpoint

Commandes de point de terminaison.

Extension GA
az arcdata dc endpoint list

Répertoriez le point de terminaison du contrôleur de données.

Extension GA
az arcdata dc list

Répertoriez Azure Arc contrôleurs de données par groupe de ressources ou abonnement.

Extension GA
az arcdata dc list-upgrades

Répertorier les versions de mise à niveau disponibles.

Extension GA
az arcdata dc status

Commandes d’état.

Extension GA
az arcdata dc status show

Affichez l’état du contrôleur de données.

Extension GA
az arcdata dc update

Mettez à jour le contrôleur de données.

Extension GA
az arcdata dc upgrade

Mettre à niveau le contrôleur de données.

Extension GA

az arcdata dc create

Créez un contrôleur de données.

Créer un contrôleur de données : la configuration kube est requise sur votre système, ainsi que les informations d’identification des tableaux de bord de surveillance fournis par les variables d’environnement suivantes : AZDATA_LOGSUI_USERNAME et AZDATA_LOGSUI_PASSWORD pour le tableau de bord des journaux d’activité, et AZDATA_METRICSUI_USERNAME et AZDATA_METRICSUI_PASSWORD pour le tableau de bord des métriques. Vous pouvez également AZDATA_USERNAME et AZDATA_PASSWORD sera utilisé comme secours si les deux ensembles de variables d’environnement sont manquants. Lorsque vous utilisez des arguments ciblés par ARM, les variables d’environnement facultatives suivantes sont également possibles : WORKSPACE_ID pour Log Analytics ID d’espace de travail et WORKSPACE_SHARED_KEY pour la clé primaire 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]

Exemples

Déployez un contrôleur de données Arc via Azure Resource Manager (mode de connectivité directe uniquement).

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

Déployez un contrôleur de données Arc sur un cluster Kubernetes avec Arc donné via ARM (mode de connectivité directe uniquement). Cette commande déploie l’extension des services de données Arc et l’emplacement personnalisé s’ils n’existent pas déjà.

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

Paramètres obligatoires

--connectivity-mode

Connectivité à Azure - directe - dans laquelle le contrôleur de données doit fonctionner (le mode indirect a été déconseillé).

--name -n

Nom du contrôleur de données.

--resource-group -g

Groupe de ressources Azure dans lequel la ressource du contrôleur de données doit être ajoutée.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--auto-upload-logs

Activez les journaux de chargement automatique.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
Valeurs acceptées: false, true
--auto-upload-metrics

Activez les métriques de chargement automatique.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
Valeurs acceptées: false, true
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--cluster-name

Nom du cluster Kubernetes.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--custom-location

Nom de l’emplacement personnalisé.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--image-tag

Balise d’image Arc Data Services à utiliser pour le contrôleur de données.

--infrastructure

Infrastructure sur laquelle le contrôleur de données s’exécutera. Valeurs autorisées : ['aws', 'gcp', 'azure', 'alibaba', 'onpremises', 'other', 'auto'].

--k8s-namespace -k

Espace de noms Kubernetes dans lequel déployer le contrôleur de données. S’il existe déjà, il sera utilisé. S’il n’existe pas, une tentative sera effectuée pour la créer en premier.

--location -l

Emplacement Azure dans lequel les métadonnées du contrôleur de données seront stockées (par exemple, eastus).

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--path -p

Chemin d’accès à un répertoire contenant un profil de configuration personnalisé à utiliser. Exécutez az arcdata dc config init pour créer un profil de configuration personnalisé.

--profile-name

Nom d’un profil de configuration existant. Exécutez az arcdata dc config list pour afficher les options disponibles. L’un des éléments suivants : ['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

Classe de stockage à utiliser pour tous les volumes persistants de données et de journaux pour tous les pods de contrôleur de données qui en ont besoin.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az arcdata dc delete

Supprimez le contrôleur de données.

Supprimer le contrôleur de données : la configuration kube est requise sur votre système.

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

Exemples

Supprimez un contrôleur de données via l’API Kubernetes.

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

Supprimez un contrôleur de données via Azure Resource Manager (ARM).

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

Paramètres obligatoires

--name -n

Nom du contrôleur de données.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--force -f

Forcer la suppression du contrôleur de données et tous ses services de données.

--k8s-namespace -k

Espace de noms Kubernetes dans lequel le contrôleur de données existe.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel le contrôleur de données existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--yes -y

Supprimez le contrôleur de données sans invite de confirmation.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az arcdata dc list

Répertoriez Azure Arc contrôleurs de données par groupe de ressources ou abonnement.

az arcdata dc list [--resource-group]

Exemples

Répertorie tous les contrôleurs de données Arc dans le groupe de ressources donné.

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

Répertorie tous les contrôleurs de données Arc dans l’abonnement donné.

az arcdata dc list --subscription subscriptionId

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--resource-group -g

Groupe de ressources Azure contenant le ou les contrôleurs de données Arc.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az arcdata dc list-upgrades

Répertorier les versions de mise à niveau disponibles.

Tente de répertorier les versions disponibles dans le registre d’images Docker pour la mise à niveau. - la configuration kube est requise sur votre système, ainsi que les variables d’environnement suivantes ['AZDATA_USERNAME', 'AZDATA_PASSWORD'].

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

Exemples

Liste de mise à niveau du contrôleur de données.

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

Paramètres obligatoires

--k8s-namespace -k

Espace de noms Kubernetes dans lequel le contrôleur de données existe.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--use-k8s

Répertoriez les versions disponibles du contrôleur de données à l’aide des API Kubernetes locales.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az arcdata dc update

Mettez à jour le contrôleur de données.

Met à jour le datacontroller pour activer/désactiver le chargement automatique des journaux et des métriques.

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]

Exemples

Activer le chargement automatique des journaux via Azure Resource Manager (ARM).

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

Activer le chargement automatique de métriques via ARM.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--auto-upload-logs

Activez les journaux de chargement automatique.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
Valeurs acceptées: false, true
--auto-upload-metrics

Activez les métriques de chargement automatique.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
Valeurs acceptées: false, true
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--desired-version -v

Balise de version souhaitée vers laquelle le contrôleur de données sera mis à niveau ou vide pour utiliser la dernière version valide.

--k8s-namespace -k

Espace de noms Kubernetes avec un contrôleur de données déployé.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--maintenance-duration
Préversion

Durée de la fenêtre de maintenance par défaut.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--maintenance-enabled
Préversion

Définissez l’indicateur activé dans la fenêtre de maintenance par défaut.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Valeurs acceptées: false, true
--maintenance-recurrence
Préversion

Intervalle périodique pour la fenêtre de maintenance par défaut.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--maintenance-start
Préversion

Heure de date du début de la première fenêtre de maintenance par défaut.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--maintenance-time-zone
Préversion

Fuseau horaire utilisé pour calculer la fenêtre de maintenance par défaut.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--name -n

Nom du contrôleur de données.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel le contrôleur de données existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az arcdata dc upgrade

Mettre à niveau le contrôleur de données.

Mettez à niveau le contrôleur de données vers la version souhaitée spécifiée. Si la version souhaitée n’est pas spécifiée, une tentative de mise à niveau vers la dernière version sera effectuée. Si vous n’êtes pas sûr de la version souhaitée, vous pouvez utiliser la commande list-upgrades pour afficher les versions disponibles ou utiliser l’argument --dry-run pour afficher la version qui serait utilisée.

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

Exemples

Mise à niveau du contrôleur de données.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--desired-version -v

Balise de version souhaitée vers laquelle le contrôleur de données sera mis à niveau ou vide pour utiliser la dernière version valide.

--dry-run -d

Indique quelle instance serait mise à niveau, mais ne met pas réellement à niveau les instances.

--k8s-namespace -k

Espace de noms Kubernetes dans lequel le contrôleur de données existe.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
--name -n

Nom du contrôleur de données.

--no-wait

Si elle est donnée, la commande démarre la mise à niveau, mais n’attend pas que l’intégralité de la mise à niveau soit terminée. La mise à niveau se poursuit en arrière-plan.

Propriété Valeur
Valeur par défaut: False
--resource-group -g

Groupe de ressources Azure dans lequel le contrôleur de données existe.

Propriété Valeur
Groupe de paramètres: Azure Resource Manager – targeted Arguments
--target
Déprécié

L’option « --target » a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --desired-version ».

Balise de version souhaitée vers laquelle le contrôleur de données sera mis à niveau ou vide pour utiliser la dernière version valide.

--use-k8s

Mettez à niveau le contrôleur de données à l’aide des API Kubernetes locales.

Propriété Valeur
Groupe de paramètres: Kubernetes API – targeted Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False