メインコンテンツまでスキップ

クラスターポリシー CLI (legacy)

important

このドキュメントは廃止されており、更新されない可能性があります。

この情報は、従来の 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を呼び出します。

Bash
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を実行します。

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

create-cluster-policy.json:

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

クラスターポリシーの削除​

ヘルプを表示するには、 databricks cluster-policies delete --helpを実行します。

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

成功すると、このコマンドは何も表示されません。

クラスターポリシーの変更​

使用方法のドキュメントを表示するには、 databricks cluster-policies edit --helpを実行します。

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

edit-cluster-policy.json:

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

成功すると、このコマンドは何も表示されません。

List information about a クラスターポリシー​

使用方法のドキュメントを表示するには、 databricks cluster-policies get --helpを実行します。

Bash
databricks cluster-policies get --policy-id A123456BCD789012
Console
{
  "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
}

List information about available クラスターポリシー​

使用方法のドキュメントを表示するには、 databricks cluster-policies list --helpを実行します。

Bash
databricks cluster-policies list --output JSON
Console
{
  "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
}
に最終更新