Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bicep-Ressourcendefinition
Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Kusto/Cluster-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.
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'
]
}
Eigenschaftswerte
Microsoft.Kusto/cluster
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Die Identität des Clusters, falls konfiguriert. | Identität |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^.*$ (erforderlich) |
| Eigenschaften | Die Clustereigenschaften. | ClusterProperties- |
| scope | Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. | Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden. |
| Sku | Die SKU des Clusters. | AzureSku- (erforderlich) |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Zonen | Die Verfügbarkeitszonen des Clusters. | Zeichenfolge[] |
AkzeptiertAudiences
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | GUID oder gültige URL, die eine akzeptierte Zielgruppe darstellt. | Schnur |
AzureSku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Die Anzahl der Instanzen des Clusters. | Int |
| Name | SKU-Name. | "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" (erforderlich) |
| Rang | SKU-Ebene. | "Einfach" "Standard" (erforderlich) |
CalloutPolicy (Englisch)
| Name | Beschreibung | Wert |
|---|---|---|
| LegendeTyp | Typ des Popupdiensts, der die Art der externen Ressource oder des Diensts angibt, auf die zugegriffen wird. | "azure_digital_twins" "azure_openai" 'kosmosdb' "external_data" "genevametrics" "kusto" "mysql" "postgresql" "sandbox_artifacts" 'SQL' 'WebAPI' |
| calloutUriRegex | Regulärer Ausdruck oder FQDN-Muster für den Popup-URI. | Schnur |
| ausgehenDer Zugang | Gibt an, ob ausgehender Zugriff für das angegebene URI-Muster zulässig ist. | "Zulassen" "Ablehnen" |
Cluster-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| akzeptiertAudiences | Die akzeptierten Zielgruppen des Clusters. | Akzeptierte Zielgruppen[] |
| allowedFqdnList | Liste der zulässigen FQDNs(Vollqualifizierter Domänenname) für den Ausgang von Cluster. | Zeichenfolge[] |
| allowedIpRangeList | Die Liste der IP-Adressen im Format von CIDR, die eine Verbindung mit dem Cluster herstellen dürfen. | Zeichenfolge[] |
| calloutPolicies | Liste der Legendenrichtlinien für den Ausgang von Cluster. | CalloutPolicy-[] |
| aktivierenAutoStop aktivieren | Ein boolescher Wert, der angibt, ob der Cluster automatisch beendet werden kann (aufgrund fehlender Daten oder einer Aktivität für viele Tage). | Bool |
| enableDiskEncryption | Ein boolescher Wert, der angibt, ob die Datenträger des Clusters verschlüsselt sind. | Bool |
| enableDoubleEncryption | Ein boolescher Wert, der angibt, ob die doppelte Verschlüsselung aktiviert ist. | Bool |
| enableBereinigen | Ein boolescher Wert, der angibt, ob die Bereinigungsvorgänge aktiviert sind. | Bool |
| enableStreamingIngest | Ein boolescher Wert, der angibt, ob das Streaminggest aktiviert ist. | Bool |
| MotorTyp | Der Modultyp | 'V2' "V3" |
| keyVault-Eigenschaften | KeyVault-Eigenschaften für die Clusterverschlüsselung. | KeyVault-Eigenschaften |
| languageErweiterungen | Liste der Spracherweiterungen des Clusters. | LanguageExtensionsList- |
| optimiertAutomatische Skalierung | Optimierte Definition der automatischen Skalierung. | OptimizedAutoscale- |
| publicIPTyp | Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6) | "DualStack" "IPv4" |
| Öffentlicher Netzwerkzugang | Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig. | "Deaktiviert" "Aktiviert" |
| restrictOutboundNetworkAccess | Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. | "Deaktiviert" "Aktiviert" |
| trustedExternalTenants | Die externen Mandanten des Clusters. | TrustedExternalTenant[] |
| virtualClusterGraduationEigenschaften | Virtuelle Cluster Graduierungseigenschaften | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| virtualNetworkKonfiguration | Definition des virtuellen Netzwerks. | VirtualNetworkConfiguration- |
KomponentenSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Name | Beschreibung | Wert |
|---|
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten. | "Keine" 'SystemZugewiesen' "SystemAssigned, UserAssigned" "UserAssigned" (erforderlich) |
| vom Benutzer zugewiesene Identitäten | Die Liste der Benutzeridentitäten, die dem Kusto-Cluster zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
KeyVault-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| Schlüsselname | Der Name des Schlüsseltresorschlüssels. | Schnur |
| keyVaultUri | Der URI des Schlüsseltresors. | Schnur |
| Schlüsselversion | Die Version des Schlüsseltresorschlüssels. | Schnur |
| BenutzerIdentität | Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. | Schnur |
LanguageExtension
| Name | Beschreibung | Wert |
|---|---|---|
| languageExtensionCustomImageName | Der benutzerdefinierte Bildname der Spracherweiterung. | Schnur |
| languageExtensionImageName | Der Bildname der Spracherweiterung. | "Python3_10_8" "Python3_10_8_DL" "Python3_11_7" "Python3_11_7_DL" "Python3_6_5" 'PythonCustomImage' 'R' |
| languageErweiterungName | Der Name der Spracherweiterung. | "PYTHON" 'R' |
LanguageExtensionsList
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | Die Liste der Spracherweiterungen. | Spracherweiterung[] |
OptimiertAutomatische Skalierung
| Name | Beschreibung | Wert |
|---|---|---|
| isEnabled (Aktiviert) | Ein boolescher Wert, der angibt, ob das optimierte Autoskalen-Feature aktiviert ist oder nicht. | bool (erforderlich) |
| Maximum | Maximale Anzahl zulässiger Instanzen. | int (erforderlich) |
| Minimum | Anzahl der zulässigen Mindestinstanzen. | int (erforderlich) |
| Version | Die Version der definierten Vorlage, z. B. 1. | int (erforderlich) |
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
TrustedExternalTenant
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | GUID, die einen externen Mandanten darstellt. | Schnur |
VirtualNetworkConfiguration (VirtualNetworkConfiguration)
| Name | Beschreibung | Wert |
|---|---|---|
| dataManagementPublicIpId | Die Dienst-ID der öffentlichen IP-Adresse der Datenverwaltung. | Zeichenfolge (erforderlich) |
| enginePublicIpId | Die öffentliche IP-Adressressourcen-ID des Moduldiensts. | Zeichenfolge (erforderlich) |
| Zustand | Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt. | "Deaktiviert" "Aktiviert" |
| subnetz-ID | Die Subnetzressourcen-ID. | Zeichenfolge (erforderlich) |
Verwendungsbeispiele
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Modul | Beschreibung |
|---|---|
| Azure Data Explorer (Kusto)-Cluster- | AVM-Ressourcenmodul für Azure Data Explorer (Kusto)-Cluster |
Azure-Schnellstartbeispiele
Die folgenden Azure-Schnellstartvorlagen Bicep-Beispiele für die Bereitstellung dieses Ressourcentyps enthalten.
| Bicep-Datei | Beschreibung |
|---|---|
| Azure Digital Twins mit Zeitdatenverlaufsverbindung | Diese Vorlage erstellt eine Azure Digital Twins-Instanz, die mit einer Zeitreihen-Datenverlaufsverbindung konfiguriert ist. Um eine Verbindung zu erstellen, müssen andere Ressourcen erstellt werden, z. B. einen Event Hubs-Namespace, einen Event Hub, einen Azure Data Explorer-Cluster und eine Datenbank. Daten werden an einen Event Hub gesendet, der die Daten schließlich an den Azure Data Explorer-Cluster weiterleitet. Daten werden in einer Datenbanktabelle im Cluster gespeichert. |
| Erstellen einer Datenbanküberwachungs- | In diesem Beispiel wird eine Datenbanküberwachung für Azure SQL erstellt und deren Datenspeicher, SQL-Ziele und verwaltete private Endpunkte konfiguriert. |
| Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung | Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung. |
| Bereitstellen von Azure Data Explorer db mit Ereignisrasterverbindung | Bereitstellen von Azure Data Explorer db mit Event Grid-Verbindung. |
| Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung | Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung. |
| FinOps Hub- | Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Explorer, Data Lake Storage und Data Factory. |
ARM-Vorlagenressourcendefinition
Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Kusto/cluster-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden JSON-Code hinzu.
{
"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" ]
}
Eigenschaftswerte
Microsoft.Kusto/cluster
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion (Englisch) | Die API-Version | '2024-04-13' |
| Identität | Die Identität des Clusters, falls konfiguriert. | Identität |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^.*$ (erforderlich) |
| Eigenschaften | Die Clustereigenschaften. | ClusterProperties- |
| Sku | Die SKU des Clusters. | AzureSku- (erforderlich) |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Art | Der Ressourcentyp | "Microsoft.Kusto/clusters" |
| Zonen | Die Verfügbarkeitszonen des Clusters. | Zeichenfolge[] |
AkzeptiertAudiences
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | GUID oder gültige URL, die eine akzeptierte Zielgruppe darstellt. | Schnur |
AzureSku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Die Anzahl der Instanzen des Clusters. | Int |
| Name | SKU-Name. | "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" (erforderlich) |
| Rang | SKU-Ebene. | "Einfach" "Standard" (erforderlich) |
CalloutPolicy (Englisch)
| Name | Beschreibung | Wert |
|---|---|---|
| LegendeTyp | Typ des Popupdiensts, der die Art der externen Ressource oder des Diensts angibt, auf die zugegriffen wird. | "azure_digital_twins" "azure_openai" 'kosmosdb' "external_data" "genevametrics" "kusto" "mysql" "postgresql" "sandbox_artifacts" 'SQL' 'WebAPI' |
| calloutUriRegex | Regulärer Ausdruck oder FQDN-Muster für den Popup-URI. | Schnur |
| ausgehenDer Zugang | Gibt an, ob ausgehender Zugriff für das angegebene URI-Muster zulässig ist. | "Zulassen" "Ablehnen" |
Cluster-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| akzeptiertAudiences | Die akzeptierten Zielgruppen des Clusters. | Akzeptierte Zielgruppen[] |
| allowedFqdnList | Liste der zulässigen FQDNs(Vollqualifizierter Domänenname) für den Ausgang von Cluster. | Zeichenfolge[] |
| allowedIpRangeList | Die Liste der IP-Adressen im Format von CIDR, die eine Verbindung mit dem Cluster herstellen dürfen. | Zeichenfolge[] |
| calloutPolicies | Liste der Legendenrichtlinien für den Ausgang von Cluster. | CalloutPolicy-[] |
| aktivierenAutoStop aktivieren | Ein boolescher Wert, der angibt, ob der Cluster automatisch beendet werden kann (aufgrund fehlender Daten oder einer Aktivität für viele Tage). | Bool |
| enableDiskEncryption | Ein boolescher Wert, der angibt, ob die Datenträger des Clusters verschlüsselt sind. | Bool |
| enableDoubleEncryption | Ein boolescher Wert, der angibt, ob die doppelte Verschlüsselung aktiviert ist. | Bool |
| enableBereinigen | Ein boolescher Wert, der angibt, ob die Bereinigungsvorgänge aktiviert sind. | Bool |
| enableStreamingIngest | Ein boolescher Wert, der angibt, ob das Streaminggest aktiviert ist. | Bool |
| MotorTyp | Der Modultyp | 'V2' "V3" |
| keyVault-Eigenschaften | KeyVault-Eigenschaften für die Clusterverschlüsselung. | KeyVault-Eigenschaften |
| languageErweiterungen | Liste der Spracherweiterungen des Clusters. | LanguageExtensionsList- |
| optimiertAutomatische Skalierung | Optimierte Definition der automatischen Skalierung. | OptimizedAutoscale- |
| publicIPTyp | Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6) | "DualStack" "IPv4" |
| Öffentlicher Netzwerkzugang | Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig. | "Deaktiviert" "Aktiviert" |
| restrictOutboundNetworkAccess | Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. | "Deaktiviert" "Aktiviert" |
| trustedExternalTenants | Die externen Mandanten des Clusters. | TrustedExternalTenant[] |
| virtualClusterGraduationEigenschaften | Virtuelle Cluster Graduierungseigenschaften | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| virtualNetworkKonfiguration | Definition des virtuellen Netzwerks. | VirtualNetworkConfiguration- |
KomponentenSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Name | Beschreibung | Wert |
|---|
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten. | "Keine" 'SystemZugewiesen' "SystemAssigned, UserAssigned" "UserAssigned" (erforderlich) |
| vom Benutzer zugewiesene Identitäten | Die Liste der Benutzeridentitäten, die dem Kusto-Cluster zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
KeyVault-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| Schlüsselname | Der Name des Schlüsseltresorschlüssels. | Schnur |
| keyVaultUri | Der URI des Schlüsseltresors. | Schnur |
| Schlüsselversion | Die Version des Schlüsseltresorschlüssels. | Schnur |
| BenutzerIdentität | Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. | Schnur |
LanguageExtension
| Name | Beschreibung | Wert |
|---|---|---|
| languageExtensionCustomImageName | Der benutzerdefinierte Bildname der Spracherweiterung. | Schnur |
| languageExtensionImageName | Der Bildname der Spracherweiterung. | "Python3_10_8" "Python3_10_8_DL" "Python3_11_7" "Python3_11_7_DL" "Python3_6_5" 'PythonCustomImage' 'R' |
| languageErweiterungName | Der Name der Spracherweiterung. | "PYTHON" 'R' |
LanguageExtensionsList
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | Die Liste der Spracherweiterungen. | Spracherweiterung[] |
OptimiertAutomatische Skalierung
| Name | Beschreibung | Wert |
|---|---|---|
| isEnabled (Aktiviert) | Ein boolescher Wert, der angibt, ob das optimierte Autoskalen-Feature aktiviert ist oder nicht. | bool (erforderlich) |
| Maximum | Maximale Anzahl zulässiger Instanzen. | int (erforderlich) |
| Minimum | Anzahl der zulässigen Mindestinstanzen. | int (erforderlich) |
| Version | Die Version der definierten Vorlage, z. B. 1. | int (erforderlich) |
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
TrustedExternalTenant
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | GUID, die einen externen Mandanten darstellt. | Schnur |
VirtualNetworkConfiguration (VirtualNetworkConfiguration)
| Name | Beschreibung | Wert |
|---|---|---|
| dataManagementPublicIpId | Die Dienst-ID der öffentlichen IP-Adresse der Datenverwaltung. | Zeichenfolge (erforderlich) |
| enginePublicIpId | Die öffentliche IP-Adressressourcen-ID des Moduldiensts. | Zeichenfolge (erforderlich) |
| Zustand | Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt. | "Deaktiviert" "Aktiviert" |
| subnetz-ID | Die Subnetzressourcen-ID. | Zeichenfolge (erforderlich) |
Verwendungsbeispiele
Azure-Schnellstartvorlagen
Die folgenden Azure-Schnellstartvorlagen diesen Ressourcentyp bereitstellen.
| Schablone | Beschreibung |
|---|---|
|
Azure Digital Twins mit Zeitdatenverlaufsverbindung |
Diese Vorlage erstellt eine Azure Digital Twins-Instanz, die mit einer Zeitreihen-Datenverlaufsverbindung konfiguriert ist. Um eine Verbindung zu erstellen, müssen andere Ressourcen erstellt werden, z. B. einen Event Hubs-Namespace, einen Event Hub, einen Azure Data Explorer-Cluster und eine Datenbank. Daten werden an einen Event Hub gesendet, der die Daten schließlich an den Azure Data Explorer-Cluster weiterleitet. Daten werden in einer Datenbanktabelle im Cluster gespeichert. |
|
Erstellen eines Clusters einer Datenbank |
Mit dieser Vorlage können Sie einen Cluster und eine Datenbank erstellen. |
|
Erstellen einer Datenbanküberwachungs- |
In diesem Beispiel wird eine Datenbanküberwachung für Azure SQL erstellt und deren Datenspeicher, SQL-Ziele und verwaltete private Endpunkte konfiguriert. |
|
Bereitstellen des Azure Data Explorer-Clusters in Ihrem VNet- |
Mit dieser Vorlage können Sie einen Cluster in Ihrem VNet bereitstellen. |
|
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung |
Bereitstellen von Azure Data Explorer DB mit Cosmos DB-Verbindung. |
|
Bereitstellen von Azure Data Explorer db mit Ereignisrasterverbindung |
Bereitstellen von Azure Data Explorer db mit Event Grid-Verbindung. |
|
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung |
Bereitstellen von Azure Data Explorer db mit Event Hub-Verbindung. |
|
FinOps Hub- |
Diese Vorlage erstellt eine neue FinOps-Hubinstanz, einschließlich Data Explorer, Data Lake Storage und Data Factory. |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Clusterressourcentyp kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.Kusto/Cluster-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
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"
]
}
}
Eigenschaftswerte
Microsoft.Kusto/cluster
| Name | Beschreibung | Wert |
|---|---|---|
| Identität | Die Identität des Clusters, falls konfiguriert. | Identität |
| Ort | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | Schnur Zwänge: Pattern = ^.*$ (erforderlich) |
| parent_id | Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. | Zeichenfolge (erforderlich) |
| Eigenschaften | Die Clustereigenschaften. | ClusterProperties- |
| Sku | Die SKU des Clusters. | AzureSku- (erforderlich) |
| Schilder | Ressourcentags | Wörterbuch der Tagnamen und -werte. |
| Art | Der Ressourcentyp | "Microsoft.Kusto/clusters@2024-04-13" |
| Zonen | Die Verfügbarkeitszonen des Clusters. | Zeichenfolge[] |
AkzeptiertAudiences
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | GUID oder gültige URL, die eine akzeptierte Zielgruppe darstellt. | Schnur |
AzureSku
| Name | Beschreibung | Wert |
|---|---|---|
| Fassungsvermögen | Die Anzahl der Instanzen des Clusters. | Int |
| Name | SKU-Name. | "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" (erforderlich) |
| Rang | SKU-Ebene. | "Einfach" "Standard" (erforderlich) |
CalloutPolicy (Englisch)
| Name | Beschreibung | Wert |
|---|---|---|
| LegendeTyp | Typ des Popupdiensts, der die Art der externen Ressource oder des Diensts angibt, auf die zugegriffen wird. | "azure_digital_twins" "azure_openai" 'kosmosdb' "external_data" "genevametrics" "kusto" "mysql" "postgresql" "sandbox_artifacts" 'SQL' 'WebAPI' |
| calloutUriRegex | Regulärer Ausdruck oder FQDN-Muster für den Popup-URI. | Schnur |
| ausgehenDer Zugang | Gibt an, ob ausgehender Zugriff für das angegebene URI-Muster zulässig ist. | "Zulassen" "Ablehnen" |
Cluster-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| akzeptiertAudiences | Die akzeptierten Zielgruppen des Clusters. | Akzeptierte Zielgruppen[] |
| allowedFqdnList | Liste der zulässigen FQDNs(Vollqualifizierter Domänenname) für den Ausgang von Cluster. | Zeichenfolge[] |
| allowedIpRangeList | Die Liste der IP-Adressen im Format von CIDR, die eine Verbindung mit dem Cluster herstellen dürfen. | Zeichenfolge[] |
| calloutPolicies | Liste der Legendenrichtlinien für den Ausgang von Cluster. | CalloutPolicy-[] |
| aktivierenAutoStop aktivieren | Ein boolescher Wert, der angibt, ob der Cluster automatisch beendet werden kann (aufgrund fehlender Daten oder einer Aktivität für viele Tage). | Bool |
| enableDiskEncryption | Ein boolescher Wert, der angibt, ob die Datenträger des Clusters verschlüsselt sind. | Bool |
| enableDoubleEncryption | Ein boolescher Wert, der angibt, ob die doppelte Verschlüsselung aktiviert ist. | Bool |
| enableBereinigen | Ein boolescher Wert, der angibt, ob die Bereinigungsvorgänge aktiviert sind. | Bool |
| enableStreamingIngest | Ein boolescher Wert, der angibt, ob das Streaminggest aktiviert ist. | Bool |
| MotorTyp | Der Modultyp | 'V2' "V3" |
| keyVault-Eigenschaften | KeyVault-Eigenschaften für die Clusterverschlüsselung. | KeyVault-Eigenschaften |
| languageErweiterungen | Liste der Spracherweiterungen des Clusters. | LanguageExtensionsList- |
| optimiertAutomatische Skalierung | Optimierte Definition der automatischen Skalierung. | OptimizedAutoscale- |
| publicIPTyp | Gibt an, welcher öffentliche IP-Typ erstellt werden soll – IPv4 (Standard) oder DualStack (sowohl IPv4 als auch IPv6) | "DualStack" "IPv4" |
| Öffentlicher Netzwerkzugang | Der Zugriff auf das öffentliche Netzwerk auf den Cluster ist standardmäßig aktiviert. Wenn diese Option deaktiviert ist, ist nur eine private Endpunktverbindung mit dem Cluster zulässig. | "Deaktiviert" "Aktiviert" |
| restrictOutboundNetworkAccess | Gibt an, ob der ausgehende Netzwerkzugriff eingeschränkt werden soll. Der Wert ist optional, aber wenn er übergeben wird, muss 'Enabled' oder 'Disabled' sein. | "Deaktiviert" "Aktiviert" |
| trustedExternalTenants | Die externen Mandanten des Clusters. | TrustedExternalTenant[] |
| virtualClusterGraduationEigenschaften | Virtuelle Cluster Graduierungseigenschaften | Schnur Zwänge: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| virtualNetworkKonfiguration | Definition des virtuellen Netzwerks. | VirtualNetworkConfiguration- |
KomponentenSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
| Name | Beschreibung | Wert |
|---|
Identität
| Name | Beschreibung | Wert |
|---|---|---|
| Art | Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten. | "Keine" 'SystemZugewiesen' "SystemAssigned, UserAssigned" "UserAssigned" (erforderlich) |
| vom Benutzer zugewiesene Identitäten | Die Liste der Benutzeridentitäten, die dem Kusto-Cluster zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
KeyVault-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| Schlüsselname | Der Name des Schlüsseltresorschlüssels. | Schnur |
| keyVaultUri | Der URI des Schlüsseltresors. | Schnur |
| Schlüsselversion | Die Version des Schlüsseltresorschlüssels. | Schnur |
| BenutzerIdentität | Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat. | Schnur |
LanguageExtension
| Name | Beschreibung | Wert |
|---|---|---|
| languageExtensionCustomImageName | Der benutzerdefinierte Bildname der Spracherweiterung. | Schnur |
| languageExtensionImageName | Der Bildname der Spracherweiterung. | "Python3_10_8" "Python3_10_8_DL" "Python3_11_7" "Python3_11_7_DL" "Python3_6_5" 'PythonCustomImage' 'R' |
| languageErweiterungName | Der Name der Spracherweiterung. | "PYTHON" 'R' |
LanguageExtensionsList
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | Die Liste der Spracherweiterungen. | Spracherweiterung[] |
OptimiertAutomatische Skalierung
| Name | Beschreibung | Wert |
|---|---|---|
| isEnabled (Aktiviert) | Ein boolescher Wert, der angibt, ob das optimierte Autoskalen-Feature aktiviert ist oder nicht. | bool (erforderlich) |
| Maximum | Maximale Anzahl zulässiger Instanzen. | int (erforderlich) |
| Minimum | Anzahl der zulässigen Mindestinstanzen. | int (erforderlich) |
| Version | Die Version der definierten Vorlage, z. B. 1. | int (erforderlich) |
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
TrustedExternalTenant
| Name | Beschreibung | Wert |
|---|---|---|
| Wert | GUID, die einen externen Mandanten darstellt. | Schnur |
VirtualNetworkConfiguration (VirtualNetworkConfiguration)
| Name | Beschreibung | Wert |
|---|---|---|
| dataManagementPublicIpId | Die Dienst-ID der öffentlichen IP-Adresse der Datenverwaltung. | Zeichenfolge (erforderlich) |
| enginePublicIpId | Die öffentliche IP-Adressressourcen-ID des Moduldiensts. | Zeichenfolge (erforderlich) |
| Zustand | Wenn diese Option aktiviert ist, wird der Cluster im konfigurierten Subnetz bereitgestellt, wenn er deaktiviert wird, aus dem Subnetz entfernt. | "Deaktiviert" "Aktiviert" |
| subnetz-ID | Die Subnetzressourcen-ID. | Zeichenfolge (erforderlich) |
Verwendungsbeispiele
Terraform-Beispiele
Ein grundlegendes Beispiel für die Bereitstellung eines Kusto-Clusters (auch als Azure Data Explorer bezeichnet).
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 = ["*"]
}
Ein grundlegendes Beispiel für die Bereitstellung eines Kusto-Clusters (auch als Azure Data Explorer bezeichnet).
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 = ["*"]
}
Von Azure verifizierte Module
Die folgenden Azure Verified Modules können verwendet werden, um diesen Ressourcentyp bereitzustellen.
| Modul | Beschreibung |
|---|---|
| Kusto-Cluster | AVM-Ressourcenmodul für Kusto-Cluster |