Freigeben über


Clusterrichtlinien CLI (veraltet)

Von Bedeutung

Diese Dokumentation wurde eingestellt und wird unter Umständen nicht aktualisiert.

Diese Informationen gelten für ältere Databricks CLI-Versionen 0.18 und darunter. Databricks empfiehlt, stattdessen neuere Databricks CLI-Version 0.205 oder höher zu verwenden. Weitere Informationen finden Sie unter Was ist die Databricks-CLI?. Um Ihre Version der Databricks CLI zu finden, führen Sie databricks -vaus.

Informationen zum Migrieren der Databricks CLI-Version 0.18 oder niedriger zur Databricks CLI-Version 0.205 oder höher finden Sie unter Databricks CLI-Migration.

Nur Arbeitsbereichsadministratorbenutzer können Richtlinien erstellen, bearbeiten und löschen. Arbeitsbereichsadministratorbenutzer haben auch Zugriff auf alle Richtlinien.

Anforderungen und Einschränkungen für Clusterrichtlinien finden Sie unter Erstellen und Verwalten von Computerichtlinien.

Sie führen Databricks Cluster Policies CLI-Unterbefehle aus, indem Sie sie an databricks cluster-policies anhängen. Diese Unterbefehle rufen die Clusterrichtlinien-API auf.

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.

Erstellen einer Clusterrichtlinie

Führen Sie databricks cluster-policies create --helpaus, um die Verwendungsdokumentation anzuzeigen.

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"
}

Löschen einer Clusterrichtlinie

Führen Sie zum Anzeigen der Hilfe den Befehl databricks cluster-policies delete --helpaus.

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

Bei Erfolg zeigt dieser Befehl nichts an.

Ändern einer Clusterrichtlinie

Führen Sie databricks cluster-policies edit --helpaus, um die Verwendungsdokumentation anzuzeigen.

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
}

Bei Erfolg zeigt dieser Befehl nichts an.

Auflisten von Informationen zu einer Clusterrichtlinie

Führen Sie databricks cluster-policies get --helpaus, um die Verwendungsdokumentation anzuzeigen.

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
}

Auflisten von Informationen zu verfügbaren Clusterrichtlinien

Führen Sie databricks cluster-policies list --helpaus, um die Verwendungsdokumentation anzuzeigen.

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
}