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.
Bicep resource definition
The clusters/principalAssignments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Kusto/clusters/principalAssignments resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.Kusto/clusters/principalAssignments@2022-11-11' = {
parent: resourceSymbolicName
name: 'string'
properties: {
principalId: 'string'
principalType: 'string'
role: 'string'
tenantId: 'string'
}
}
Property Values
Microsoft.Kusto/clusters/principalAssignments
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| parent | In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource. |
Symbolic name for resource of type: clusters |
| properties | The cluster principal. | ClusterPrincipalProperties |
ClusterPrincipalProperties
| Name | Description | Value |
|---|---|---|
| principalId | The principal ID assigned to the cluster principal. It can be a user email, application ID, or security group name. | string (required) |
| principalType | Principal type. | 'App' 'Group' 'User' (required) |
| role | Cluster principal role. | 'AllDatabasesAdmin' 'AllDatabasesViewer' (required) |
| tenantId | The tenant id of the principal | string |
Usage Examples
Azure Quickstart Samples
The following Azure Quickstart templates contain Bicep samples for deploying this resource type.
| Bicep File | Description |
|---|---|
| FinOps hub | This template creates a new FinOps hub instance, including Data Explorer, Data Lake storage, and Data Factory. |
ARM template resource definition
The clusters/principalAssignments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Kusto/clusters/principalAssignments resource, add the following JSON to your template.
{
"type": "Microsoft.Kusto/clusters/principalAssignments",
"apiVersion": "2022-11-11",
"name": "string",
"properties": {
"principalId": "string",
"principalType": "string",
"role": "string",
"tenantId": "string"
}
}
Property Values
Microsoft.Kusto/clusters/principalAssignments
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2022-11-11' |
| name | The resource name | string (required) |
| properties | The cluster principal. | ClusterPrincipalProperties |
| type | The resource type | 'Microsoft.Kusto/clusters/principalAssignments' |
ClusterPrincipalProperties
| Name | Description | Value |
|---|---|---|
| principalId | The principal ID assigned to the cluster principal. It can be a user email, application ID, or security group name. | string (required) |
| principalType | Principal type. | 'App' 'Group' 'User' (required) |
| role | Cluster principal role. | 'AllDatabasesAdmin' 'AllDatabasesViewer' (required) |
| tenantId | The tenant id of the principal | string |
Usage Examples
Azure Quickstart Templates
The following Azure Quickstart templates deploy this resource type.
| Template | Description |
|---|---|
| FinOps hub |
This template creates a new FinOps hub instance, including Data Explorer, Data Lake storage, and Data Factory. |
Terraform (AzAPI provider) resource definition
The clusters/principalAssignments resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Kusto/clusters/principalAssignments resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Kusto/clusters/principalAssignments@2022-11-11"
name = "string"
parent_id = "string"
body = {
properties = {
principalId = "string"
principalType = "string"
role = "string"
tenantId = "string"
}
}
}
Property Values
Microsoft.Kusto/clusters/principalAssignments
| Name | Description | Value |
|---|---|---|
| name | The resource name | string (required) |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: clusters |
| properties | The cluster principal. | ClusterPrincipalProperties |
| type | The resource type | "Microsoft.Kusto/clusters/principalAssignments@2022-11-11" |
ClusterPrincipalProperties
| Name | Description | Value |
|---|---|---|
| principalId | The principal ID assigned to the cluster principal. It can be a user email, application ID, or security group name. | string (required) |
| principalType | Principal type. | 'App' 'Group' 'User' (required) |
| role | Cluster principal role. | 'AllDatabasesAdmin' 'AllDatabasesViewer' (required) |
| tenantId | The tenant id of the principal | string |
Usage Examples
Terraform Samples
A basic example of deploying Kusto Cluster Principal Assignment.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
azurerm = {
source = "hashicorp/azurerm"
}
}
}
provider "azurerm" {
features {
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
data "azurerm_client_config" "current" {
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "cluster" {
type = "Microsoft.Kusto/clusters@2023-05-02"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
enableAutoStop = true
enableDiskEncryption = false
enableDoubleEncryption = false
enablePurge = false
enableStreamingIngest = false
engineType = "V2"
publicIPType = "IPv4"
publicNetworkAccess = "Enabled"
restrictOutboundNetworkAccess = "Disabled"
trustedExternalTenants = [
]
}
sku = {
capacity = 1
name = "Dev(No SLA)_Standard_D11_v2"
tier = "Basic"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "principalAssignment" {
type = "Microsoft.Kusto/clusters/principalAssignments@2023-05-02"
parent_id = azapi_resource.cluster.id
name = var.resource_name
body = {
properties = {
principalId = data.azurerm_client_config.current.client_id
principalType = "App"
role = "AllDatabasesViewer"
tenantId = data.azurerm_client_config.current.tenant_id
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}