Freigeben über

az arcdata dc config

Note

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 ein az arcdata dc config Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Konfigurationsbefehle.

Befehle

Name Beschreibung Typ Status
az arcdata dc config add

Fügen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei hinzu.

 Extension GA
az arcdata dc config init

Initialisieren Sie ein Konfigurationsprofil für den Datencontroller, das mit az arcdata dc createverwendet werden kann.

 Extension GA
az arcdata dc config list

Auflisten der verfügbaren Konfigurationsprofiloptionen.

 Extension GA
az arcdata dc config patch

Patchen Sie eine Konfigurationsdatei basierend auf einer JSON-Patchdatei.

 Extension GA
az arcdata dc config remove

Entfernen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei.

 Extension GA
az arcdata dc config replace

Ersetzen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei.

 Extension GA
az arcdata dc config show

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

 Extension GA

az arcdata dc config add

Fügen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei hinzu.

Fügen Sie den Wert im JSON-Pfad in der Konfigurationsdatei hinzu. Alle unten aufgeführten Beispiele sind in Bash aufgeführt. Wenn Sie eine andere Befehlszeile verwenden, müssen Sie ggf. Escapequotationen entsprechend ausführen. Alternativ können Sie die Patchdateifunktionalität verwenden.

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

Beispiele

Fügen Sie Datenspeicher hinzu.

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. benutzerdefiniert/control.json.

--json-values -j

Eine Schlüsselwertpaarliste mit JSON-Pfaden zu Werten: key1.subkey1=value1,key2.subkey2=value2. Sie können Inline-JSON-Werte wie: key='{"kind":"cluster","name":"test-cluster"}' bereitstellen oder einen Dateipfad wie key=./values.jsonbereitstellen. Der Befehl zum Hinzufügen unterstützt keine Bedingungen. Wenn es sich bei dem von Ihnen bereitgestellten Inlinewert um ein Schlüsselwertpaar selbst mit "=" und "" handelt, werden diese Zeichen escapezeichen. Beispiel: key1="key2=val2,key3=val3". Beispiele für das Aussehen ihres Pfads finden Sie in 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. benutzerdefiniert/control.json.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc config init

Initialisieren Sie ein Konfigurationsprofil für den Datencontroller, das mit az arcdata dc createverwendet werden kann.

Initialisieren Sie ein Konfigurationsprofil für den Datencontroller, das mit az arcdata dc createverwendet werden kann. Die spezifische Quelle des Konfigurationsprofils kann in den Argumenten angegeben werden.

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

Beispiele

Geführte Datencontroller-Konfigurationserfahrung – Sie erhalten Aufforderungen zu erforderlichen Werten.

az arcdata dc config init

arcdata dc config init with arguments, creates a configuration profile of aks-dev-test in ./custom.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--force -f

Erzwingen des Überschreibens der Zieldatei.

--path -p

Der Dateipfad, in dem das Konfigurationsprofil platziert werden soll, wird standardmäßig auf "cwd/custom" festgelegt.

--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, wird standardmäßig auf "cwd/custom" festgelegt.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc config list

Auflisten der verfügbaren Konfigurationsprofiloptionen.

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

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

Beispiele

Zeigt alle verfügbaren Konfigurationsprofilnamen an.

az arcdata dc config list

Zeigt json eines bestimmten Konfigurationsprofils an.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc config patch

Patchen Sie eine Konfigurationsdatei basierend auf einer JSON-Patchdatei.

Patchen Sie die Konfigurationsdatei entsprechend der angegebenen Patchdatei. Lesen Sie http://jsonpatch.com/, um ein besseres Verständnis darüber zu erhalten, wie die Pfade zusammengesetzt werden sollen. Der Ersetzungsvorgang kann bedingte Bedingungen in seinem Pfad aufgrund der jsonpath-Bibliothek https://jsonpath.com/verwenden. Alle Patch-JSON-Dateien müssen mit einem Schlüssel von "patch" beginnen, der über ein Array von Patches mit ihrer entsprechenden Op (Hinzufügen, Ersetzen, Entfernen), Pfad und Wert verfügt. Der Vorgang "remove" erfordert keinen Wert, nur einen Pfad. Sehen Sie sich die folgenden Beispiele an.

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

