Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Definição de recursos do bíceps
O tipo de recurso de clusters pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Kusto/clusters, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Kusto/clusters@2024-04-13' = {
scope: resourceSymbolicName or scope
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
Microsoft.Kusto/clusters
| Designação | Descrição | Valor |
|---|---|---|
| identidade | A identidade do cluster, se configurado. | Identidade |
| localização | A geolocalização onde o recurso vive | string (obrigatório) |
| Designação | O nome do recurso | cadeia de caracteres Restrições: Padrão = ^.*$ (obrigatório) |
| propriedades | As propriedades do cluster. | ClusterProperties |
| âmbito | Use ao criar um recurso em um escopo diferente do escopo de implantação. | Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão . |
| SKU | A SKU do cluster. | AzureSku (obrigatório) |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| Zonas | As zonas de disponibilidade do cluster. | string[] |
AceitoAudiências
| Designação | Descrição | Valor |
|---|---|---|
| valor | GUID ou URL válido representando um público aceito. | cadeia (de caracteres) |
AzureSku
| Designação | Descrição | Valor |
|---|---|---|
| capacidade | O número de instâncias do cluster. | Int |
| Designação | Nome do SKU. | 'Dev(Sem SLA)_Standard_D11_v2' 'Dev(Sem 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) |
| escalão | Nível de SKU. | 'Básico' 'Standard' (obrigatório) |
CalloutPolicy
| Designação | 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' 'Genevametria' 'Kusto' 'MySQL' 'PostgreSQL' 'sandbox_artifacts' 'SQL' 'Webapi' |
| calloutUriRegex | Expressão regular ou padrão FQDN para o URI do texto explicativo. | cadeia (de caracteres) |
| Acesso de saída | Indica se o acesso de saída é permitido para o padrão de URI especificado. | 'Permitir' 'Negar' |
ClusterProperties
| Designação | Descrição | Valor |
|---|---|---|
| aceitoAudiências | Os públicos aceites pelo cluster. | AceitoAudiências[] |
| allowedFqdnList | Lista de FQDNs (Nome de Domínio Totalmente Qualificado) permitidos para saída do Cluster. | string[] |
| allowedIpRangeList | A lista de ips no formato de CIDR permitido para se conectar ao cluster. | string[] |
| calloutPolíticas | Lista de políticas de texto explicativo para saída do Cluster. | CalloutPolicy[] |
| habilitarAutoStop | Um valor booleano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou à ausência de atividade por muitos dias). | Bool |
| enableDiskEncryption | Um valor booleano que indica se os discos do cluster estão criptografados. | Bool |
| enableDoubleEncryption | Um valor booleano que indica se a criptografia dupla está habilitada. | Bool |
| enablePurge | Um valor booleano que indica se as operações de limpeza estão habilitadas. | Bool |
| enableStreamingIngest | Um valor booleano que indica se a ingestão de streaming está habilitada. | Bool |
| Tipo de motor | O tipo de motor | «V2» 'V3' |
| keyVaultPropriedades | Propriedades do KeyVault para a criptografia de cluster. | KeyVaultProperties |
| languageExtensions | Lista das extensões de idioma do cluster. | LanguageExtensionsList |
| otimizadoAutoscale otimizado | Definição de escala automática otimizada. | OptimizedAutoscale |
| publicIPTipe | Indica qual tipo de IP público criar - IPv4 (padrão) ou DualStack (IPv4 e IPv6) | 'DualStack' 'IPv4' |
| acesso à rede pública | O acesso à rede pública ao cluster está habilitado por padrão. Quando desabilitada, somente a conexão de ponto de extremidade privado com o cluster é permitida | 'Desativado' 'Habilitado' |
| restrictOutboundNetworkAccess | Restringir ou não o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado' | 'Desativado' 'Habilitado' |
| trustedExternalTenants | Os locatários externos do cluster. | TrustedExternalTenant [] |
| virtualClusterGraduationProperties | Propriedades de graduação do Virtual Cluster | cadeia de caracteres Restrições: Valor sensível. Passe como um parâmetro seguro. |
| virtualNetworkConfiguration | Definição de rede virtual. | VirtualNetworkConfiguration |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Designação | Descrição | Valor |
|---|
Identidade
IdentityUserAssignedIdentities
| Designação | Descrição | Valor |
|---|
KeyVaultProperties
| Designação | Descrição | Valor |
|---|---|---|
| Nome da chave | O nome da chave do cofre da chave. | cadeia (de caracteres) |
| keyVaultUri | O Uri do cofre de chaves. | cadeia (de caracteres) |
| keyVersion [en] | A versão da chave do cofre da chave. | cadeia (de caracteres) |
| userIdentity | A identidade atribuída ao usuário (ID de recurso ARM) que tem acesso à chave. | cadeia (de caracteres) |
LanguageExtension
| Designação | Descrição | Valor |
|---|---|---|
| languageExtensionCustomImageName | O nome da imagem personalizada da extensão de idioma. | cadeia (de caracteres) |
| 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
| Designação | Descrição | Valor |
|---|---|---|
| valor | A lista de extensões de idioma. | LanguageExtension[] |
OptimizedAutoscale
| Designação | Descrição | Valor |
|---|---|---|
| estáAtivado | Um valor booleano 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 | As instâncias mínimas permitidas contam. | int (obrigatório) |
| versão | A versão do modelo definida, por exemplo 1. | int (obrigatório) |
TrackedResourceTags
| Designação | Descrição | Valor |
|---|
TrustedExternalTenant
| Designação | Descrição | Valor |
|---|---|---|
| valor | GUID representando um locatário externo. | cadeia (de caracteres) |
VirtualNetworkConfiguration
| Designação | Descrição | Valor |
|---|---|---|
| dataManagementPublicIpId | ID do recurso de endereço IP público do serviço de gerenciamento de dados. | string (obrigatório) |
| enginePublicIpId | ID do recurso de endereço IP público do serviço de mecanismo. | string (obrigatório) |
| Estado | Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado será removido da sub-rede. | 'Desativado' 'Habilitado' |
| subnetId | A id do recurso da sub-rede. | string (obrigatório) |
Exemplos de uso
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| de cluster do Azure Data Explorer (Kusto) | Módulo de Recursos AVM para cluster do Azure Data Explorer (Kusto) |
Exemplos de início rápido do Azure
Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.
| Arquivo Bicep | Descrição |
|---|---|
| Gêmeos Digitais do Azure com Conexão de Histórico de Dados de Tempo | Este modelo cria uma instância do Azure Digital Twins 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 de 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 inspetor 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 Banco de Dados do Azure Data Explorer com o de conexão do Cosmos DB | Implante o Banco de Dados do Azure Data Explorer com conexão do Cosmos DB. |
| Implantar o banco de dados do Azure Data Explorer com conexão de Grade de Eventos | Implante o banco de dados do Azure Data Explorer com conexão de Grade de Eventos. |
| Implantar o banco de dados do Azure Data Explorer com o de conexão do Hub de Eventos | Implante o banco de dados do Azure Data Explorer com conexão do Hub de Eventos. |
| hub FinOps | Este modelo cria uma nova instância de hub FinOps, incluindo Data Explorer, armazenamento Data Lake e Data Factory. |
Definição de recurso de modelo ARM
O tipo de recurso de clusters pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Kusto/clusters, adicione o seguinte JSON 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
Microsoft.Kusto/clusters
| Designação | Descrição | Valor |
|---|---|---|
| Versão da API | A versão api | '2024-04-13' |
| identidade | A identidade do cluster, se configurado. | Identidade |
| localização | A geolocalização onde o recurso vive | string (obrigatório) |
| Designação | O nome do recurso | cadeia de caracteres Restrições: Padrão = ^.*$ (obrigatório) |
| propriedades | As propriedades do cluster. | ClusterProperties |
| SKU | A SKU do cluster. | AzureSku (obrigatório) |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
| tipo | O tipo de recurso | 'Microsoft.Kusto/clusters' |
| Zonas | As zonas de disponibilidade do cluster. | string[] |
AceitoAudiências
| Designação | Descrição | Valor |
|---|---|---|
| valor | GUID ou URL válido representando um público aceito. | cadeia (de caracteres) |
AzureSku
| Designação | Descrição | Valor |
|---|---|---|
| capacidade | O número de instâncias do cluster. | Int |
| Designação | Nome do SKU. | 'Dev(Sem SLA)_Standard_D11_v2' 'Dev(Sem 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) |
| escalão | Nível de SKU. | 'Básico' 'Standard' (obrigatório) |
CalloutPolicy
| Designação | 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' 'Genevametria' 'Kusto' 'MySQL' 'PostgreSQL' 'sandbox_artifacts' 'SQL' 'Webapi' |
| calloutUriRegex | Expressão regular ou padrão FQDN para o URI do texto explicativo. | cadeia (de caracteres) |
| Acesso de saída | Indica se o acesso de saída é permitido para o padrão de URI especificado. | 'Permitir' 'Negar' |
ClusterProperties
| Designação | Descrição | Valor |
|---|---|---|
| aceitoAudiências | Os públicos aceites pelo cluster. | AceitoAudiências[] |
| allowedFqdnList | Lista de FQDNs (Nome de Domínio Totalmente Qualificado) permitidos para saída do Cluster. | string[] |
| allowedIpRangeList | A lista de ips no formato de CIDR permitido para se conectar ao cluster. | string[] |
| calloutPolíticas | Lista de políticas de texto explicativo para saída do Cluster. | CalloutPolicy[] |
| habilitarAutoStop | Um valor booleano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou à ausência de atividade por muitos dias). | Bool |
| enableDiskEncryption | Um valor booleano que indica se os discos do cluster estão criptografados. | Bool |
| enableDoubleEncryption | Um valor booleano que indica se a criptografia dupla está habilitada. | Bool |
| enablePurge | Um valor booleano que indica se as operações de limpeza estão habilitadas. | Bool |
| enableStreamingIngest | Um valor booleano que indica se a ingestão de streaming está habilitada. | Bool |
| Tipo de motor | O tipo de motor | «V2» 'V3' |
| keyVaultPropriedades | Propriedades do KeyVault para a criptografia de cluster. | KeyVaultProperties |
| languageExtensions | Lista das extensões de idioma do cluster. | LanguageExtensionsList |
| otimizadoAutoscale otimizado | Definição de escala automática otimizada. | OptimizedAutoscale |
| publicIPTipe | Indica qual tipo de IP público criar - IPv4 (padrão) ou DualStack (IPv4 e IPv6) | 'DualStack' 'IPv4' |
| acesso à rede pública | O acesso à rede pública ao cluster está habilitado por padrão. Quando desabilitada, somente a conexão de ponto de extremidade privado com o cluster é permitida | 'Desativado' 'Habilitado' |
| restrictOutboundNetworkAccess | Restringir ou não o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado' | 'Desativado' 'Habilitado' |
| trustedExternalTenants | Os locatários externos do cluster. | TrustedExternalTenant [] |
| virtualClusterGraduationProperties | Propriedades de graduação do Virtual Cluster | cadeia de caracteres Restrições: Valor sensível. Passe como um parâmetro seguro. |
| virtualNetworkConfiguration | Definição de rede virtual. | VirtualNetworkConfiguration |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Designação | Descrição | Valor |
|---|
Identidade
IdentityUserAssignedIdentities
| Designação | Descrição | Valor |
|---|
KeyVaultProperties
| Designação | Descrição | Valor |
|---|---|---|
| Nome da chave | O nome da chave do cofre da chave. | cadeia (de caracteres) |
| keyVaultUri | O Uri do cofre de chaves. | cadeia (de caracteres) |
| keyVersion [en] | A versão da chave do cofre da chave. | cadeia (de caracteres) |
| userIdentity | A identidade atribuída ao usuário (ID de recurso ARM) que tem acesso à chave. | cadeia (de caracteres) |
LanguageExtension
| Designação | Descrição | Valor |
|---|---|---|
| languageExtensionCustomImageName | O nome da imagem personalizada da extensão de idioma. | cadeia (de caracteres) |
| 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
| Designação | Descrição | Valor |
|---|---|---|
| valor | A lista de extensões de idioma. | LanguageExtension[] |
OptimizedAutoscale
| Designação | Descrição | Valor |
|---|---|---|
| estáAtivado | Um valor booleano 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 | As instâncias mínimas permitidas contam. | int (obrigatório) |
| versão | A versão do modelo definida, por exemplo 1. | int (obrigatório) |
TrackedResourceTags
| Designação | Descrição | Valor |
|---|
TrustedExternalTenant
| Designação | Descrição | Valor |
|---|---|---|
| valor | GUID representando um locatário externo. | cadeia (de caracteres) |
VirtualNetworkConfiguration
| Designação | Descrição | Valor |
|---|---|---|
| dataManagementPublicIpId | ID do recurso de endereço IP público do serviço de gerenciamento de dados. | string (obrigatório) |
| enginePublicIpId | ID do recurso de endereço IP público do serviço de mecanismo. | string (obrigatório) |
| Estado | Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado será removido da sub-rede. | 'Desativado' 'Habilitado' |
| subnetId | A id do recurso da sub-rede. | string (obrigatório) |
Exemplos de uso
Modelos de início rápido do Azure
Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.
| Modelo | Descrição |
|---|---|
|
Gêmeos Digitais do Azure com Conexão de Histórico de Dados de Tempo |
Este modelo cria uma instância do Azure Digital Twins 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 de 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 um banco de dados |
Este modelo permite criar um cluster e um banco de dados. |
|
Criar um observador de banco de dados |
Este exemplo cria um inspetor 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 seu de rede virtual |
Este modelo permite implantar um cluster em sua rede virtual. |
|
Implantar o Banco de Dados do Azure Data Explorer com o de conexão do Cosmos DB |
Implante o Banco de Dados do Azure Data Explorer com conexão do Cosmos DB. |
|
Implantar o banco de dados do Azure Data Explorer com conexão de Grade de Eventos |
Implante o banco de dados do Azure Data Explorer com conexão de Grade de Eventos. |
|
Implantar o banco de dados do Azure Data Explorer com o de conexão do Hub de Eventos |
Implante o banco de dados do Azure Data Explorer com conexão do Hub de Eventos. |
|
hub FinOps |
Este modelo cria uma nova instância de hub FinOps, incluindo Data Explorer, armazenamento Data Lake e Data Factory. |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso de clusters pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Kusto/clusters, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Kusto/clusters@2024-04-13"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
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"
}
zones = [
"string"
]
}
}
Valores de propriedade
Microsoft.Kusto/clusters
| Designação | Descrição | Valor |
|---|---|---|
| identidade | A identidade do cluster, se configurado. | Identidade |
| localização | A geolocalização onde o recurso vive | string (obrigatório) |
| Designação | O nome do recurso | cadeia de caracteres Restrições: Padrão = ^.*$ (obrigatório) |
| parent_id | A ID do recurso ao qual aplicar esse recurso de extensão. | string (obrigatório) |
| propriedades | As propriedades do cluster. | ClusterProperties |
| SKU | A SKU do cluster. | AzureSku (obrigatório) |
| Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. |
| tipo | O tipo de recurso | "Microsoft.Kusto/clusters@2024-04-13" |
| Zonas | As zonas de disponibilidade do cluster. | string[] |
AceitoAudiências
| Designação | Descrição | Valor |
|---|---|---|
| valor | GUID ou URL válido representando um público aceito. | cadeia (de caracteres) |
AzureSku
| Designação | Descrição | Valor |
|---|---|---|
| capacidade | O número de instâncias do cluster. | Int |
| Designação | Nome do SKU. | 'Dev(Sem SLA)_Standard_D11_v2' 'Dev(Sem 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) |
| escalão | Nível de SKU. | 'Básico' 'Standard' (obrigatório) |
CalloutPolicy
| Designação | 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' 'Genevametria' 'Kusto' 'MySQL' 'PostgreSQL' 'sandbox_artifacts' 'SQL' 'Webapi' |
| calloutUriRegex | Expressão regular ou padrão FQDN para o URI do texto explicativo. | cadeia (de caracteres) |
| Acesso de saída | Indica se o acesso de saída é permitido para o padrão de URI especificado. | 'Permitir' 'Negar' |
ClusterProperties
| Designação | Descrição | Valor |
|---|---|---|
| aceitoAudiências | Os públicos aceites pelo cluster. | AceitoAudiências[] |
| allowedFqdnList | Lista de FQDNs (Nome de Domínio Totalmente Qualificado) permitidos para saída do Cluster. | string[] |
| allowedIpRangeList | A lista de ips no formato de CIDR permitido para se conectar ao cluster. | string[] |
| calloutPolíticas | Lista de políticas de texto explicativo para saída do Cluster. | CalloutPolicy[] |
| habilitarAutoStop | Um valor booleano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou à ausência de atividade por muitos dias). | Bool |
| enableDiskEncryption | Um valor booleano que indica se os discos do cluster estão criptografados. | Bool |
| enableDoubleEncryption | Um valor booleano que indica se a criptografia dupla está habilitada. | Bool |
| enablePurge | Um valor booleano que indica se as operações de limpeza estão habilitadas. | Bool |
| enableStreamingIngest | Um valor booleano que indica se a ingestão de streaming está habilitada. | Bool |
| Tipo de motor | O tipo de motor | «V2» 'V3' |
| keyVaultPropriedades | Propriedades do KeyVault para a criptografia de cluster. | KeyVaultProperties |
| languageExtensions | Lista das extensões de idioma do cluster. | LanguageExtensionsList |
| otimizadoAutoscale otimizado | Definição de escala automática otimizada. | OptimizedAutoscale |
| publicIPTipe | Indica qual tipo de IP público criar - IPv4 (padrão) ou DualStack (IPv4 e IPv6) | 'DualStack' 'IPv4' |
| acesso à rede pública | O acesso à rede pública ao cluster está habilitado por padrão. Quando desabilitada, somente a conexão de ponto de extremidade privado com o cluster é permitida | 'Desativado' 'Habilitado' |
| restrictOutboundNetworkAccess | Restringir ou não o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Ativado' ou 'Desativado' | 'Desativado' 'Habilitado' |
| trustedExternalTenants | Os locatários externos do cluster. | TrustedExternalTenant [] |
| virtualClusterGraduationProperties | Propriedades de graduação do Virtual Cluster | cadeia de caracteres Restrições: Valor sensível. Passe como um parâmetro seguro. |
| virtualNetworkConfiguration | Definição de rede virtual. | VirtualNetworkConfiguration |
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Designação | Descrição | Valor |
|---|
Identidade
IdentityUserAssignedIdentities
| Designação | Descrição | Valor |
|---|
KeyVaultProperties
| Designação | Descrição | Valor |
|---|---|---|
| Nome da chave | O nome da chave do cofre da chave. | cadeia (de caracteres) |
| keyVaultUri | O Uri do cofre de chaves. | cadeia (de caracteres) |
| keyVersion [en] | A versão da chave do cofre da chave. | cadeia (de caracteres) |
| userIdentity | A identidade atribuída ao usuário (ID de recurso ARM) que tem acesso à chave. | cadeia (de caracteres) |
LanguageExtension
| Designação | Descrição | Valor |
|---|---|---|
| languageExtensionCustomImageName | O nome da imagem personalizada da extensão de idioma. | cadeia (de caracteres) |
| 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
| Designação | Descrição | Valor |
|---|---|---|
| valor | A lista de extensões de idioma. | LanguageExtension[] |
OptimizedAutoscale
| Designação | Descrição | Valor |
|---|---|---|
| estáAtivado | Um valor booleano 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 | As instâncias mínimas permitidas contam. | int (obrigatório) |
| versão | A versão do modelo definida, por exemplo 1. | int (obrigatório) |
TrackedResourceTags
| Designação | Descrição | Valor |
|---|
TrustedExternalTenant
| Designação | Descrição | Valor |
|---|---|---|
| valor | GUID representando um locatário externo. | cadeia (de caracteres) |
VirtualNetworkConfiguration
| Designação | Descrição | Valor |
|---|---|---|
| dataManagementPublicIpId | ID do recurso de endereço IP público do serviço de gerenciamento de dados. | string (obrigatório) |
| enginePublicIpId | ID do recurso de endereço IP público do serviço de mecanismo. | string (obrigatório) |
| Estado | Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado será removido da sub-rede. | 'Desativado' 'Habilitado' |
| subnetId | A id do recurso da sub-rede. | string (obrigatório) |
Exemplos de uso
Amostras Terraform
Um exemplo básico de implantação do Cluster Kusto (também conhecido como Azure Data Explorer).
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
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 = ["*"]
}
Um exemplo básico de implantação do Cluster Kusto (também conhecido como Azure Data Explorer).
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westeurope"
}
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 = ["*"]
}
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| Clusters Kusto | Módulo de recursos AVM para clusters Kusto |