Share via

az arcdata dc

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione arcdata per l'interfaccia della riga di comando di Azure (versione 2.3.1 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az arcdata dc . Altre informazioni sulle estensioni.

Creare, eliminare e gestire i controller dati.

Comandi

Nome Descrizione Tipo Stato
az arcdata dc config

Comandi di configurazione.

 Estensione Disponibilità generale
az arcdata dc config add

Aggiunge un valore per un percorso JSON in un file di configurazione.

 Estensione Disponibilità generale
az arcdata dc config init

Inizializzare un profilo di configurazione del controller dati che può essere usato con az arcdata dc create.

 Estensione Disponibilità generale
az arcdata dc config list

Elencare le opzioni del profilo di configurazione disponibili.

 Estensione Disponibilità generale
az arcdata dc config patch

Applicare patch a un file di configurazione basato su un file di patch JSON.

 Estensione Disponibilità generale
az arcdata dc config remove

Rimuove un valore per un percorso JSON in un file di configurazione.

 Estensione Disponibilità generale
az arcdata dc config replace

Sostituisce un valore per un percorso JSON in un file di configurazione.

 Estensione Disponibilità generale
az arcdata dc config show

Restituisce la configurazione della risorsa personalizzata del controller dati.

 Estensione Disponibilità generale
az arcdata dc create

Creare un controller dei dati.

 Estensione Disponibilità generale
az arcdata dc debug

Eseguire il debug del controller dati.

 Estensione Disponibilità generale
az arcdata dc debug controldb-cdc

Abilitare/disabilitare CDC nel database e nelle tabelle del controller di dati: solo a scopo di risoluzione dei problemi.

 Estensione Disponibilità generale
az arcdata dc debug copy-logs

Copia i log.

 Estensione Disponibilità generale
az arcdata dc debug dump

Attiva il dump della memoria.

 Estensione Disponibilità generale
az arcdata dc debug restore-controldb-snapshot

Ripristina una copia univoca di ControlDB dal backup, solo a scopo di risoluzione dei problemi.

 Estensione Disponibilità generale
az arcdata dc delete

Eliminare un controller dei dati.

 Estensione Disponibilità generale
az arcdata dc endpoint

Comandi dell'endpoint.

 Estensione Disponibilità generale
az arcdata dc endpoint list

Visualizzare l'endpoint del controller dati.

 Estensione Disponibilità generale
az arcdata dc export

Esportare metriche, log o utilizzo.

 Estensione Disponibilità generale
az arcdata dc list

Elencare i controller dati di Azure Arc per gruppo di risorse o sottoscrizione.

 Estensione Disponibilità generale
az arcdata dc list-upgrades

Elencare le versioni di aggiornamento disponibili.

 Estensione Disponibilità generale
az arcdata dc status

Comandi di stato.

 Estensione Disponibilità generale
az arcdata dc status show

Mostra lo stato del titolare del trattamento dei dati.

 Estensione Disponibilità generale
az arcdata dc update

Aggiornare il titolare del trattamento dei dati.

 Estensione Disponibilità generale
az arcdata dc upgrade

Aggiornare il titolare del trattamento dei dati.

 Estensione Disponibilità generale
az arcdata dc upload

Caricare il file di dati esportato.

 Estensione Disponibilità generale

az arcdata dc create

Creare un controller dei dati.

Creare il controller di dati: la configurazione kube è necessaria nel sistema insieme alle credenziali per i dashboard di monitoraggio forniti dalle variabili di ambiente seguenti: AZDATA_LOGSUI_Uedizione Standard RNAME e AZDATA_LOGSUI_PASSWORD per il dashboard dei log e AZDATA_METRICSUI_Uedizione Standard RNAME e AZDATA_METRICSUI_PASSWORD per dashboard delle metriche. In alternativa, AZDATA_Uedizione Standard RNAME e AZDATA_PASSWORD verranno usati come fallback se manca uno dei set di variabili di ambiente. Quando si usano argomenti di destinazione arm, sono anche possibili le variabili di ambiente facoltative seguenti: WORKSPACE_ID per l'ID dell'area di lavoro Log Analytics e WORKSPACE_SHARED_KEY per la chiave primaria di 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]

Esempio

Distribuire un controller dati Arc tramite l'API Kubernetes (solo modalità di connettività indiretta).

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

Distribuire un controller dati Arc tramite Azure Resource Manager (solo modalità di connettività diretta).

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