Beispiele

Ex 1 – Ersetzen Sie den Port eines einzelnen Endpunkts (Data Controller Endpoint) 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}]}

Ex 2 – Ersetzen Sie den Datenspeicher 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. benutzerdefiniert/control.json.

--patch-file -p

Pfad zu einer Patch-JSON-Datei, die auf der jsonpatch-Bibliothek basiert: http://jsonpatch.com/. Sie müssen ihre Patch-JSON-Datei mit einem Schlüssel namens "patch" starten, dessen Wert ein Array von Patchvorgängen ist, die Sie erstellen möchten. Für den Pfad eines Patchvorgangs können Sie die Punktnotation verwenden, z. B. key1.key2 für die meisten Vorgänge. Wenn Sie einen Ersetzungsvorgang ausführen möchten und einen Wert in einem Array ersetzen, das eine bedingte Bedingung erfordert, verwenden Sie die jsonpath-Notation, indem Sie den Pfad mit einem $-Wert beginnen. Auf diese Weise können Sie eine Bedingung wie $.key1.key2[?( @.key3=="someValue"].key4. Sehen Sie sich die folgenden Beispiele an. Weitere Hilfe zu Bedingungen finden Sie unter: https://jsonpath.com/.

--path

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc config remove

Entfernen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei.

Entfernen Sie den Wert im JSON-Pfad in der Konfigurationsdatei. Alle unten aufgeführten Beispiele sind in Bash aufgeführt. Wenn Sie eine andere Befehlszeile verwenden, müssen Sie ggf. Escapequotationen entsprechend ausführen. Alternativ können Sie die Patchdateifunktionalität verwenden.

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

Beispiele

Ex 1 – Datenverantwortlichenspeicher entfernen.

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. benutzerdefiniert/control.json.

--json-path -j

Eine Liste von JSON-Pfaden basierend auf der jsonpatch-Bibliothek, die angibt, welche Werte Entfernt werden sollen, z. B.: key1.subkey1,key2.subkey2. Der Befehl "Entfernen" unterstützt keine Bedingungen. Beispiele für das Aussehen ihres Pfads finden Sie in 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. benutzerdefiniert/control.json.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az arcdata dc config replace

Ersetzen Sie einen Wert für einen JSON-Pfad in einer Konfigurationsdatei.

Ersetzen Sie den Wert im JSON-Pfad in der Konfigurationsdatei. Alle Beispielebelow werden in Bash gegeben. Wenn Sie eine andere Befehlszeile verwenden, müssen Sie ggf. Escapequotationen entsprechend ausführen. Alternativ können Sie die Patchdateifunktionalität verwenden.

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

Beispiele

Ex 1 – Ersetzen Sie den Port eines einzelnen Endpunkts (Data Controller Endpoint).

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

Ex 2 – Ersetzen sie die Speicherung des Datenverantwortlichen.

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. benutzerdefiniert/control.json.

--json-values -j

Eine Schlüsselwertpaarliste mit JSON-Pfaden zu Werten: key1.subkey1=value1,key2.subkey2=value2. Sie können Inline-JSON-Werte wie: key='{"kind":"cluster","name":"test-cluster"}' bereitstellen oder einen Dateipfad wie key=./values.jsonbereitstellen. Der Befehl "Ersetzen" unterstützt bedingte Elemente über die jsonpath-Bibliothek. Um dies zu verwenden, beginnen Sie Ihren Pfad mit einem $. Auf diese Weise können Sie eine Bedingung wie -j $.key1.key2[?( @.key3=="someValue"].key4=value. Wenn es sich bei dem von Ihnen bereitgestellten Inlinewert um ein Schlüsselwertpaar selbst mit "=" und "" handelt, werden diese Zeichen escapezeichen. Beispiel: key1="key2=val2,key3=val3". Nachfolgend finden Sie beispiele. Weitere Hilfe finden Sie unter: https://jsonpath.com/.

--path -p

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--k8s-namespace -k

Der Kubernetes-Namespace, in dem der Datenverantwortliche vorhanden ist.

--use-k8s

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

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False