Teilen über


service-principals Befehlsgruppe

Note

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Mit service-principals der Befehlsgruppe in der Databricks CLI können Sie Dienstprinzipale in Ihrem Databricks-Arbeitsbereich verwalten. Siehe Dienstprinzipale für CI/CD.

Databricks-Dienstprinzipale erstellen

Erstellen Sie einen neuen Service Principal im Databricks-Arbeitsbereich.

databricks service-principals create [flags]

Options

--active

    Wenn dieser Benutzer aktiv ist.

--application-id string

    UUID im Zusammenhang mit dem Dienstprinzipal.

--display-name string

    Zeichenfolge, die eine Kombination von Vor- und Familiennamen darstellt.

--external-id string

    Externe ID für das Dienstprinzipal.

--id string

    Databricks-Dienstprinzipal-ID.

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

Globale Kennzeichnungen

Examples

Das folgende Beispiel erstellt ein Dienstprinzipal mit einem Anzeigenamen:

databricks service-principals create --display-name "My Service Principal"

Im folgenden Beispiel wird ein Dienstprinzipal mithilfe von JSON erstellt:

databricks service-principals create --json '{"display_name": "My Service Principal", "active": true}'

Databricks-Dienstprinzipien löschen

Löschen eines einzelnen Dienstprinzipals im Databricks Arbeitsbereich.

databricks service-principals delete ID [flags]

Arguments

ID

    Eindeutige ID für ein Dienstprinzipal im Databricks Arbeitsbereich.

Options

Globale Kennzeichnungen

Examples

Das folgende Beispiel löscht ein Dienstprinzipal nach ID:

databricks service-principals delete 12345

databricks service-principals get

Rufen Sie die Details für einen einzelnen Dienstprinzipal ab, der im Databricks-Arbeitsbereich definiert ist.

databricks service-principals get ID [flags]

Arguments

ID

    Eindeutige ID für ein Dienstprinzipal im Databricks Arbeitsbereich.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden Details für einen Dienstprinzipal angezeigt:

databricks service-principals get 12345

Databricks-Dienstprinzipale auflisten

Listet die Dienstprinzipale auf, die einem Databricks-Arbeitsbereich zugeordnet sind.

databricks service-principals list [flags]

Options

--attributes string

    Durch Trennzeichen getrennte Liste der Attribute, die als Antwort zurückgegeben werden sollen.

--count int

    Gewünschte Anzahl von Ergebnissen pro Seite.

--excluded-attributes string

    Durch Trennzeichen getrennte Liste der Attribute, die als Antwort ausgeschlossen werden sollen.

--filter string

    Abfrage, nach der die Ergebnisse gefiltert werden müssen.

--sort-by string

    Attribut zum Sortieren der Ergebnisse.

--sort-order ListSortOrder

    Die Reihenfolge zum Sortieren der Ergebnisse. Unterstützte Werte: ascending, descending

--start-index int

    Gibt den Index des ersten Ergebnisses an.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden alle Dienstprinzipale aufgelistet:

databricks service-principals list

Im folgenden Beispiel werden Dienstprinzipale mit Filterung aufgelistet:

databricks service-principals list --filter "displayName eq 'My Service Principal'"

Databricks-Dienstprinzipal-Patch

Teilweise Aktualisierung der Details eines einzelnen Dienstprinzipals im Databricks Arbeitsbereich.

databricks service-principals patch ID [flags]

Arguments

ID

    Eindeutige ID im Databricks-Arbeitsbereich.

Options

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

Globale Kennzeichnungen

Examples

Das folgende Beispiel patched ein Dienstprinzipal:

databricks service-principals patch 12345 --json '{"display_name": "Updated Service Principal"}'

Aktualisierung der Databricks-Dienstprinzipale

Aktualisieren Sie die Einzelheiten eines einzelnen Serviceprinzips. Diese Aktion ersetzt das vorhandene Dienstprinzipal mit demselben Namen.

databricks service-principals update ID [flags]

Arguments

ID

    Databricks-Dienstprinzipal-ID.

Options

--active

    Wenn dieser Benutzer aktiv ist.

--application-id string

    UUID im Zusammenhang mit dem Dienstprinzipal.

--display-name string

    Zeichenfolge, die eine Kombination von Vor- und Familiennamen darstellt.

--external-id string

    Externe ID für das Dienstprinzipal.

--id string

    Databricks-Dienstprinzipal-ID.

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

Globale Kennzeichnungen

Examples

Das folgende Beispiel aktualisiert ein Dienstprinzipal:

databricks service-principals update 12345 --display-name "Updated Service Principal" --active

Globale Kennzeichnungen

--debug

  Gibt an, ob die Debugprotokollierung aktiviert werden soll.

-h oder --help

    Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.

--log-file Schnur

    Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.

--log-format Format

    Der Protokollformattyp text oder json. Der Standardwert ist text.

--log-level Schnur

    Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.

-o, --output Typ

    Der Befehlsausgabetyp text oder json. Der Standardwert ist text.

-p, --profile Schnur

    Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben wird, wird, falls vorhanden, das Profil mit dem Namen DEFAULT verwendet.

--progress-format Format

    Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json

-t, --target Schnur

    Falls zutreffend, das zu verwendende Bündelziel