Distribuire un controller dati Arc in un determinato cluster Kubernetes abilitato per Arc tramite ARM (solo modalità di connettività diretta). Questo comando distribuirà l'estensione dei servizi dati Arc e il percorso personalizzato, se non esistono già.

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

Parametri necessari

--connectivity-mode

Connettività ad Azure, indiretta o diretta, in cui verrà usato il controller dati.

--name -n

Nome del controller dati.

--resource-group -g

Gruppo di risorse di Azure in cui deve essere aggiunta la risorsa del controller dati.

Parametri facoltativi

--annotations

Elenco delimitato da virgole di annotazioni per applicare tutte le risorse del controller dati.

--auto-upload-logs

Abilitare i log di caricamento automatico.

valori accettati: false, true
--auto-upload-metrics

Abilitare le metriche di caricamento automatico.

valori accettati: false, true
--cluster-name

Nome del cluster Kubernetes.

--custom-location

Nome della posizione personalizzata.

--image-tag

Tag immagine di Arc Data Services da usare per il titolare del trattamento dei dati.

--infrastructure

Infrastruttura in cui verrà eseguito il titolare del trattamento dei dati. Valori consentiti: ['aws', 'gcp', 'azure', 'alibaba', 'onpremises', 'other', 'auto'].

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui distribuire il controller dati. Se è già presente, verrà usato quello esistente. Se non è presente, verrà prima effettuato un tentativo di crearlo.

--labels

Elenco delimitato da virgole di etichette da applicare a tutte le risorse del controller dati.

--location -l

Posizione di Azure in cui verranno archiviati i metadati del controller dati, ad esempio eastus.

--logs-ui-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per l'endpoint del dashboard dell'interfaccia utente dei log.

--logs-ui-public-key-file

Percorso del file contenente un certificato con formattazione PEM da usare per l'endpoint del dashboard dell'interfaccia utente dei log.

--metrics-ui-private-key-file

Percorso del file contenente una chiave privata del certificato con formattazione PEM da usare per l'endpoint del dashboard dell'interfaccia utente delle metriche.

--metrics-ui-public-key-file

Percorso del file contenente un certificato con formattazione PEM da usare per l'endpoint del dashboard dell'interfaccia utente delle metriche.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--path -p

Percorso di una directory contenente un profilo di configurazione personalizzato da usare. Eseguire az arcdata dc config init per creare un profilo di configurazione personalizzato.

--profile-name

Nome di un profilo di configurazione esistente. Eseguire az arcdata dc config list per visualizzare le opzioni disponibili. Uno dei seguenti: ['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

Elenco delimitato da virgole di annotazioni da applicare a tutti i servizi del titolare del trattamento dei dati esterni.

--service-labels

Elenco delimitato da virgole di etichette da applicare a tutti i servizi del titolare del trattamento dei dati esterni.

--storage-annotations

Elenco delimitato da virgole di annotazioni da applicare a tutti i pvC creati dal titolare del trattamento dei dati.

--storage-class

Classe di archiviazione da usare per tutti i volumi permanenti di dati e log per tutti i pod del controller dati che li richiedono.

--storage-labels

Elenco delimitato da virgole di etichette da applicare a tutti i controller di rete virtuali creati dal titolare del trattamento dei dati.

--use-k8s

Creare un controller di dati usando le API Kubernetes locali.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc delete

Eliminare un controller dei dati.

Eliminare il controller dati. È necessaria la configurazione kube nel sistema in uso.

az arcdata dc delete --name
                     [--force]
                     [--k8s-namespace]
                     [--no-wait]
                     [--resource-group]
                     [--use-k8s]
                     [--yes]

Esempio

Eliminare un controller di dati tramite l'API Kubernetes.

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

Eliminare un controller dati tramite Azure Resource Manager (ARM).

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

Parametri necessari

--name -n

Nome del controller dati.

Parametri facoltativi

--force -f

Forzare l'eliminazione del titolare del trattamento dei dati e tutti i relativi servizi dati.

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui è presente il controller dati.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--resource-group -g

Gruppo di risorse di Azure in cui è presente il titolare del trattamento dei dati.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

--yes -y

Eliminare il titolare del trattamento dei dati senza richiesta di conferma.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc export

Esportare metriche, log o utilizzo.

Esportare metriche, log o utilizzo in un file.

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

Parametri necessari

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui è presente il controller dati.

--path -p

Percorso completo o relativo che include il nome file del file da esportare.

--type -t

Tipo di dati da esportare. Opzioni: log, metriche e utilizzo.

Parametri facoltativi

--force -f

Forzare la creazione del file di output. Sovrascrive qualsiasi file esistente nello stesso percorso.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc list

Elencare i controller dati di Azure Arc per gruppo di risorse o sottoscrizione.

az arcdata dc list [--resource-group]

Esempio

Elenca tutti i titolari dei dati Arc nel gruppo di risorse specificato.

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

Elenca tutti i titolari del trattamento dei dati Arc nella sottoscrizione specificata.

az arcdata dc list --subscription subscriptionId

Parametri facoltativi

--resource-group -g

Gruppo di risorse di Azure contenente i controller di dati Arc.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc list-upgrades

Elencare le versioni di aggiornamento disponibili.

Tenta di elencare le versioni disponibili nel Registro immagini Docker per l'aggiornamento. - la configurazione kube è necessaria nel sistema insieme alle variabili di ambiente seguenti ['AZDATA_Uedizione Standard RNAME', 'AZDATA_PASSWORD'].

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

Esempio

Elenco di aggiornamento del controller dati.

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

Parametri necessari

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui è presente il controller dati.

Parametri facoltativi

--use-k8s

Elencare le versioni disponibili del controller dati usando le API Kubernetes locali.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc update

Aggiornare il titolare del trattamento dei dati.

Aggiornamenti datacontroller per abilitare/disabilitare il caricamento automatico di log e metriche.

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]

