Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明,包括任何使用數據條款。
ip-access-lists
Databricks CLI 中的指令群組包含允許管理員設定 IP 存取清單的指令。 請參閱 管理IP存取清單
Databricks IP-存取列表建立
建立此工作區的IP存取清單。 清單可以是允許清單或封鎖清單。
建立或更新 IP 存取清單時:
- 針對合併的所有允許清單和區塊清單,命令最多支援 1000 個 IP/CIDR 值,其中一個 CIDR 會計算為單一值。 嘗試超過該數值時,將返回錯誤 400,且 error_code 值為
QUOTA_EXCEEDED。 - 如果新清單會封鎖呼叫使用者的目前 IP,則會傳回錯誤 400,且值為
INVALID_STATEerror_code 。
變更可能需要幾分鐘的時間才會生效。 請注意,在您啟用此功能之前,產生的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 字串或 @path 整合至包含要求內容的 JSON 檔案。
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-access-lists 刪除
刪除其清單識別碼所指定的IP存取清單。
databricks ip-access-lists delete IP_ACCESS_LIST_ID [flags]
Arguments
IP_ACCESS_LIST_ID
對應IP存取清單的識別碼
選項
Examples
下列範例會移除 IP 存取清單:
databricks ip-access-lists delete 12345
Databricks IP 存取清單 獲取
取得由其清單識別子指定的IP存取清單。
databricks ip-access-lists get IP_ACCESS_LIST_ID [flags]
Arguments
IP_ACCESS_LIST_ID
對應IP存取清單的識別碼
選項
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 存取清單替換
更換指定其識別碼的 IP 存取清單。 清單可以包含允許清單和封鎖清單。
取代IP存取清單時:
- 針對合併的所有允許清單和區塊清單,API 最多支援 1000 個 IP/CIDR 值,其中一個 CIDR 會計算為單一值。 嘗試超過該數值時,將返回錯誤 400,且 error_code 值為
QUOTA_EXCEEDED。 - 如果產生的清單會封鎖呼叫使用者的目前IP,則會傳回錯誤400,且值為
INVALID_STATEerror_code 。
變更可能需要幾分鐘的時間才會生效。 請注意,在您啟用此功能之前,產生的IP存取清單沒有任何作用。
databricks ip-access-lists replace IP_ACCESS_LIST_ID LABEL LIST_TYPE ENABLED [flags]
Arguments
IP_ACCESS_LIST_ID
對應IP存取清單的識別碼
LABEL
IP 存取清單的標籤。 這裡 不能 是空的。
LIST_TYPE
IP 存取清單的類型。 有效值為下列值,且區分大小寫:
-
ALLOW:允許清單。 包括此 IP 地址或範圍。
-
BLOCK:區塊清單。 排除此IP或範圍。 即使封鎖清單中的IP位址包含在允許清單中,也會排除這些位址。
ENABLED
指定是否啟用此IP存取清單。
選項
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
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存取清單更新
更新其識別碼所指定的現有IP存取清單。 清單可以包含允許清單和封鎖清單。
取代IP存取清單時:
- 針對合併的所有允許清單和區塊清單,API 最多支援 1000 個 IP/CIDR 值,其中一個 CIDR 會計算為單一值。 嘗試超過該數值時,將返回錯誤 400,且 error_code 值為
QUOTA_EXCEEDED。 - 如果產生的清單會封鎖呼叫使用者的目前IP,則會傳回錯誤400,且值為
INVALID_STATEerror_code 。
變更可能需要幾分鐘的時間才會生效。 請注意,在您啟用此功能之前,產生的IP存取清單沒有任何作用。
databricks ip-access-lists update IP_ACCESS_LIST_ID [flags]
Arguments
IP_ACCESS_LIST_ID
對應IP存取清單的識別碼
選項
--enabled
指定是否啟用此IP存取清單。
--json JSON
內嵌的 JSON 字串或 @path 整合至包含要求內容的 JSON 檔案。
--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、、appendinplace、 或json
-t, --target 字串
如果適用,要使用的套件組合目標