Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
ip-access-lists 内の コマンド グループには、管理者が IP アクセス リストを構成できるようにするコマンドが含まれています。
IP アクセス リストの管理を参照してください
databricks ipアクセスリスト作成
このワークスペースの IP アクセスリストを作成します。 リストには、許可リストまたはブロック リストを指定できます。
IP アクセス リストを作成または更新する場合:
- すべての許可リストとブロック リストの組み合わせに対して、このコマンドは最大 1000 個の IP/CIDR 値をサポートします。この値は、1 つの CIDR が 1 つの値としてカウントされます。 この数を超えようとすると、error_code値が
QUOTA_EXCEEDEDでエラー 400 が返されます。 - 新しいリストが呼び出し元のユーザーの現在の IP をブロックする場合は、エラー 400 がerror_code値
INVALID_STATE返されます。
変更が有効になるまで数分かかる場合があります。 結果として得られる IP アクセス リストは、この機能を有効にするまで効果がないことに注意してください。
databricks ip-access-lists create LABEL LIST_TYPE [flags]
Arguments
LABEL
Required. IP アクセス リストのラベル。
LIST_TYPE
IP アクセス リストの種類。 有効な値は次のとおりです。大文字と小文字は区別されます。
-
ALLOW: 許可リスト。 この IP または範囲を含めます。
-
BLOCK: ブロック リスト。 この IP または範囲を除外します。 ブロック リスト内の IP アドレスは、許可リストに含まれている場合でも除外されます。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、許可リストの IP アクセス リストを作成します。
databricks ip-access-lists create "Office Network" ALLOW --json '{"ip_addresses": ["192.168.1.0/24"]}'
次の例では、ブロック リストの IP アクセス リストを作成します。
databricks ip-access-lists create "Blocked IPs" BLOCK --json '{"ip_addresses": ["10.0.0.1"]}'
databricks の ip アクセス リストを削除
リスト ID で指定された IP アクセス リストを削除します。
databricks ip-access-lists delete IP_ACCESS_LIST_ID [flags]
Arguments
IP_ACCESS_LIST_ID
対応する IP アクセス リストの ID
オプション
Examples
次の例では、IP アクセス リストを削除します。
databricks ip-access-lists delete 12345
databricks IPアクセスリストを取得する
リスト ID で指定された IP アクセス リストを取得します。
databricks ip-access-lists get IP_ACCESS_LIST_ID [flags]
Arguments
IP_ACCESS_LIST_ID
対応する IP アクセス リストの ID
オプション
Examples
次の例では、IP アクセス リストの詳細を取得します。
databricks ip-access-lists get 12345
databricks ip-access-lists をリストする
指定したワークスペースのすべての IP アクセス リストを取得します。
databricks ip-access-lists list [flags]
Arguments
None
オプション
Examples
次の例では、ワークスペースのすべての IP アクセス リストを一覧表示します。
databricks ip-access-lists list
databricks ip-access-lists を置き換え
ID で指定された IP アクセス リストを置き換えます。 リストには、許可リストとブロック リストを含めることができます。
IP アクセス リストを置き換える場合:
- すべての許可リストとブロック リストの組み合わせに対して、API は最大 1,000 個の IP/CIDR 値をサポートし、1 つの CIDR が 1 つの値としてカウントされます。 この数を超えようとすると、error_code値が
QUOTA_EXCEEDEDでエラー 400 が返されます。 - 結果のリストが呼び出し元のユーザーの現在の IP をブロックする場合は、エラー 400 がerror_code値
INVALID_STATE返されます。
変更が有効になるまで数分かかる場合があります。 結果として得られる IP アクセス リストは、この機能を有効にするまで効果がないことに注意してください。
databricks ip-access-lists replace IP_ACCESS_LIST_ID LABEL LIST_TYPE ENABLED [flags]
Arguments
IP_ACCESS_LIST_ID
対応する IP アクセス リストの ID
LABEL
IP アクセス リストのラベル。 これを 空にすることはできません。
LIST_TYPE
IP アクセス リストの種類。 有効な値は次のとおりです。大文字と小文字は区別されます。
-
ALLOW: 許可リスト。 この IP または範囲を含めます。
-
BLOCK: ブロック リスト。 この IP または範囲を除外します。 ブロック リスト内の IP アドレスは、許可リストに含まれている場合でも除外されます。
ENABLED
この IP アクセス リストを有効にするかどうかを指定します。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、IP アクセス リストを新しい設定に置き換えます。
databricks ip-access-lists replace 12345 "Updated Office Network" ALLOW true --json '{"ip_addresses": ["192.168.1.0/24", "10.0.0.0/16"]}'
databricks ip-access-lists の更新
ID で指定された既存の IP アクセス リストを更新します。 リストには、許可リストとブロック リストを含めることができます。
IP アクセス リストを置き換える場合:
- すべての許可リストとブロック リストの組み合わせに対して、API は最大 1,000 個の IP/CIDR 値をサポートし、1 つの CIDR が 1 つの値としてカウントされます。 この数を超えようとすると、error_code値が
QUOTA_EXCEEDEDでエラー 400 が返されます。 - 結果のリストが呼び出し元のユーザーの現在の IP をブロックする場合は、エラー 400 がerror_code値
INVALID_STATE返されます。
変更が有効になるまで数分かかる場合があります。 結果として得られる IP アクセス リストは、この機能を有効にするまで効果がないことに注意してください。
databricks ip-access-lists update IP_ACCESS_LIST_ID [flags]
Arguments
IP_ACCESS_LIST_ID
対応する IP アクセス リストの ID
オプション
--enabled
この IP アクセス リストを有効にするかどうかを指定します。
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--label string
IP アクセス リストのラベル。
--list-type ListType
IP アクセス リストの種類。 有効な値は次のとおりです。大文字と小文字は区別されます。
-
ALLOW: 許可リスト。 この IP または範囲を含めます。
-
BLOCK: ブロック リスト。 この IP または範囲を除外します。 ブロック リスト内の IP アドレスは、許可リストに含まれている場合でも除外されます。
Examples
次の例では、IP アクセス リストのラベルを更新します。
databricks ip-access-lists update 12345 --label "Updated Network Label"
次の例では、IP アクセス リストを有効にします。
databricks ip-access-lists update 12345 --enabled
次の例では、IP アクセス リストの複数のプロパティを更新します。
databricks ip-access-lists update 12345 --label "Corporate Network" --list-type ALLOW --enabled --json '{"ip_addresses": ["192.168.0.0/16"]}'
グローバル フラグ
--debug
デバッグ ログを有効にするかどうかを指定します。
-h または --help
Databricks CLI、または関連コマンド グループ、または関連コマンドのヘルプの表示。
--log-file 文字列
出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、既定では stderr に出力ログが書き込まれます。
--log-format 形式
ログ形式の種類、 text 、または json。 既定値は text です。
--log-level 文字列
ログ形式レベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。
-o, --output 型
コマンド出力の種類( text または json)。 既定値は text です。
-p, --profile 文字列
コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。 このフラグが指定されていない場合は、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。
--progress-format 形式
進行状況ログを表示する形式: default、 append、 inplace、または json
-t, --target 文字列
該当する場合は、使用するバンドル ターゲット