service-principals-v2コマンドグループ

注記

この情報は、Databricks CLI バージョン 0.205 以降に適用されます。Databricks CLI はパブリックプレビュー版です。

Databricks CLI使用には、使用状況データ プロビジョニングを含むDatabricksライセンスおよびDatabricksプライバシー通知が適用されます。

Databricks CLI内のservice-principals-v2コマンド グループを使用すると、ジョブ、自動化ツール、スクリプト、アプリ、 CI/CDプラットフォームなどのシステムで使用するサービスプリンシパル ID を管理できます。 Databricks 、本番運用ジョブを実行するか、本番運用データを変更するためにサービスプリンシパルを作成することをお勧めします。

databricks サービスプリンシパル-v2 作成

Databricksワークスペースに新しいサービスプリンシパルを作成します。

databricks service-principals-v2 create [flags]

議論

なし

オプション

--active

このサービスプリンシパルがアクティブな場合。

--application-id string

サービスプリンシパルに関連するUUID。

--display-name string

名と姓を連結した文字列。

--external-id string

サービスプリンシパルの外部ID。

--id string

DatabricksプリンシパルID。

--json JSON

インラインJSON構文、またはリクエストボディを含むJSONファイルへの@path。

世界の国旗

例

次の例では、新しいサービスプリンシパルを作成します。

Bash

databricks service-principals-v2 create --display-name "my-service-principal"

databricks サービスプリンシパル v2 削除

Databricksワークスペースから 1 つのサービスプリンシパルを削除します。

databricks service-principals-v2 delete ID [flags]

議論

ID

Databricksワークスペース内のサービスプリンシパルの一意のID。

オプション

世界の国旗

例

次の例は、サービスプリンシパルを削除するものです。

Bash

databricks service-principals-v2 delete 12345678

databricks サービスプリンシパル v2 を取得する

Databricksワークスペースで定義された単一のサービスプリンシパルの詳細を取得します。

databricks service-principals-v2 get ID [flags]

議論

ID

Databricksワークスペース内のサービスプリンシパルの一意のID。

オプション

世界の国旗

例

以下の例は、サービスプリンシパルの詳細を取得するものです。

Bash

databricks service-principals-v2 get 12345678

databricks サービスプリンシパル v2 リスト

Databricksワークスペースに関連付けられたサービスプリンシパルのセットを取得します。

databricks service-principals-v2 list [flags]

議論

なし

オプション

--attributes string

レスポンスで返す属性をカンマ区切りで指定します。

--count int

1ページあたりの表示件数。

--excluded-attributes string

レスポンスから除外する属性をカンマ区切りで指定します。

--filter string

結果を絞り込むためのクエリ。

--sort-by string

結果を並べ替えるための属性。

--sort-order ListSortOrder

結果を並べ替える順序。サポートされている値: ascending 、 descending

--start-index int

最初の検索結果のインデックスを指定します。

世界の国旗

例

以下の例は、すべてのサービスプリンシパルを一覧表示したものです。

Bash

databricks service-principals-v2 list

databricks サービスプリンシパル v2 パッチ

Databricks内の単一サービスプリンパルシの詳細を部分的に更新します。

databricks service-principals-v2 patch ID [flags]

議論

ID

Databricksワークスペース内の一意のID。

オプション

--json JSON

インラインJSON構文、またはリクエストボディを含むJSONファイルへの@path。

世界の国旗

例

次の例では、 JSONファイルを使用してサービスプリンシパルにパッチを適用します。

Bash

databricks service-principals-v2 patch 12345678 --json @patch.json

Databricks サービスプリンシパル v2 アップデート

単一のサービスプリンシパルの詳細を更新します。この操作により、既存のサービスプリンシパルが同じ名前で置き換えられます。

databricks service-principals-v2 update ID [flags]

議論

ID

DatabricksプリンシパルID。

オプション

--active

このサービスプリンシパルがアクティブな場合。

--application-id string

サービスプリンシパルに関連するUUID。

--display-name string

名と姓を連結した文字列。

--external-id string

サービスプリンシパルの外部ID。

--json JSON

インラインJSON構文、またはリクエストボディを含むJSONファイルへの@path。

世界の国旗

例

次の例は、サービスプリンシパルの表示名を更新するものです。

Bash

databricks service-principals-v2 update 12345678 --display-name "updated-service-principal"

世界の国旗

--debug

デバッグログを有効にするかどうか。

-h または --help

Databricks CLI、関連するコマンドグループ、または関連するコマンドのヘルプを表示します。

--log-file string

出力ログを書き込むファイルを表す文字列。このフラグが指定されていない場合、デフォルトでは出力ログは標準エラー出力に書き込まれます。

--log-format format

ログフォーマットタイプ、 textまたはjson 。デフォルト値はtextです。

--log-level string

ログフォーマットレベルを表す文字列。指定されていない場合、ログフォーマットレベルは無効になります。

-o, --output タイプ

コマンド出力タイプ、 textまたはjson 。デフォルト値はtextです。

-p, --profile string

コマンドを実行するために使用する、 ~/.databrickscfgファイル内のプロファイル名。このフラグが指定されていない場合、存在する場合はDEFAULTという名前のプロファイルが使用されます。

--progress-format format

進捗ログを表示する形式: default 、 append 、 inplace 、または json

-t, --target string

該当する場合、使用するバンドルターゲット