.alter cluster policy callout command

Article
09/30/2024

Applies to: ✅ Azure Data Explorer

Changes the cluster's callout policy.

Permissions

You must have Cluster AllDatabasesAdmin permissions to run this command.

Syntax

.alter cluster policy callout SerializedArrayOfPolicyObjects

Learn more about syntax conventions.

Parameters

Name	Type	Required	Description
SerializedArrayOfPolicyObjects	`string`	✔️	A serialized array of JSON policy objects. See callout policy for policy properties.

Returns

Name	Type	Description
PolicyName	`string`	Name of the policy. For cluster callout policy, this value is CalloutPolicy.
EntityName	`string`	Name of the entity for which the policy is set. For cluster callout 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 callout policy, this value is an empty string.
EntityType	`string`	Type of entity for which this policy is set. For cluster callout policy, this value is an empty string.

Examples

Define permitted callouts for the cluster

Define permitted callouts for the cluster callout policy.

.alter cluster policy callout
```
[
    {
        "CalloutType": "sql",
        "CalloutUriRegex": "sqlname\\.database\\.chinacloudapi\\.cn/?$",
        "CanCall": true
    }
]
```

Output

PolicyName	EntityName	Policy	ChildEntities	EntityType
CalloutPolicy		[{"CalloutType":"sql","CalloutUriRegex":"sqlname\\.database\\.chinacloudapi\\.cn/?$","CanCall": true}]