Partilhar via


service-principals grupo de comando

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-Visualização Pública.

O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.

O service-principals grupo de comandos dentro da CLI Databricks permite-lhe gerir os principais de serviço no seu espaço de trabalho Databricks. Consulte Entidades de serviço para CI/CD.

Databricks Service-Principals criar

Crie um novo service principal no espaço de trabalho Databricks.

databricks service-principals create [flags]

Opções

--active

    Se este usuário estiver ativo.

--application-id string

    UUID relativo ao principal de serviço.

--display-name string

    String que representa uma concatenação de nomes próprios e nomes de família.

--external-id string

    ID externa do principal de serviço.

--id string

    ID da entidade de serviço Databricks.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Examples

O exemplo a seguir cria um principal de serviço com um nome a mostrar:

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

O exemplo a seguir cria uma entidade de serviço usando JSON:

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

Databricks Service-Principals Excluir

Exclua uma única entidade de serviço no espaço de trabalho Databricks.

databricks service-principals delete ID [flags]

Arguments

ID

    ID única para um principal de serviço no espaço de trabalho Databricks.

Opções

Bandeiras globais

Examples

O exemplo a seguir elimina um principal de serviço por ID:

databricks service-principals delete 12345

Os Diretores de Serviço Databricks obtêm

Obtenha os detalhes de um único principal de serviço definido no espaço de trabalho Databricks.

databricks service-principals get ID [flags]

Arguments

ID

    ID única para um principal de serviço no espaço de trabalho Databricks.

Opções

Bandeiras globais

Examples

O exemplo a seguir obtém detalhes para um principal de serviço:

databricks service-principals get 12345

Listar principais de serviço do Databricks

Liste a lista de principais de serviço associadas a um espaço de trabalho do Databricks.

databricks service-principals list [flags]

Opções

--attributes string

    Lista separada por vírgulas de atributos a serem retornados em resposta.

--count int

    Número desejado de resultados por página.

--excluded-attributes string

    Lista separada por vírgulas de atributos a serem excluídos em resposta.

--filter string

    Consulta pela qual os resultados devem ser filtrados.

--sort-by string

    Atributo para classificar os resultados.

--sort-order ListSortOrder

    A ordem para classificar os resultados. Valores suportados: ascending, descending

--start-index int

    Especifica o índice do primeiro resultado.

Bandeiras globais

Examples

O exemplo a seguir lista todas as entidades de serviço:

databricks service-principals list

O exemplo a seguir lista principais de serviço com filtragem:

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

Patch dos Princípios de Serviço do Databricks

Atualize parcialmente os detalhes de um único principal de serviço no espaço de trabalho Databricks.

databricks service-principals patch ID [flags]

Arguments

ID

    ID exclusivo no espaço de trabalho Databricks.

Opções

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Examples

O exemplo a seguir aplica patch em um principal de serviço:

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

Atualizar os principais de serviço do Databricks

Atualize os detalhes de um único principal de serviço. Esta ação substitui o principal de serviço existente com o mesmo nome.

databricks service-principals update ID [flags]

Arguments

ID

    ID da entidade de serviço Databricks.

Opções

--active

    Se este usuário estiver ativo.

--application-id string

    UUID relativo ao principal de serviço.

--display-name string

    String que representa uma concatenação de nomes próprios e nomes de família.

--external-id string

    ID externa do principal de serviço.

--id string

    ID da entidade de serviço Databricks.

--json JSON

    A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.

Bandeiras globais

Examples

O exemplo a seguir mostra como atualizar um principal do serviço:

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

Bandeiras globais

--debug

  Se o log de depuração deve ser habilitado.

-h ou --help

    Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.

--log-file string

    Uma cadeia de caracteres que representa o arquivo para gravar logs de saída. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.

--log-format Formato

    O tipo text de formato de log ou json. O valor predefinido é text.

--log-level string

    Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.

-o, --output tipo

    O tipo de saída do comando, text ou json. O valor predefinido é text.

-p, --profile string

    O nome do perfil no ~/.databrickscfg arquivo a ser usado para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.

--progress-format Formato

    O formato para exibir logs de progresso: default, append, inplace, ou json

-t, --target string

    Se aplicável, o destino do pacote a ser usado