Partager via


service-principals groupe de commande

Note

Ces informations s’appliquent à Databricks CLI versions 0.205 et ultérieures. L’interface CLI Databricks est en préversion publique.

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le service-principals groupe de commandes au sein de l’interface CLI Databricks vous permet de gérer les principaux de service dans votre espace de travail Databricks. Consultez Principaux de service pour CI/CD.

databricks service-principals create

Créez un principal de service dans l’espace de travail Databricks.

databricks service-principals create [flags]

Options

--active

    Si cet utilisateur est actif.

--application-id string

    UUID relatif au principal de service.

--display-name string

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

--external-id string

    Identifiant externe du principal de service.

--id string

    ID du principal de service Databricks.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant crée un principal de service avec un nom d'affichage :

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

L’exemple suivant crée un principal de service à l’aide de JSON :

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

databricks service-principals delete (commande de suppression dans Databricks)

Supprimez un principal de service unique dans l’espace de travail Databricks.

databricks service-principals delete ID [flags]

Arguments

ID

    ID unique d’un principal de service dans l’espace de travail Databricks.

Options

Indicateurs globaux

Examples

L’exemple suivant supprime un principal de service via ID :

databricks service-principals delete 12345

databricks service-principals get

Obtenez les détails d’un principal de service unique défini dans l’espace de travail Databricks.

databricks service-principals get ID [flags]

Arguments

ID

    ID unique d’un principal de service dans l’espace de travail Databricks.

Options

Indicateurs globaux

Examples

L’exemple suivant obtient des détails pour un service principal :

databricks service-principals get 12345

databricks service-principals list

Répertoriez l’ensemble de principaux de service associés à un espace de travail Databricks.

databricks service-principals list [flags]

Options

--attributes string

    Liste séparée par des virgules d’attributs à retourner en réponse.

--count int

    Nombre souhaité de résultats par page.

--excluded-attributes string

    Liste séparée par des virgules d’attributs à exclure en réponse.

--filter string

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

--sort-by string

    Attribut pour trier les résultats.

--sort-order ListSortOrder

    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

Examples

L’exemple suivant liste tous les principaux de service :

databricks service-principals list

L’exemple suivant répertorie les principaux de service avec filtrage :

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

correctif des principes de service Databricks

Mettez partiellement à jour les détails d’un principal de service unique dans l’espace de travail Databricks.

databricks service-principals patch ID [flags]

Arguments

ID

    ID unique dans l’espace de travail Databricks.

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant corrige un principal de service :

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

mise à jour des principaux de service databricks

Mettez à jour les détails d’un service principal. Cette action remplace le principal de service existant portant le même nom.

databricks service-principals update ID [flags]

Arguments

ID

    ID du principal de service Databricks.

Options

--active

    Si cet utilisateur est actif.

--application-id string

    UUID relatif au principal de service.

--display-name string

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

--external-id string

    Identifiant externe du principal de service.

--id string

    ID du principal de service Databricks.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

L’exemple suivant met à jour un principal de service :

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

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

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

--progress-format format

    Format d’affichage des journaux d’activité de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser