Compartilhar via


Grupo de comandos service-principals

Note

Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em 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 provisionamentos de Dados de Uso.

O service-principals grupo de comandos dentro da CLI do Databricks permite que você gerencie princípios de serviço em seu workspace do Databricks. Veja Entidades de serviço para CI/CD.

criar principais de serviço do Databricks

Crie um novo principal de serviço no workspace do Databricks.

databricks service-principals create [flags]

Opções

--active

    Se esse usuário estiver ativo.

--application-id string

    UUID relacionada à entidade de serviço.

--display-name string

    Cadeia de caracteres que representa uma concatenação de nomes dados e sobrenomes.

--external-id string

    ID externa da entidade de serviço.

--id string

    ID da entidade de serviço do Databricks.

--json JSON

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

Sinalizadores globais

Examples

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

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

O exemplo a seguir cria um principal 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 workspace do Databricks.

databricks service-principals delete ID [flags]

Arguments

ID

    ID exclusiva para uma entidade de serviço no workspace do Databricks.

Opções

Sinalizadores globais

Examples

O seguinte exemplo exclui uma entidade de serviço pela ID:

databricks service-principals delete 12345

databricks service-principals get

Obtenha os detalhes de uma única entidade de serviço definida no workspace do Databricks.

databricks service-principals get ID [flags]

Arguments

ID

    ID exclusiva para uma entidade de serviço no workspace do Databricks.

Opções

Sinalizadores globais

Examples

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

databricks service-principals get 12345

lista de princípios de serviço do Databricks

Liste o conjunto de entidades de serviço associadas a um workspace 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 precisam ser filtrados.

--sort-by string

    Atributo para classificar os resultados.

--sort-order ListSortOrder

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

--start-index int

    Especifica o índice do primeiro resultado.

Sinalizadores globais

Examples

O seguinte exemplo lista todas as entidades de serviço:

databricks service-principals list

O seguinte exemplo lista as entidades de serviço com filtro:

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

patch de principais de serviço do databricks

Atualize parcialmente os detalhes de uma única entidade de serviço no workspace do Databricks..

databricks service-principals patch ID [flags]

Arguments

ID

    ID exclusiva no workspace do Databricks.

Opções

--json JSON

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

Sinalizadores globais

Examples

O seguinte exemplo aplica um patch em uma entidade de serviço:

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

atualização de princípios de serviço do databricks

Atualize os detalhes de uma única entidade de serviço. Esta ação substitui a entidade de serviço existente com o mesmo nome.

databricks service-principals update ID [flags]

Arguments

ID

    ID da entidade de serviço do Databricks.

Opções

--active

    Se esse usuário estiver ativo.

--application-id string

    UUID relacionada à entidade de serviço.

--display-name string

    Cadeia de caracteres que representa uma concatenação de nomes dados e sobrenomes.

--external-id string

    ID externa da entidade de serviço.

--id string

    ID da entidade de serviço do Databricks.

--json JSON

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

Sinalizadores globais

Examples

O exemplo a seguir atualiza uma entidade de serviço:

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

Sinalizadores globais

--debug

  Indica se deve habilitar o registro em log de depuração.

-h ou --help

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

--log-file corda

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

--log-format formato

    O tipo de formato de log, text ou json. O valor padrão é text.

--log-level corda

    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á desabilitado.

-o, --output tipo

    O tipo de saída de comando, text ou json. O valor padrão é text.

-p, --profile corda

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

--progress-format formato

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

-t, --target corda

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