Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Switch services using the Version drop-down list. Learn more about navigation.
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")"} |