az arcdata dc

Remarque

Cette référence fait partie de l’extension arcdata pour 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 . En savoir plus sur les extensions.

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

Commandes

Nom Description Type Statut
az arcdata dc config

Commandes de configuration.

Extension GA
az arcdata dc config add

Ajoutez une valeur pour un chemin d’accès json dans un fichier de configuration.

Extension GA
az arcdata dc config init

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

Extension GA
az arcdata dc config list

Répertoriez les choix de profils de configuration disponibles.

Extension GA
az arcdata dc config patch

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

Extension GA
az arcdata dc config remove

Supprimez une valeur pour un chemin d’accès json dans un fichier de configuration.

Extension GA
az arcdata dc config replace

Remplacez une valeur pour un chemin d’accès json dans un fichier de configuration.

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éboguez un 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

Copie 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 un contrôleur de données.

Extension GA
az arcdata dc endpoint

Commandes relatives aux points 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 export

Exportez les métriques, les journaux ou l’utilisation.

Extension GA
az arcdata dc list

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

Extension GA
az arcdata dc list-upgrades

Affichez la liste des versions de mise à niveau disponibles.

Extension GA
az arcdata dc status

Commandes relatives à l’é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 un contrôleur de données.

Extension GA
az arcdata dc upgrade

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

Extension GA
az arcdata dc upload

Téléchargez le fichier de données exporté.

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 pour les 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, et AZDATA_METRICSUI_USERNAME et AZDATA_METRICSUI_PASSWORD pour le tableau de bord des métriques. Les variables d’environnement AZDATA_USERNAME et AZDATA_PASSWORD seront utilisées comme solution de secours si des 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 l’ID d’espace de travail Log Analytics et WORKSPACE_SHARED_KEY pour la clé primaire 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]

Exemples

Déployez un contrôleur de données Arc via l’API Kubernetes (mode de connectivité indirecte uniquement).

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

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 (indirecte ou directe) dans laquelle le contrôleur de données doit fonctionner.

--name -n

Nom du contrôleur de données.

--resource-group -g

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

Paramètres facultatifs

--annotations

Liste d’annotations séparées par des virgules à appliquer à toutes les ressources du contrôleur de données.

--auto-upload-logs

Activez les journaux de chargement automatique.

valeurs acceptées: false, true
--auto-upload-metrics

Activez les métriques de chargement automatique.

valeurs acceptées: false, true
--cluster-name

Nom du cluster Kubernetes.

--custom-location

Nom de l’emplacement personnalisé.

--image-tag

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

--infrastructure

L’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, le système tentera d’abord de le créer.

--labels

Liste d’étiquettes séparées par des virgules à appliquer à toutes les ressources du contrôleur de données.

--location -l

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

--logs-ui-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour le point de terminaison du tableau de bord de l’interface utilisateur journaux.

--logs-ui-public-key-file

Chemin d’accès au fichier contenant un certificat au format PEM à utiliser pour le point de terminaison du tableau de bord de l’interface utilisateur des journaux.

--metrics-ui-private-key-file

Chemin d’accès au fichier contenant une clé privée de certificat au format PEM à utiliser pour le point de terminaison du tableau de bord de l’interface utilisateur metrics.

--metrics-ui-public-key-file

Chemin d’accès au fichier contenant un certificat au format PEM à utiliser pour le point de terminaison du tableau de bord de l’interface utilisateur Metrics.

--no-wait

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

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

--service-annotations

Liste d’annotations séparées par des virgules à appliquer à tous les services externes du contrôleur de données.

--service-labels

Liste d’étiquettes séparées par des virgules à appliquer à tous les services externes du contrôleur de données.

--storage-annotations

Liste d’annotations séparées par des virgules à appliquer à toutes les PVC créées par le contrôleur de données.

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

--storage-labels

Liste d’étiquettes séparées par des virgules à appliquer à toutes les PVC créées par le contrôleur de données.

--use-k8s

Créez un contrôleur de données à l’aide d’API Kubernetes locales.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc delete

Supprimez un contrôleur de données.

Supprimez le contrôleur de données. La configuration de Kube est requise sur votre système.

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

--force -f

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

--k8s-namespace -k

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

--no-wait

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

valeur par défaut: False
--resource-group -g

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

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

--yes -y

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc export

Exportez les métriques, les journaux ou l’utilisation.

Exportez les métriques, les journaux ou l’utilisation dans un fichier.

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

Paramètres obligatoires

--k8s-namespace -k

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

--path -p

Chemin d’accès complet ou relatif comprenant le nom du fichier à exporter.

--type -t

Type de données à exporter. Options : journaux, métriques et utilisation.

Paramètres facultatifs

--force -f

Forcez la création du fichier de sortie. Remplace tout fichier existant au même chemin d’accès.

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc list

Répertoriez les contrôleurs de données Azure Arc 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

--resource-group -g

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc list-upgrades

Affichez la liste des versions de mise à niveau disponibles.

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

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

--use-k8s

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc update

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

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

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]

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

--auto-upload-logs

Activez les journaux de chargement automatique.

valeurs acceptées: false, true
--auto-upload-metrics

Activez les métriques de chargement automatique.

valeurs acceptées: false, true
--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é.

--maintenance-duration
Préversion

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

--maintenance-enabled
Préversion

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

valeurs acceptées: false, true
--maintenance-recurrence
Préversion

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

--maintenance-start
Préversion

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

--maintenance-time-zone
Préversion

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

--name -n

Nom du contrôleur de données.

--no-wait

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

valeur par défaut: False
--resource-group -g

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

--use-k8s

Utilisez les API Kubernetes locales pour effectuer cette action.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc upgrade

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

Mettez à niveau le contrôleur de données vers la version souhaitée spécifiée. Si vous ne spécifiez pas la version souhaitée, une tentative de mise à niveau vers la version la plus récente 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 [--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

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

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

valeur par défaut: False
--resource-group -g

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

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

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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

az arcdata dc upload

Téléchargez le fichier de données exporté.

Téléchargez le fichier de données exporté à partir d’un contrôleur de données vers Azure.

az arcdata dc upload --path

Paramètres obligatoires

--path -p

Chemin d’accès complet ou relatif comprenant le nom du fichier à télécharger.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes 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 en utilisant az account set -s NAME_OR_ID.

--verbose

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