.alter-merge cluster policy request_classification command

  • Article

Applies to: ✅ Azure Data Explorer

Enables or disables the cluster's request classification policy.

Permissions

You must have Cluster AllDatabasesAdmin permissions to run this command.

Syntax

.alter-merge cluster policy request_classification '{"IsEnabled": [true|false] }

Learn more about syntax conventions.

Returns

The command returns one row showing the details of the cluster request classification policy.

Following is the schema of the output returned:

Name Type Description
PolicyName string Name of the policy. For cluster request classification policy this value is ClusterRequestClassificationPolicy.
EntityName string Name of the entity for which the policy is set. For cluster request classification policy this value is an empty string.
Policy string JSON representation of the policy object.
ChildEntities string Child entities for which this policy is set. For cluster request classification policy this value is an empty string.
EntityType string Type of entity for which this policy is set. For cluster request classification policy this value is an empty string.

Examples

Enable the policy

Enable request classification policy for the cluster:

.alter-merge cluster policy request_classification '{"IsEnabled":true}'

Output

PolicyName EntityName Policy ChildEntities EntityType
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": true, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query","Ad-hoc queries","default")"}

Disable the policy

Disable request classification policy for the cluster:

.alter-merge cluster policy request_classification '{"IsEnabled":false}'

Output

PolicyName EntityName Policy ChildEntities EntityType
ClusterRequestClassificationPolicy {"ClassificationProperties": ["current_application", "request_type" ],"IsEnabled": false, "ClassificationFunction": "iff(request_properties.current_application == "Kusto.Explorer" and request_properties.request_type == "Query","Ad-hoc queries","default")"}