叢集原則 CLI （舊版）

發行項
01/22/2025

重要

此文件已停止使用，可能不會再更新。

此資訊適用於舊版 Databricks CLI 0.18 版和更新版本。 Databricks 建議您改用較新的 Databricks CLI 0.205 版或更新版本。請參閱什麼是 Databricks CLI？。若要尋找 Databricks CLI 版本，請執行 databricks -v。

若要從 Databricks CLI 0.18 版或更新版本移轉至 Databricks CLI 0.205 版或更新版本，請參閱 Databricks CLI 移轉。

只有工作區系統管理員使用者可以建立、編輯和刪除原則。工作區系統管理員使用者也可以存取所有政策。

如需叢集原則的需求和限制，請參閱建立和管理計算原則。

您可以透過將 Databricks 叢集政策 CLI 子命令附加至 databricks cluster-policies來執行。這些子命令會呼叫叢集原則 API。

databricks cluster-policies --help

Usage: databricks cluster-policies [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks cluster policies.

Options:
  -v, --version   [VERSION]
  --debug         Debug mode. Shows full stack trace on error.
  --profile TEXT  CLI connection profile to use. The default profile is
                  "DEFAULT".

  -h, --help      Show this message and exit.

Commands:
  create  Creates a Databricks cluster policy.
  delete  Removes a Databricks cluster policy given its ID.
  edit    Edits a Databricks cluster policy.
  get     Retrieves metadata about a Databricks cluster policy.
  list    Lists Databricks cluster policies.

建立叢集原則

若要顯示用法說明文件，請執行 databricks cluster-policies create --help。

databricks cluster-policies create --json-file create-cluster-policy.json

create-cluster-policy.json：

{
  "name": "Example Policy",
  "definition": "{\"spark_version\":{\"type\":\"fixed\",\"value\":\"next-major-version-scala2.12\",\"hidden\":true}}"
}

{
  "policy_id": "1A234567B890123C"
}

刪除叢集原則

若要檢視說明，請執行 databricks cluster-policies delete --help。

databricks cluster-policies delete --policy-id 1A234567B890123C

成功時，此命令不會顯示任何內容。

變更叢集原則

若要顯示用法說明文件，請執行 databricks cluster-policies edit --help。

databricks cluster-policies edit --json-file edit-cluster-policy.json

edit-cluster-policy.json：

{
  "policy_id": "1A234567B890123C",
  "name": "Example Policy",
  "definition": "{\"spark_version\":{\"type\":\"fixed\",\"value\":\"next-major-version-scala2.12\",\"hidden\":false}}",
  "created_at_timestamp": 1619477108000
}

成功時，此命令不會顯示任何內容。

列出叢集原則的相關信息

若要顯示用法說明文件，請執行 databricks cluster-policies get --help。

databricks cluster-policies get --policy-id A123456BCD789012

{
  "policy_id": "A123456BCD789012",
  "name": "Cluster Policy Demo",
  "definition": "{\n  \"spark_env_vars.PYSPARK_PYTHON\": {\n    \"type\": \"fixed\",\n    \"value\": \"/databricks/python3/bin/python27\"\n  }\n}",
  "created_at_timestamp": 1615504519000
}

列出可用叢集原則的相關資訊

若要顯示用法說明文件，請執行 databricks cluster-policies list --help。

databricks cluster-policies list --output JSON

{
  "policies": [
    {
      "policy_id": "A123456BCD789012",
      "name": "Cluster Policy Demo",
      "definition": "{\n  \"spark_env_vars.PYSPARK_PYTHON\": {\n    \"type\": \"fixed\",\n    \"value\": \"/databricks/python3/bin/python27\"\n  }\n}",
      "created_at_timestamp": 1615504519000
    },
    ...
  ],
  "total_count": 16
}

共用方式為