Added description to max_clusters_per_user in databricks_cluster_policy (#1959)

Author: iandexter

README.md

@@ -98,7 +98,7 @@ If you use Terraform 0.13 or newer, please refer to instructions specified at [r
 terraform {
   required_providers {
     databricks = {
-      source  = "databricks/databricks"
+      source = "databricks/databricks"
     }
   }
 }

docs/data-sources/mws_credentials.md

@@ -43,4 +43,4 @@ The following resources are used in the same context:
 * [databricks_mws_log_delivery](mws_log_delivery.md) to configure delivery of [billable usage logs](https://docs.databricks.com/administration-guide/account-settings/billable-usage-delivery.html) and [audit logs](https://docs.databricks.com/administration-guide/account-settings/audit-logs.html).
 * [databricks_mws_networks](mws_networks.md) to [configure VPC](https://docs.databricks.com/administration-guide/cloud-configurations/aws/customer-managed-vpc.html) & subnets for new workspaces within AWS.
 * [databricks_mws_storage_configurations](mws_storage_configurations.md) to configure root bucket new workspaces within AWS.
-* [databricks_mws_workspaces](mws_workspaces.md) to set up [workspaces in E2 architecture on AWS](https://docs.databricks.com/getting-started/overview.html#e2-architecture-1).
+* [databricks_mws_workspaces](mws_workspaces.md) to set up [workspaces in E2 architecture on AWS](https://docs.databricks.com/getting-started/overview.html#e2-architecture-1).

docs/resources/cluster_policy.md

@@ -99,7 +99,7 @@ The following arguments are required:
 
 * `name` - (Required) Cluster policy name. This must be unique. Length must be between 1 and 100 characters.
 * `definition` - (Required) Policy definition: JSON document expressed in [Databricks Policy Definition Language](https://docs.databricks.com/administration-guide/clusters/policies.html#cluster-policy-definition).
-* `max_clusters_per_user` - (Optional, integer) Maximum number of clusters allowed per user. When omitted, there is no limit.
+* `max_clusters_per_user` - (Optional, integer) Maximum number of clusters allowed per user. When omitted, there is no limit. If specified, value must be greater than zero.
 
 ## Attribute Reference
 

docs/resources/sql_dashboard.md

@@ -17,7 +17,7 @@ resource "databricks_directory" "shared_dir" {
 }
 
 resource "databricks_sql_dashboard" "d1" {
-  name = "My Dashboard Name"
+  name   = "My Dashboard Name"
   parent = "folders/${databricks_directory.shared_dir.object_id}"
 
   tags = [

docs/resources/sql_query.md

@@ -26,7 +26,7 @@ resource "databricks_sql_query" "q1" {
                         AND event_date > date '{{ p3 }}'
                     EOT
 
-  parent = "folders/${databricks_directory.shared_dir.object_id}"
+  parent      = "folders/${databricks_directory.shared_dir.object_id}"
   run_as_role = "viewer"
 
   schedule {

policies/resource_cluster_policy.go

@@ -18,7 +18,7 @@ type ClusterPolicy struct {
 	MaxClustersPerUser int64  `json:"max_clusters_per_user,omitempty"`
 }
 
-// ClusterPolicyCreate is the endity used for request
+// ClusterPolicyCreate is the entity used for request
 type ClusterPolicyCreate struct {
 	Name               string `json:"name"`
 	Definition         string `json:"definition"`
@@ -125,6 +125,9 @@ func ResourceClusterPolicy() *schema.Resource {
 			"max_clusters_per_user": {
 				Type:     schema.TypeInt,
 				Optional: true,
+				Description: "Max number of clusters per user that can be active\n" +
+				    "using this policy. If not present, there is no max limit.",
+				ValidateFunc: validation.IntAtLeast(1),
 			},
 		},
 		Create: func(ctx context.Context, d *schema.ResourceData, c *common.DatabricksClient) error {