Aller au contenu principal

groupe de commandesaccount service-principals

remarque

L'utilisation de Databricks CLI est soumise à la licence Databricks et à la politique de confidentialité Databricks, y compris toutes les dispositions relatives aux données d'utilisation.

Le groupe de commandes account service-principals dans la CLI Databricks contient des commandes pour effectuer des opérations de création, de récupération, de listage, de mise à jour et de suppression sur les Service Principal. Les Service Principals sont des identités à utiliser avec les Jobs, les outils automatisés et les systèmes tels que les scripts, les applications et les plateformes CI/CD. Databricks recommande de créer des Service Principal pour exécuter des Job de production ou modifier des données de production. See Service Principal.

créer des service-principals de compte Databricks

Créez un nouveau Service Principal dans le compte Databricks.

databricks account service-principals create [flags]

Options

--active

Si ce Service Principal est actif.

--application-id string

UUID du Service Principal.

--display-name string

Chaîne qui représente une concaténation de prénoms et de noms de famille.

--external-id string

ID externe pour le Service Principal.

--id string

ID du Service Principal Databricks.

--json JSON

La chaîne JSON en ligne ou le @path vers le fichier JSON avec le corps de la requête

Indicateurs globaux

Exemples

L'exemple suivant crée un service principal à l'aide d'indicateurs de ligne de commande :

Bash
databricks account service-principals create --application-id "12345678-1234-1234-1234-123456789abc" --display-name "CI/CD Pipeline"

L'exemple suivant crée un Service Principal à l'aide de JSON :

Bash
databricks account service-principals create --json '{"applicationId": "12345678-1234-1234-1234-123456789abc", "displayName": "CI/CD Pipeline", "active": true}'

L'exemple suivant crée un Service Principal à l'aide d'un fichier JSON :

Bash
databricks account service-principals create --json @service-principal.json

databricks account service-principals supprimer

Supprimer un seul Service Principal dans le compte Databricks.

databricks account service-principals delete ID [flags]

Arguments

ID

ID unique pour un service principal dans le compte Databricks.

Options

Indicateurs globaux

Exemples

L'exemple suivant supprime un Service Principal par ID :

Bash
databricks account service-principals delete 12345

databricks account service-principals get

Obtenez les détails d'un Service Principal unique défini dans le compte Databricks.

databricks account service-principals get ID [flags]

Arguments

ID

ID unique pour un service principal dans le compte Databricks.

Options

Indicateurs globaux

Exemples

L'exemple suivant obtient un Service Principal par ID :

Bash
databricks account service-principals get 12345

Liste des Service Principal du compte Databricks

Obtenir l'ensemble des Service Principal associés à un compte Databricks.

databricks account service-principals list [flags]

Options

--attributes string

Liste d'attributs séparés par des virgules à renvoyer en réponse.

--count int

Nombre de résultats souhaité par page.

--excluded-attributes string

Liste d'attributs séparés par des virgules à exclure dans la réponse.

--filter string

Requête par laquelle les résultats doivent être filtrés.

--sort-by string

Attribut pour trier les résultats.

--sort-order ListSortOrder

L'ordre de tri des résultats. Valeurs prises en charge : ascending, descending.

--start-index int

Spécifie l’index du premier résultat.

Indicateurs globaux

Exemples

L’exemple suivant répertorie tous les services principaux :

Bash
databricks account service-principals list

L’exemple suivant répertorie les Service Principal avec pagination :

Bash
databricks account service-principals list --count 10 --start-index 0

L'exemple suivant liste les Service Principal avec un filtre :

Bash
databricks account service-principals list --filter "displayName eq \"CI/CD Pipeline\""

databricks account service-principals patch

Mettez à jour partiellement les détails d'un seul Service Principal dans le compte Databricks.

databricks account service-principals patch ID [flags]

Arguments

ID

ID unique dans le workspace Databricks.

Options

--json JSON

La chaîne JSON en ligne ou le @path vers le fichier JSON avec le corps de la requête

Indicateurs globaux

Exemples

L'exemple suivant corrige un Service Principal à l'aide de JSON :

Bash
databricks account service-principals patch 12345 --json '{"displayName": "Updated CI/CD Pipeline"}'

L'exemple suivant corrige un Service Principal à l'aide d'un fichier JSON :

Bash
databricks account service-principals patch 12345 --json @patch-service-principal.json

databricks account Service Principal update

Mettez à jour les détails d'un seul Service Principal en remplaçant l'intégralité de l'entité du Service Principal.

databricks account service-principals update ID [flags]

Arguments

ID

ID du Service Principal Databricks.

Options

--active

Si ce Service Principal est actif.

--application-id string

UUID du Service Principal.

--display-name string

Chaîne qui représente une concaténation de prénoms et de noms de famille.

--external-id string

ID externe pour le Service Principal.

--id string

ID du Service Principal Databricks.

--json JSON

La chaîne JSON en ligne ou le @path vers le fichier JSON avec le corps de la requête

Indicateurs globaux

Exemples

L'exemple suivant met à jour un service principal à l'aide d'indicateurs de ligne de commande :

Bash
databricks account service-principals update 12345 --display-name "Updated CI/CD Pipeline" --active

L'exemple suivant met à jour un service principal à l'aide de JSON :

Bash
databricks account service-principals update 12345 --json '{"displayName": "Updated CI/CD Pipeline", "active": true}'

L'exemple suivant met à jour un Service Principal à l'aide d'un fichier JSON :

Bash
databricks account service-principals update 12345 --json @update-service-principal.json

Drapeaux globaux

--debug

Activer ou non la journalisation de débogage.

-h ou --help

Afficher l'aide de Databricks CLI ou du groupe de commandes associé ou de la commande associée.

--log-file chaîne

Une chaîne représentant le fichier dans lequel écrire les logs de sortie. Si cet indicateur n'est pas spécifié, la default est d'écrire les logs de sortie dans stderr.

--log-format Format

Le type de format de log, text ou json. La valeur par default est text.

--log-level chaîne

Une chaîne représentant le niveau de format du log. S'il n'est pas spécifié, le niveau de format du log est désactivé.

-o, --output Type

Le type de sortie de commande, text ou json. La valeur par default est text.

-p, --profile chaîne

Nom du profil dans le fichier ~/.databrickscfg à utiliser pour exécuter la commande. Si cet indicateur n'est pas spécifié, alors s'il existe, le profil nommé DEFAULT est utilisé.

--progress-format Format

Le format pour afficher les logs de progression : default, append, inplace ou json

-t, --target chaîne

Le cas échéant, la cible de bundle à utiliser