Esempio

Abilitare il caricamento automatico dei log tramite Azure Resource Manager (ARM).

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

Abilitare il caricamento automatico delle metriche tramite ARM.

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

Parametri facoltativi

--auto-upload-logs

Abilitare i log di caricamento automatico.

valori accettati: false, true
--auto-upload-metrics

Abilitare le metriche di caricamento automatico.

valori accettati: false, true
--desired-version -v

Tag di versione desiderato a cui verrà aggiornato il controller dati o vuoto per usare la versione valida più recente.

--k8s-namespace -k

Spazio dei nomi Kubernetes con un controller dati distribuito.

--maintenance-duration
Anteprima

Durata della finestra di manutenzione predefinita.

--maintenance-enabled
Anteprima

Impostare il flag abilitato nella finestra di manutenzione predefinita.

valori accettati: false, true
--maintenance-recurrence
Anteprima

Intervallo ricorrente per la finestra di manutenzione predefinita.

--maintenance-start
Anteprima

Data dell'inizio della prima finestra di manutenzione predefinita.

--maintenance-time-zone
Anteprima

Fuso orario usato per calcolare la finestra di manutenzione predefinita.

--name -n

Nome del controller dati.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

valore predefinito: False
--resource-group -g

Gruppo di risorse di Azure in cui è presente il titolare del trattamento dei dati.

--use-k8s

Usare le API Kubernetes locali per eseguire questa azione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc upgrade

Aggiornare il titolare del trattamento dei dati.

Aggiornare il controller dati alla versione desiderata specificata. Se la versione desiderata non è specificata, verrà eseguito un tentativo di aggiornamento alla versione più recente. Se non si è certi della versione desiderata, è possibile usare il comando list-upgrades per visualizzare le versioni disponibili oppure usare l'argomento --dry-run per mostrare quale versione verrà usata.

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

Esempio

Aggiornamento del titolare del trattamento dei dati.

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

Parametri facoltativi

--desired-version -v

Tag di versione desiderato a cui verrà aggiornato il controller dati o vuoto per usare la versione valida più recente.

--dry-run -d

Indica quale istanza verrà aggiornata ma non aggiorna effettivamente le istanze.

--k8s-namespace -k

Spazio dei nomi Kubernetes in cui è presente il controller dati.

--name -n

Nome del titolare del trattamento dei dati.

--no-wait

Se specificato, il comando avvierà l'aggiornamento, ma non attenderà il completamento dell'intero aggiornamento. L'aggiornamento continuerà in background.

valore predefinito: False
--resource-group -g

Gruppo di risorse di Azure in cui è presente il titolare del trattamento dei dati.

--target
Deprecato

L'opzione '-target' è stata deprecata e verrà rimossa in una versione futura. Usare invece '--desired-version'.

Tag di versione desiderato a cui verrà aggiornato il controller dati o vuoto per usare la versione valida più recente.

--use-k8s

Aggiornare il controller dati usando le API Kubernetes locali.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az arcdata dc upload

Caricare il file di dati esportato.

Caricare il file di dati esportato da un controller dati in Azure.

az arcdata dc upload --path

Parametri necessari

--path -p

Percorso completo o relativo che include il nome file del file da caricare.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.