Clusters Microsoft.Kusto
Definição de recurso do Bicep
O tipo de recurso de clusters pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Kusto/clusters, adicione o Bicep a seguir ao seu modelo.
resource symbolicname 'Microsoft.Kusto/clusters@2024-04-13' = {
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
acceptedAudiences: [
{
value: 'string'
}
]
allowedFqdnList: [
'string'
]
allowedIpRangeList: [
'string'
]
calloutPolicies: [
{
calloutType: 'string'
calloutUriRegex: 'string'
outboundAccess: 'string'
}
]
enableAutoStop: bool
enableDiskEncryption: bool
enableDoubleEncryption: bool
enablePurge: bool
enableStreamingIngest: bool
engineType: 'string'
keyVaultProperties: {
keyName: 'string'
keyVaultUri: 'string'
keyVersion: 'string'
userIdentity: 'string'
}
languageExtensions: {
value: [
{
languageExtensionCustomImageName: 'string'
languageExtensionImageName: 'string'
languageExtensionName: 'string'
}
]
}
optimizedAutoscale: {
isEnabled: bool
maximum: int
minimum: int
version: int
}
publicIPType: 'string'
publicNetworkAccess: 'string'
restrictOutboundNetworkAccess: 'string'
trustedExternalTenants: [
{
value: 'string'
}
]
virtualClusterGraduationProperties: 'string'
virtualNetworkConfiguration: {
dataManagementPublicIpId: 'string'
enginePublicIpId: 'string'
state: 'string'
subnetId: 'string'
}
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
zones: [
'string'
]
}
Valores de propriedade
AcceptedAudiences
Nome | Descrição | Valor |
---|---|---|
valor | GUID ou URL válida que representa um público-alvo aceito. | corda |
AzureSku
Nome | Descrição | Valor |
---|---|---|
capacidade | O número de instâncias do cluster. | int |
nome | Nome do SKU. | 'Dev(No SLA)_Standard_D11_v2' 'Dev(No SLA)_Standard_E2a_v4' 'Standard_D11_v2' 'Standard_D12_v2' 'Standard_D13_v2' 'Standard_D14_v2' 'Standard_D16d_v5' 'Standard_D32d_v4' 'Standard_D32d_v5' 'Standard_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16ads_v5' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E16as_v5+3TB_PS' 'Standard_E16as_v5+4TB_PS' 'Standard_E16a_v4' 'Standard_E16d_v4' 'Standard_E16d_v5' 'Standard_E16s_v4+3TB_PS' 'Standard_E16s_v4+4TB_PS' 'Standard_E16s_v5+3TB_PS' 'Standard_E16s_v5+4TB_PS' 'Standard_E2ads_v5' 'Standard_E2a_v4' 'Standard_E2d_v4' 'Standard_E2d_v5' 'Standard_E4ads_v5' 'Standard_E4a_v4' 'Standard_E4d_v4' 'Standard_E4d_v5' 'Standard_E64i_v3' 'Standard_E80ids_v4' 'Standard_E8ads_v5' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_E8as_v5+1TB_PS' 'Standard_E8as_v5+2TB_PS' 'Standard_E8a_v4' 'Standard_E8d_v4' 'Standard_E8d_v5' 'Standard_E8s_v4+1TB_PS' 'Standard_E8s_v4+2TB_PS' 'Standard_E8s_v5+1TB_PS' 'Standard_E8s_v5+2TB_PS' 'Standard_EC16ads_v5' 'Standard_EC16as_v5+3TB_PS' 'Standard_EC16as_v5+4TB_PS' 'Standard_EC8ads_v5' 'Standard_EC8as_v5+1TB_PS' 'Standard_EC8as_v5+2TB_PS' 'Standard_L16as_v3' 'Standard_L16s' 'Standard_L16s_v2' 'Standard_L16s_v3' 'Standard_L32as_v3' 'Standard_L32s_v3' 'Standard_L4s' 'Standard_L8as_v3' 'Standard_L8s' 'Standard_L8s_v2' 'Standard_L8s_v3' (obrigatório) |
camada | Camada de SKU. | 'Básico' 'Standard' (obrigatório) |
CalloutPolicy
Nome | Descrição | Valor |
---|---|---|
calloutType | Tipo do serviço de texto explicativo, especificando o tipo de recurso ou serviço externo que está sendo acessado. | 'azure_digital_twins' 'azure_openai' 'cosmosdb' 'external_data' 'genevametrics' 'kusto' 'mysql' 'postgresql' 'sandbox_artifacts' 'sql' 'webapi' |
calloutUriRegex | Expressão regular ou padrão FQDN para o URI de texto explicativo. | corda |
outboundAccess | Indica se o acesso de saída é permitido para o padrão de URI especificado. | 'Permitir' 'Negar' |
ClusterProperties
Nome | Descrição | Valor |
---|---|---|
acceptedAudiences | As audiências aceitas do cluster. | AcceptedAudiences[] |
allowedFqdnList | Lista de FQDNs permitidos (Nome de Domínio Totalmente Qualificado) para saída do Cluster. | string[] |
allowedIpRangeList | A lista de ips no formato cidr permitido para se conectar ao cluster. | string[] |
calloutPolicies | Lista de políticas de texto explicativo para saída do Cluster. | CalloutPolicy [] |
enableAutoStop | Um valor booliano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou nenhuma atividade por muitos dias). | Bool |
enableDiskEncryption | Um valor booliano que indica se os discos do cluster são criptografados. | Bool |
enableDoubleEncryption | Um valor booliano que indica se a criptografia dupla está habilitada. | Bool |
enablePurge | Um valor booliano que indica se as operações de limpeza estão habilitadas. | Bool |
enableStreamingIngest | Um valor booliano que indica se a ingestão de streaming está habilitada. | Bool |
engineType | O tipo de mecanismo | 'V2' 'V3' |
keyVaultProperties | Propriedades KeyVault para a criptografia de cluster. | KeyVaultProperties |
languageExtensions | Lista de extensões de idioma do cluster. | |
optimizedAutoscale | Definição de dimensionamento automático otimizada. | OptimizedAutoscale |
publicIPType | Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6) | 'DualStack' 'IPv4' |
publicNetworkAccess | O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida | 'Desabilitado' 'Habilitado' |
restrictOutboundNetworkAccess | Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado' | 'Desabilitado' 'Habilitado' |
trustedExternalTenants | Os locatários externos do cluster. | TrustedExternalTenant [] |
virtualClusterGraduationProperties | Propriedades de graduação do Cluster Virtual | corda Restrições: Valor confidencial. Passe como um parâmetro seguro. |
virtualNetworkConfiguration | Definição de rede virtual. | |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
Nome | Descrição | Valor |
---|
Identidade
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (obrigatório) |
userAssignedIdentities | A lista de identidades de usuário associadas ao cluster Kusto. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Nome | Descrição | Valor |
---|
KeyVaultProperties
Nome | Descrição | Valor |
---|---|---|
keyName | O nome da chave do cofre de chaves. | corda |
keyVaultUri | O Uri do cofre de chaves. | corda |
keyVersion | A versão da chave do cofre de chaves. | corda |
userIdentity | A identidade atribuída pelo usuário (ID de recurso do ARM) que tem acesso à chave. | corda |
LanguageExtension
Nome | Descrição | Valor |
---|---|---|
languageExtensionCustomImageName | O nome da imagem personalizada da extensão de idioma. | corda |
languageExtensionImageName | O nome da imagem da extensão de idioma. | 'Python3_10_8' 'Python3_10_8_DL' 'Python3_11_7' 'Python3_11_7_DL' 'Python3_6_5' 'PythonCustomImage' 'R' |
languageExtensionName | O nome da extensão de idioma. | 'PYTHON' 'R' |
LanguageExtensionsList
Nome | Descrição | Valor |
---|---|---|
valor | A lista de extensões de idioma. |
Microsoft.Kusto/clusters
Nome | Descrição | Valor |
---|---|---|
identidade | A identidade do cluster, se configurada. | Identity |
localização | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
nome | O nome do recurso | corda Restrições: Padrão = ^.*$ (obrigatório) |
Propriedades | As propriedades do cluster. | clusterProperties |
Sku | A SKU do cluster. | do AzureSku (obrigatório) |
Tags | Marcas de recurso | Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
Zonas | As zonas de disponibilidade do cluster. | string[] |
OptimizedAutoscale
Nome | Descrição | Valor |
---|---|---|
isEnabled | Um valor booliano que indica se o recurso de dimensionamento automático otimizado está habilitado ou não. | bool (obrigatório) |
máximo | Contagem máxima de instâncias permitidas. | int (obrigatório) |
mínimo | Contagem mínima de instâncias permitidas. | int (obrigatório) |
Versão | A versão do modelo definido, por exemplo, 1. | int (obrigatório) |
TrackedResourceTags
Nome | Descrição | Valor |
---|
TrustedExternalTenant
Nome | Descrição | Valor |
---|---|---|
valor | GUID que representa um locatário externo. | corda |
VirtualNetworkConfiguration
Nome | Descrição | Valor |
---|---|---|
dataManagementPublicIpId | ID do recurso de endereço IP público do serviço do gerenciamento de dados. | cadeia de caracteres (obrigatório) |
enginePublicIpId | ID do recurso de endereço IP público do serviço de mecanismo. | cadeia de caracteres (obrigatório) |
estado | Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado, ele será removido da sub-rede. | 'Desabilitado' 'Habilitado' |
subnetId | A ID do recurso de sub-rede. | cadeia de caracteres (obrigatório) |
Exemplos de início rápido
Os exemplos de início rápido a seguir implantam esse tipo de recurso.
Arquivo Bicep | Descrição |
---|---|
gêmeos digitais do Azure com de conexão de histórico de dados de tempo | Esse modelo cria uma instância dos Gêmeos Digitais do Azure configurada com uma conexão de histórico de dados de série temporal. Para criar uma conexão, outros recursos devem ser criados, como um namespace dos Hubs de Eventos, um hub de eventos, um cluster do Azure Data Explorer e um banco de dados. Os dados são enviados para um hub de eventos que eventualmente encaminha os dados para o cluster do Azure Data Explorer. Os dados são armazenados em uma tabela de banco de dados no cluster |
Criar um observador de banco de dados | Este exemplo cria um observador de banco de dados para o SQL do Azure e configura seu armazenamento de dados, destinos sql e pontos de extremidade privados gerenciados |
implantar o BD do Azure Data Explorer com a conexão do Cosmos DB | Implantar o BD do Azure Data Explorer com a conexão do Cosmos DB. |
implantar o banco de dados do Azure Data Explorer com a conexão da Grade de Eventos | Implantar o banco de dados do Azure Data Explorer com a conexão da Grade de Eventos. |
implantar o banco de dados do Azure Data Explorer com a conexão do Hub de Eventos | Implantar o banco de dados do Azure Data Explorer com a conexão do Hub de Eventos. |
Definição de recurso de modelo do ARM
O tipo de recurso de clusters pode ser implantado com operações direcionadas:
- Grupos de recursos - Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Kusto/clusters, adicione o JSON a seguir ao seu modelo.
{
"type": "Microsoft.Kusto/clusters",
"apiVersion": "2024-04-13",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"acceptedAudiences": [
{
"value": "string"
}
],
"allowedFqdnList": [ "string" ],
"allowedIpRangeList": [ "string" ],
"calloutPolicies": [
{
"calloutType": "string",
"calloutUriRegex": "string",
"outboundAccess": "string"
}
],
"enableAutoStop": "bool",
"enableDiskEncryption": "bool",
"enableDoubleEncryption": "bool",
"enablePurge": "bool",
"enableStreamingIngest": "bool",
"engineType": "string",
"keyVaultProperties": {
"keyName": "string",
"keyVaultUri": "string",
"keyVersion": "string",
"userIdentity": "string"
},
"languageExtensions": {
"value": [
{
"languageExtensionCustomImageName": "string",
"languageExtensionImageName": "string",
"languageExtensionName": "string"
}
]
},
"optimizedAutoscale": {
"isEnabled": "bool",
"maximum": "int",
"minimum": "int",
"version": "int"
},
"publicIPType": "string",
"publicNetworkAccess": "string",
"restrictOutboundNetworkAccess": "string",
"trustedExternalTenants": [
{
"value": "string"
}
],
"virtualClusterGraduationProperties": "string",
"virtualNetworkConfiguration": {
"dataManagementPublicIpId": "string",
"enginePublicIpId": "string",
"state": "string",
"subnetId": "string"
}
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
},
"zones": [ "string" ]
}
Valores de propriedade
AcceptedAudiences
Nome | Descrição | Valor |
---|---|---|
valor | GUID ou URL válida que representa um público-alvo aceito. | corda |
AzureSku
Nome | Descrição | Valor |
---|---|---|
capacidade | O número de instâncias do cluster. | int |
nome | Nome do SKU. | 'Dev(No SLA)_Standard_D11_v2' 'Dev(No SLA)_Standard_E2a_v4' 'Standard_D11_v2' 'Standard_D12_v2' 'Standard_D13_v2' 'Standard_D14_v2' 'Standard_D16d_v5' 'Standard_D32d_v4' 'Standard_D32d_v5' 'Standard_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16ads_v5' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E16as_v5+3TB_PS' 'Standard_E16as_v5+4TB_PS' 'Standard_E16a_v4' 'Standard_E16d_v4' 'Standard_E16d_v5' 'Standard_E16s_v4+3TB_PS' 'Standard_E16s_v4+4TB_PS' 'Standard_E16s_v5+3TB_PS' 'Standard_E16s_v5+4TB_PS' 'Standard_E2ads_v5' 'Standard_E2a_v4' 'Standard_E2d_v4' 'Standard_E2d_v5' 'Standard_E4ads_v5' 'Standard_E4a_v4' 'Standard_E4d_v4' 'Standard_E4d_v5' 'Standard_E64i_v3' 'Standard_E80ids_v4' 'Standard_E8ads_v5' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_E8as_v5+1TB_PS' 'Standard_E8as_v5+2TB_PS' 'Standard_E8a_v4' 'Standard_E8d_v4' 'Standard_E8d_v5' 'Standard_E8s_v4+1TB_PS' 'Standard_E8s_v4+2TB_PS' 'Standard_E8s_v5+1TB_PS' 'Standard_E8s_v5+2TB_PS' 'Standard_EC16ads_v5' 'Standard_EC16as_v5+3TB_PS' 'Standard_EC16as_v5+4TB_PS' 'Standard_EC8ads_v5' 'Standard_EC8as_v5+1TB_PS' 'Standard_EC8as_v5+2TB_PS' 'Standard_L16as_v3' 'Standard_L16s' 'Standard_L16s_v2' 'Standard_L16s_v3' 'Standard_L32as_v3' 'Standard_L32s_v3' 'Standard_L4s' 'Standard_L8as_v3' 'Standard_L8s' 'Standard_L8s_v2' 'Standard_L8s_v3' (obrigatório) |
camada | Camada de SKU. | 'Básico' 'Standard' (obrigatório) |
CalloutPolicy
Nome | Descrição | Valor |
---|---|---|
calloutType | Tipo do serviço de texto explicativo, especificando o tipo de recurso ou serviço externo que está sendo acessado. | 'azure_digital_twins' 'azure_openai' 'cosmosdb' 'external_data' 'genevametrics' 'kusto' 'mysql' 'postgresql' 'sandbox_artifacts' 'sql' 'webapi' |
calloutUriRegex | Expressão regular ou padrão FQDN para o URI de texto explicativo. | corda |
outboundAccess | Indica se o acesso de saída é permitido para o padrão de URI especificado. | 'Permitir' 'Negar' |
ClusterProperties
Nome | Descrição | Valor |
---|---|---|
acceptedAudiences | As audiências aceitas do cluster. | AcceptedAudiences[] |
allowedFqdnList | Lista de FQDNs permitidos (Nome de Domínio Totalmente Qualificado) para saída do Cluster. | string[] |
allowedIpRangeList | A lista de ips no formato cidr permitido para se conectar ao cluster. | string[] |
calloutPolicies | Lista de políticas de texto explicativo para saída do Cluster. | CalloutPolicy [] |
enableAutoStop | Um valor booliano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou nenhuma atividade por muitos dias). | Bool |
enableDiskEncryption | Um valor booliano que indica se os discos do cluster são criptografados. | Bool |
enableDoubleEncryption | Um valor booliano que indica se a criptografia dupla está habilitada. | Bool |
enablePurge | Um valor booliano que indica se as operações de limpeza estão habilitadas. | Bool |
enableStreamingIngest | Um valor booliano que indica se a ingestão de streaming está habilitada. | Bool |
engineType | O tipo de mecanismo | 'V2' 'V3' |
keyVaultProperties | Propriedades KeyVault para a criptografia de cluster. | KeyVaultProperties |
languageExtensions | Lista de extensões de idioma do cluster. | |
optimizedAutoscale | Definição de dimensionamento automático otimizada. | OptimizedAutoscale |
publicIPType | Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6) | 'DualStack' 'IPv4' |
publicNetworkAccess | O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida | 'Desabilitado' 'Habilitado' |
restrictOutboundNetworkAccess | Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado' | 'Desabilitado' 'Habilitado' |
trustedExternalTenants | Os locatários externos do cluster. | TrustedExternalTenant [] |
virtualClusterGraduationProperties | Propriedades de graduação do Cluster Virtual | corda Restrições: Valor confidencial. Passe como um parâmetro seguro. |
virtualNetworkConfiguration | Definição de rede virtual. | |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
Nome | Descrição | Valor |
---|
Identidade
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (obrigatório) |
userAssignedIdentities | A lista de identidades de usuário associadas ao cluster Kusto. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Nome | Descrição | Valor |
---|
KeyVaultProperties
Nome | Descrição | Valor |
---|---|---|
keyName | O nome da chave do cofre de chaves. | corda |
keyVaultUri | O Uri do cofre de chaves. | corda |
keyVersion | A versão da chave do cofre de chaves. | corda |
userIdentity | A identidade atribuída pelo usuário (ID de recurso do ARM) que tem acesso à chave. | corda |
LanguageExtension
Nome | Descrição | Valor |
---|---|---|
languageExtensionCustomImageName | O nome da imagem personalizada da extensão de idioma. | corda |
languageExtensionImageName | O nome da imagem da extensão de idioma. | 'Python3_10_8' 'Python3_10_8_DL' 'Python3_11_7' 'Python3_11_7_DL' 'Python3_6_5' 'PythonCustomImage' 'R' |
languageExtensionName | O nome da extensão de idioma. | 'PYTHON' 'R' |
LanguageExtensionsList
Nome | Descrição | Valor |
---|---|---|
valor | A lista de extensões de idioma. |
Microsoft.Kusto/clusters
Nome | Descrição | Valor |
---|---|---|
apiVersion | A versão da API | '2024-04-13' |
identidade | A identidade do cluster, se configurada. | Identity |
localização | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
nome | O nome do recurso | corda Restrições: Padrão = ^.*$ (obrigatório) |
Propriedades | As propriedades do cluster. | clusterProperties |
Sku | A SKU do cluster. | do AzureSku (obrigatório) |
Tags | Marcas de recurso | Dicionário de nomes e valores de marca. Consulte Marcas em modelos |
tipo | O tipo de recurso | 'Microsoft.Kusto/clusters' |
Zonas | As zonas de disponibilidade do cluster. | string[] |
OptimizedAutoscale
Nome | Descrição | Valor |
---|---|---|
isEnabled | Um valor booliano que indica se o recurso de dimensionamento automático otimizado está habilitado ou não. | bool (obrigatório) |
máximo | Contagem máxima de instâncias permitidas. | int (obrigatório) |
mínimo | Contagem mínima de instâncias permitidas. | int (obrigatório) |
Versão | A versão do modelo definido, por exemplo, 1. | int (obrigatório) |
TrackedResourceTags
Nome | Descrição | Valor |
---|
TrustedExternalTenant
Nome | Descrição | Valor |
---|---|---|
valor | GUID que representa um locatário externo. | corda |
VirtualNetworkConfiguration
Nome | Descrição | Valor |
---|---|---|
dataManagementPublicIpId | ID do recurso de endereço IP público do serviço do gerenciamento de dados. | cadeia de caracteres (obrigatório) |
enginePublicIpId | ID do recurso de endereço IP público do serviço de mecanismo. | cadeia de caracteres (obrigatório) |
estado | Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado, ele será removido da sub-rede. | 'Desabilitado' 'Habilitado' |
subnetId | A ID do recurso de sub-rede. | cadeia de caracteres (obrigatório) |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
Modelo | Descrição |
---|---|
gêmeos digitais do Azure com de conexão de histórico de dados de tempo |
Esse modelo cria uma instância dos Gêmeos Digitais do Azure configurada com uma conexão de histórico de dados de série temporal. Para criar uma conexão, outros recursos devem ser criados, como um namespace dos Hubs de Eventos, um hub de eventos, um cluster do Azure Data Explorer e um banco de dados. Os dados são enviados para um hub de eventos que eventualmente encaminha os dados para o cluster do Azure Data Explorer. Os dados são armazenados em uma tabela de banco de dados no cluster |
Criar um cluster de banco de dados |
Esse modelo permite que você crie um cluster e um banco de dados. |
Criar um observador de banco de dados |
Este exemplo cria um observador de banco de dados para o SQL do Azure e configura seu armazenamento de dados, destinos sql e pontos de extremidade privados gerenciados |
implantar o cluster do Azure Data Explorer em sua VNet |
Esse modelo permite implantar um cluster em sua VNet. |
implantar o BD do Azure Data Explorer com a conexão do Cosmos DB |
Implantar o BD do Azure Data Explorer com a conexão do Cosmos DB. |
implantar o banco de dados do Azure Data Explorer com a conexão da Grade de Eventos |
Implantar o banco de dados do Azure Data Explorer com a conexão da Grade de Eventos. |
implantar o banco de dados do Azure Data Explorer com a conexão do Hub de Eventos |
Implantar o banco de dados do Azure Data Explorer com a conexão do Hub de Eventos. |
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso de clusters pode ser implantado com operações direcionadas:
- grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Formato de recurso
Para criar um recurso Microsoft.Kusto/clusters, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Kusto/clusters@2024-04-13"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
name = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
zones = [
"string"
]
body = jsonencode({
properties = {
acceptedAudiences = [
{
value = "string"
}
]
allowedFqdnList = [
"string"
]
allowedIpRangeList = [
"string"
]
calloutPolicies = [
{
calloutType = "string"
calloutUriRegex = "string"
outboundAccess = "string"
}
]
enableAutoStop = bool
enableDiskEncryption = bool
enableDoubleEncryption = bool
enablePurge = bool
enableStreamingIngest = bool
engineType = "string"
keyVaultProperties = {
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
userIdentity = "string"
}
languageExtensions = {
value = [
{
languageExtensionCustomImageName = "string"
languageExtensionImageName = "string"
languageExtensionName = "string"
}
]
}
optimizedAutoscale = {
isEnabled = bool
maximum = int
minimum = int
version = int
}
publicIPType = "string"
publicNetworkAccess = "string"
restrictOutboundNetworkAccess = "string"
trustedExternalTenants = [
{
value = "string"
}
]
virtualClusterGraduationProperties = "string"
virtualNetworkConfiguration = {
dataManagementPublicIpId = "string"
enginePublicIpId = "string"
state = "string"
subnetId = "string"
}
}
})
}
Valores de propriedade
AcceptedAudiences
Nome | Descrição | Valor |
---|---|---|
valor | GUID ou URL válida que representa um público-alvo aceito. | corda |
AzureSku
Nome | Descrição | Valor |
---|---|---|
capacidade | O número de instâncias do cluster. | int |
nome | Nome do SKU. | 'Dev(No SLA)_Standard_D11_v2' 'Dev(No SLA)_Standard_E2a_v4' 'Standard_D11_v2' 'Standard_D12_v2' 'Standard_D13_v2' 'Standard_D14_v2' 'Standard_D16d_v5' 'Standard_D32d_v4' 'Standard_D32d_v5' 'Standard_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_E16ads_v5' 'Standard_E16as_v4+3TB_PS' 'Standard_E16as_v4+4TB_PS' 'Standard_E16as_v5+3TB_PS' 'Standard_E16as_v5+4TB_PS' 'Standard_E16a_v4' 'Standard_E16d_v4' 'Standard_E16d_v5' 'Standard_E16s_v4+3TB_PS' 'Standard_E16s_v4+4TB_PS' 'Standard_E16s_v5+3TB_PS' 'Standard_E16s_v5+4TB_PS' 'Standard_E2ads_v5' 'Standard_E2a_v4' 'Standard_E2d_v4' 'Standard_E2d_v5' 'Standard_E4ads_v5' 'Standard_E4a_v4' 'Standard_E4d_v4' 'Standard_E4d_v5' 'Standard_E64i_v3' 'Standard_E80ids_v4' 'Standard_E8ads_v5' 'Standard_E8as_v4+1TB_PS' 'Standard_E8as_v4+2TB_PS' 'Standard_E8as_v5+1TB_PS' 'Standard_E8as_v5+2TB_PS' 'Standard_E8a_v4' 'Standard_E8d_v4' 'Standard_E8d_v5' 'Standard_E8s_v4+1TB_PS' 'Standard_E8s_v4+2TB_PS' 'Standard_E8s_v5+1TB_PS' 'Standard_E8s_v5+2TB_PS' 'Standard_EC16ads_v5' 'Standard_EC16as_v5+3TB_PS' 'Standard_EC16as_v5+4TB_PS' 'Standard_EC8ads_v5' 'Standard_EC8as_v5+1TB_PS' 'Standard_EC8as_v5+2TB_PS' 'Standard_L16as_v3' 'Standard_L16s' 'Standard_L16s_v2' 'Standard_L16s_v3' 'Standard_L32as_v3' 'Standard_L32s_v3' 'Standard_L4s' 'Standard_L8as_v3' 'Standard_L8s' 'Standard_L8s_v2' 'Standard_L8s_v3' (obrigatório) |
camada | Camada de SKU. | 'Básico' 'Standard' (obrigatório) |
CalloutPolicy
Nome | Descrição | Valor |
---|---|---|
calloutType | Tipo do serviço de texto explicativo, especificando o tipo de recurso ou serviço externo que está sendo acessado. | 'azure_digital_twins' 'azure_openai' 'cosmosdb' 'external_data' 'genevametrics' 'kusto' 'mysql' 'postgresql' 'sandbox_artifacts' 'sql' 'webapi' |
calloutUriRegex | Expressão regular ou padrão FQDN para o URI de texto explicativo. | corda |
outboundAccess | Indica se o acesso de saída é permitido para o padrão de URI especificado. | 'Permitir' 'Negar' |
ClusterProperties
Nome | Descrição | Valor |
---|---|---|
acceptedAudiences | As audiências aceitas do cluster. | AcceptedAudiences[] |
allowedFqdnList | Lista de FQDNs permitidos (Nome de Domínio Totalmente Qualificado) para saída do Cluster. | string[] |
allowedIpRangeList | A lista de ips no formato cidr permitido para se conectar ao cluster. | string[] |
calloutPolicies | Lista de políticas de texto explicativo para saída do Cluster. | CalloutPolicy [] |
enableAutoStop | Um valor booliano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou nenhuma atividade por muitos dias). | Bool |
enableDiskEncryption | Um valor booliano que indica se os discos do cluster são criptografados. | Bool |
enableDoubleEncryption | Um valor booliano que indica se a criptografia dupla está habilitada. | Bool |
enablePurge | Um valor booliano que indica se as operações de limpeza estão habilitadas. | Bool |
enableStreamingIngest | Um valor booliano que indica se a ingestão de streaming está habilitada. | Bool |
engineType | O tipo de mecanismo | 'V2' 'V3' |
keyVaultProperties | Propriedades KeyVault para a criptografia de cluster. | KeyVaultProperties |
languageExtensions | Lista de extensões de idioma do cluster. | |
optimizedAutoscale | Definição de dimensionamento automático otimizada. | OptimizedAutoscale |
publicIPType | Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6) | 'DualStack' 'IPv4' |
publicNetworkAccess | O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida | 'Desabilitado' 'Habilitado' |
restrictOutboundNetworkAccess | Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado' | 'Desabilitado' 'Habilitado' |
trustedExternalTenants | Os locatários externos do cluster. | TrustedExternalTenant [] |
virtualClusterGraduationProperties | Propriedades de graduação do Cluster Virtual | corda Restrições: Valor confidencial. Passe como um parâmetro seguro. |
virtualNetworkConfiguration | Definição de rede virtual. | |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
Nome | Descrição | Valor |
---|
Identidade
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades. | 'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned' (obrigatório) |
userAssignedIdentities | A lista de identidades de usuário associadas ao cluster Kusto. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
Nome | Descrição | Valor |
---|
KeyVaultProperties
Nome | Descrição | Valor |
---|---|---|
keyName | O nome da chave do cofre de chaves. | corda |
keyVaultUri | O Uri do cofre de chaves. | corda |
keyVersion | A versão da chave do cofre de chaves. | corda |
userIdentity | A identidade atribuída pelo usuário (ID de recurso do ARM) que tem acesso à chave. | corda |
LanguageExtension
Nome | Descrição | Valor |
---|---|---|
languageExtensionCustomImageName | O nome da imagem personalizada da extensão de idioma. | corda |
languageExtensionImageName | O nome da imagem da extensão de idioma. | 'Python3_10_8' 'Python3_10_8_DL' 'Python3_11_7' 'Python3_11_7_DL' 'Python3_6_5' 'PythonCustomImage' 'R' |
languageExtensionName | O nome da extensão de idioma. | 'PYTHON' 'R' |
LanguageExtensionsList
Nome | Descrição | Valor |
---|---|---|
valor | A lista de extensões de idioma. |
Microsoft.Kusto/clusters
Nome | Descrição | Valor |
---|---|---|
identidade | A identidade do cluster, se configurada. | Identity |
localização | A localização geográfica onde o recurso reside | cadeia de caracteres (obrigatório) |
nome | O nome do recurso | corda Restrições: Padrão = ^.*$ (obrigatório) |
Propriedades | As propriedades do cluster. | clusterProperties |
Sku | A SKU do cluster. | do AzureSku (obrigatório) |
Tags | Marcas de recurso | Dicionário de nomes e valores de marca. |
tipo | O tipo de recurso | "Microsoft.Kusto/clusters@2024-04-13" |
Zonas | As zonas de disponibilidade do cluster. | string[] |
OptimizedAutoscale
Nome | Descrição | Valor |
---|---|---|
isEnabled | Um valor booliano que indica se o recurso de dimensionamento automático otimizado está habilitado ou não. | bool (obrigatório) |
máximo | Contagem máxima de instâncias permitidas. | int (obrigatório) |
mínimo | Contagem mínima de instâncias permitidas. | int (obrigatório) |
Versão | A versão do modelo definido, por exemplo, 1. | int (obrigatório) |
TrackedResourceTags
Nome | Descrição | Valor |
---|
TrustedExternalTenant
Nome | Descrição | Valor |
---|---|---|
valor | GUID que representa um locatário externo. | corda |
VirtualNetworkConfiguration
Nome | Descrição | Valor |
---|---|---|
dataManagementPublicIpId | ID do recurso de endereço IP público do serviço do gerenciamento de dados. | cadeia de caracteres (obrigatório) |
enginePublicIpId | ID do recurso de endereço IP público do serviço de mecanismo. | cadeia de caracteres (obrigatório) |
estado | Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado, ele será removido da sub-rede. | 'Desabilitado' 'Habilitado' |
subnetId | A ID do recurso de sub-rede. | cadeia de caracteres (obrigatório) |