Share via

az arcdata dc config

  • Referenz

Hinweis

Diese Referenz ist Teil der Arcdata-Erweiterung für die Azure CLI (Version 2.3.1 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az arcdata dc config-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Konfigurationsbefehle

Befehle

Name Beschreibung Typ Status
az arcdata dc config add

Fügt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei hinzu.

 Durchwahl Allgemein verfügbar
az arcdata dc config init

Hiermit wird ein Konfigurationsprofil für einen Datencontroller initialisiert, das für az arcdata dc create verwendet werden kann.

 Durchwahl Allgemein verfügbar
az arcdata dc config list

Listet die verfügbaren Optionen für das Konfigurationsprofil auf

 Durchwahl Allgemein verfügbar
az arcdata dc config patch

Patcht eine Konfigurationsdatei auf Grundlage einer JSON-Patchdatei

 Durchwahl Allgemein verfügbar
az arcdata dc config remove

Entfernt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei.

 Durchwahl Allgemein verfügbar
az arcdata dc config replace

Ersetzt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei.

 Durchwahl Allgemein verfügbar
az arcdata dc config show

Gibt die Konfiguration der benutzerdefinierten Ressource des Datencontrollers zurück.

 Durchwahl Allgemein verfügbar

az arcdata dc config add

Fügt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei hinzu.

Fügt den Wert im JSON-Pfad in der Konfigurationsdatei hinzu Alle nachfolgenden Beispiele sind in Bash angegeben. Wenn Sie eine andere Befehlszeile verwenden, müssen Sie ggf. Escapequotationen entsprechend ausführen. Alternativ können Sie auch die Patchdateifunktionen verwenden.

az arcdata dc config add --config-file
                         --json-values
                         --path

Beispiele

Hinzufügen eines Datencontrollerspeichers

az arcdata dc config add --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Erforderliche Parameter

--config-file -c
Als veraltet markiert

Option "-c" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "-p".

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

--json-values -j

Eine Schlüssel-Wert-Paar-Liste von JSON-Pfaden zu Werten: key1.subkey1=value1,key2.subkey2=value2 Sie können JSON-Inlinewerte angeben, z. B.: key='{"kind":"cluster","name":"test-cluster"}' oder einen Dateipfad, z. B. key=./values.json. Der Befehl „add“ unterstützt KEINE Bedingungen. Wenn der Inlinewert, den Sie bereitstellen, selbst ein Schlüssel-Wert-Paar mit „=“ und „,“ ist, verwenden Sie an den entsprechenden Stellen Escapezeichen. Zum Beispiel key1="key2=val2,key3=val3". Beispiele dazu, wie Ihr Pfad aussehen sollte, finden Sie unter http://jsonpatch.com/. Wenn Sie auf ein Array zugreifen möchten, müssen Sie dies tun, indem Sie den Index angeben, z. B. key.0=value.

--path -p

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc config init

Hiermit wird ein Konfigurationsprofil für einen Datencontroller initialisiert, das für az arcdata dc create verwendet werden kann.

Hiermit wird ein Konfigurationsprofil für einen Datencontroller initialisiert, das für az arcdata dc create verwendet werden kann. Die jeweilige Quelle des Konfigurationsprofils kann in den Argumenten angegeben werden.

az arcdata dc config init [--force]
                          [--path]
                          [--source]
                          [--target]

Beispiele

Angeleitete Ausführung von „config init“: Sie erhalten Aufforderungen für die Eingabe der erforderlichen Werte.

az arcdata dc config init

arcdata dc config init mit Argumenten erstellt ein Konfigurationsprofil von aks-dev-test unter ./custom.

az arcdata dc config init --source azure-arc-kubeadm --path custom

Optionale Parameter

--force -f

Erzwingen der Überschreibung der Zieldatei

--path -p

Der Dateipfad, in dem das Konfigurationsprofil platziert werden soll, ist standardmäßig /custom.

--source -s

Konfigurationsprofilquelle: ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-dev-test', 'azure-arc-aks-hci', 'azure-arc-aks-premium-storage', 'azure-arc-azure-openshift', 'azure-arc-eks', 'azure-arc-gke', 'azure-arc-kubeadm', 'azure-arc-kubeadm-dev-test', 'azure-arc-openshift', 'azure-arc-unit-test'].

--target -t
Als veraltet markiert

Option "-t" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "-p".

Der Dateipfad, in dem das Konfigurationsprofil platziert werden soll, ist standardmäßig /custom.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc config list

Listet die verfügbaren Optionen für das Konfigurationsprofil auf

Auflisten der verfügbaren Konfigurationsprofiloptionen für die Verwendung in arcdata dc config init.

az arcdata dc config list [--config-profile]

Beispiele

Listet alle verfügbaren Namen für das Konfigurationsprofil auf.

az arcdata dc config list

Zeigt JSON eines bestimmten Konfigurationsprofils an.

az arcdata dc config list --config-profile aks-dev-test

Optionale Parameter

--config-profile -c

Standardkonfigurationsprofil: ['azure-arc-ake', 'azure-arc-aks-default-storage', 'azure-arc-aks-dev-test', 'azure-arc-aks-hci', 'azure-arc-aks-premium-storage', 'azure-arc-azure-openshift', 'azure-arc-eks', 'azure-arc-gke', 'azure-arc-kubeadm', 'azure-arc-kubeadm-dev-test', 'azure-arc-openshift', 'azure-arc-unit-test'].

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc config patch

Patcht eine Konfigurationsdatei auf Grundlage einer JSON-Patchdatei

Patcht die Konfigurationsdatei entsprechend der angegebenen Patchdatei Informationen zum besseren Verständnis der Zusammensetzung der Pfade finden Sie unter http://jsonpatch.com/. Der Vorgang „Ersetzen“ kann Bedingungen im Pfad aufgrund der JSONPATH-Bibliothek verwenden (https://jsonpath.com/ ). Alle JSON-Patchdateien müssen mit einem „Patch“-Schlüssel beginnen, der über ein Array von Patches mit dem entsprechenden Vorgang (Hinzufügen, Ersetzen, Entfernen), Pfad und Wert verfügt. Der Vorgang „Entfernen“ erfordert keinen Wert, sondern nur einen Pfad. Beispiele hierzu finden Sie weiter unten.

az arcdata dc config patch --config-file
                           --patch-file
                           --path

Beispiele

Beispiel 1: Ersetzen des Ports eines einzelnen Endpunkts (Datencontroller-Endpunkt) durch Patchdatei.

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

Beispiel 2: Ersetzen des Datencontrollerspeichers durch Patchdatei.

az arcdata dc config patch --path custom/control.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

Erforderliche Parameter

--config-file -c
Als veraltet markiert

Option "-c" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "--path".

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

--patch-file -p

Pfad zu einer JSON-Patchdatei, die auf der JSONPATCH-Bibliothek basiert: http://jsonpatch.com/ Sie müssen die JSON-Patchdatei mit einem Schlüssel mit der Bezeichnung „Patch“ starten, bei dessen Wert es sich um ein Array von Patchvorgängen handelt, die Sie ausführen möchten. Für den Pfad eines Patchvorgangs können Sie für die meisten Vorgänge die Punktnotation verwenden, z. B. „key1.key2“. Wenn Sie einen „Ersetzen“-Vorgang durchführen möchten und einen Wert in einem Array ersetzen, das eine Bedingung erfordert, verwenden Sie die JSONPATH-Notation, indem Sie den Pfad mit einem Dollarzeichen („$“) beginnen. Auf diese Weise können Sie eine Bedingung wie $.key1.key2[?( @.key3=="someValue"].key4. Beispiele hierzu finden Sie weiter unten. Zusätzliche Hilfe zu Bedingungen finden Sie unter https://jsonpath.com/.

--path

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc config remove

Entfernt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei.

Entfernt den Wert im JSON-Pfad in der Konfigurationsdatei. Alle nachfolgenden Beispiele sind in Bash angegeben. Wenn Sie eine andere Befehlszeile verwenden, müssen Sie ggf. Escapequotationen entsprechend ausführen. Alternativ können Sie auch die Patchdateifunktionen verwenden.

az arcdata dc config remove --config-file
                            --json-path
                            --path

Beispiele

Beispiel 1: Entfernen des Datencontrollerspeichers.

az arcdata dc config remove --path custom/control.json --json-path '.spec.storage'

Erforderliche Parameter

--config-file -c
Als veraltet markiert

Option "-c" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "-p".

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

--json-path -j

Eine Liste von JSON-Pfaden, die auf der JSONPATCH-Bibliothek basiert und angibt, welche Werte entfernt werden sollen, z. B.: key1.subkey1,key2.subkey2. Der Befehl „remove“ unterstützt KEINE Bedingungen. Beispiele dazu, wie Ihr Pfad aussehen sollte, finden Sie unter http://jsonpatch.com/. Wenn Sie auf ein Array zugreifen möchten, müssen Sie dies tun, indem Sie den Index angeben, z. B. key.0=value.

--path -p

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc config replace

Ersetzt einen Wert in einem JSON-Pfad in einer Konfigurationsdatei.

Ersetzt den Wert im JSON-Pfad in der Konfigurationsdatei. Alle nachfolgenden Beispiele sind in Bash angegeben. Wenn Sie eine andere Befehlszeile verwenden, müssen Sie ggf. Escapequotationen entsprechend ausführen. Alternativ können Sie auch die Patchdateifunktionen verwenden.

az arcdata dc config replace --config-file
                             --json-values
                             --path

Beispiele

Beispiel 1: Ersetzen des Ports eines einzelnen Endpunkts (Datencontroller-Endpunkt).

az arcdata dc config replace --path custom/control.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

Beispiel 2: Ersetzen des Datencontrollerspeichers.

az arcdata dc config replace --path custom/control.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Erforderliche Parameter

--config-file -c
Als veraltet markiert

Option "-c" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "-p".

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

--json-values -j

Eine Schlüssel-Wert-Paar-Liste von JSON-Pfaden zu Werten: key1.subkey1=value1,key2.subkey2=value2 Sie können JSON-Inlinewerte angeben, z. B.: key='{"kind":"cluster","name":"test-cluster"}' oder einen Dateipfad, z. B. key=./values.json. Der Befehl „replace“ unterstützt Bedingungen über die JSONPATH-Bibliothek. Um diesen Parameter zu verwenden, starten Sie den Pfad mit „$“. Auf diese Weise können Sie eine Bedingung wie -j $.key1.key2[?( @.key3=="someValue"].key4=value. Wenn der Inlinewert, den Sie bereitstellen, selbst ein Schlüssel-Wert-Paar mit „=“ und „,“ ist, verwenden Sie an den entsprechenden Stellen Escapezeichen. Zum Beispiel key1="key2=val2,key3=val3". Nachfolgend sehen Sie hierzu Beispiele. Weitere Hilfe finden Sie unter: https://jsonpath.com/.

--path -p

Dateipfad der Konfigurationsdatei des Datencontrollers, die Sie festlegen möchten, z. B. custom/control.json.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az arcdata dc config show

Gibt die Konfiguration der benutzerdefinierten Ressource des Datencontrollers zurück.

az arcdata dc config show [--k8s-namespace]
                          [--use-k8s]

Optionale Parameter

--k8s-namespace -k

Der Kubernetes-Namespace, in dem der Datencontroller vorhanden ist

--use-k8s

Verwenden Sie lokale Kubernetes-APIs, um diese Aktion auszuführen.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.