你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Microsoft.Kusto 群集

Bicep 资源定义

可以使用目标操作部署群集资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.Kusto/clusters 资源,请将以下 Bicep 添加到模板。

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'
  ]
}

属性值

Microsoft.Kusto/clusters

名字 描述 价值
标识 群集的标识(如果已配置)。 标识
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^.*$ (必需)
性能 群集属性。 ClusterProperties
作用域 在与部署范围不同的范围内创建资源时使用。 将此属性设置为资源的符号名称以应用 扩展资源
SKU 群集的 SKU。 AzureSku(必需)
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
群集的可用性区域。 字符串[]

接受的受众

名字 描述 价值
价值 表示接受受众的 GUID 或有效 URL。 字符串

AzureSku

名字 描述 价值
产能 群集的实例数。 整数 (int)
名字 SKU 名称。 “Dev(无 SLA)_Standard_D11_v2”
“Dev(无 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”(必需)
分层 SKU 层。 “Basic”
“标准”(必需)

标注策略

名字 描述 价值
标注类型 标注服务的类型,指定要访问的外部资源或服务的类型。 “azure_digital_twins”
“azure_openai”
“cosmosdb”
“external_data”
“genevametrics”
“kusto”
“mysql”
“postgresql”
“sandbox_artifacts”
“sql”
“webapi”
标注UriRegex 标注 URI 的正则表达式或 FQDN 模式。 字符串
outboundAccess 指示是否允许对指定的 URI 模式进行出站访问。 “允许”
“拒绝”

ClusterProperties

名字 描述 价值
acceptedAudiences 群集的接受受众。 接受的观众
allowedFqdnList 群集出口允许的 FQDN(完全限定域名)列表。 字符串[]
allowedIpRangeList 允许连接到群集的 CIDR 格式的 IP 列表。 字符串[]
callout政策 群集出口的标注策略列表。 标注政策
enableAutoStop 一个布尔值,该值指示群集是否可以自动停止(由于数据不足或没有活动数天)。 布尔
enableDiskEncryption 一个布尔值,该值指示群集的磁盘是否已加密。 布尔
enableDoubleEncryption 一个布尔值,该值指示是否启用了双重加密。 布尔
enablePurge 一个布尔值,该值指示是否启用了清除操作。 布尔
enableStreamingIngest 函数 一个布尔值,该值指示是否启用了流式引入。 布尔
发动机类型 引擎类型 “V2”
“V3”
keyVaultProperties 群集加密的 KeyVault 属性。 KeyVaultProperties
language扩展 群集的语言扩展列表。 语言扩展列表
optimizedAutoscale 优化的自动缩放定义。 优化自动缩放
publicIP类型 指示要创建的公共 IP 类型 - IPv4(默认)或 DualStack (IPv4 和 IPv6) “DualStack”
“IPv4”
publicNetworkAccess 默认情况下启用对群集的公共网络访问。 禁用后,仅允许与群集建立专用终结点连接 “Disabled”
“Enabled”
restrictOutboundNetworkAccess 是否限制出站网络访问。 值是可选的,但如果传入,则必须为“Enabled”或“Disabled” “Disabled”
“Enabled”
trustedExternalTenants 群集的外部租户。 TrustedExternalTenant[]
virtualClusterGraduationProperties 虚拟群集毕业属性 字符串

约束:
敏感值。 以安全参数的形式传入。
virtualNetworkConfiguration 虚拟网络定义。 VirtualNetworkConfiguration (虚拟网络配置)

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

名字 描述 价值

身份

名字 描述 价值
类型 使用的托管标识的类型。 类型“SystemAssigned,UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除所有标识。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned”(必需)
用户分配的标识 与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID:“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

名字 描述 价值

KeyVaultProperties

名字 描述 价值
键名称 密钥保管库密钥的名称。 字符串
keyVaultUri 密钥保管库的 URI。 字符串
keyVersion 密钥保管库密钥的版本。 字符串
用户身份 有权访问密钥的用户分配标识(ARM 资源 ID)。 字符串

语言扩展

名字 描述 价值
languageExtensionCustomImageName 语言扩展自定义映像名称。 字符串
languageExtensionImageName (语言扩展图像名称) 语言扩展映像名称。 “Python3_10_8”
“Python3_10_8_DL”
“Python3_11_7”
“Python3_11_7_DL”
“Python3_6_5”
“PythonCustomImage”
“R”
languageExtensionName (语言扩展名称) 语言扩展名称。 “PYTHON”
“R”

语言扩展列表

名字 描述 价值
价值 语言扩展列表。 LanguageExtension 语言扩展

优化自动缩放

名字 描述 价值
isEnabled 已启用 一个布尔值,该值指示是否启用了优化的自动缩放功能。 bool (必需)
最大 允许的最大实例计数。 int (必需)
最低 允许的最小实例计数。 int (必需)
版本 定义的模板版本,例如 1。 int (必需)

TrackedResourceTags

名字 描述 价值

TrustedExternalTenant

名字 描述 价值
价值 表示外部租户的 GUID。 字符串

VirtualNetworkConfiguration (虚拟网络配置)

名字 描述 价值
数据管理公共 IpId 数据管理的服务公共 IP 地址资源 ID。 string (必需)
引擎公共 IpId 引擎服务的公共 IP 地址资源 ID。 string (必需)
状态 启用后,群集将部署到配置的子网中,禁用后将从子网中删除该群集。 “Disabled”
“Enabled”
子网 ID 子网资源 ID。 string (必需)

用法示例

Azure 验证模块

以下 Azure 验证模块 可用于部署此资源类型。

模块 描述
Azure 数据资源管理器(Kusto)群集 Azure 数据资源管理器 (Kusto) 群集的 AVM 资源模块

Azure 快速入门示例

以下 Azure 快速入门模板 包含用于部署此资源类型的 Bicep 示例。

Bicep 文件 描述
使用时间数据历史记录连接 Azure 数字孪生 此模板创建配置了时序数据历史记录连接的 Azure 数字孪生实例。 若要创建连接,必须创建其他资源,例如事件中心命名空间、事件中心、Azure 数据资源管理器群集和数据库。 数据将发送到事件中心,该事件中心最终将数据转发到 Azure 数据资源管理器群集。 数据存储在群集中的数据库表中
创建数据库观察程序 此示例为 Azure SQL 创建数据库观察程序,并配置其数据存储、SQL 目标和托管专用终结点
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB 使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。
使用事件网格连接部署 Azure 数据资源管理器数据库 使用事件网格连接部署 Azure 数据资源管理器数据库。
使用事件中心连接部署 Azure 数据资源管理器数据库 使用事件中心连接部署 Azure 数据资源管理器数据库。
FinOps 中心 此模板创建新的 FinOps 中心实例,包括数据资源管理器、Data Lake 存储和数据工厂。

ARM 模板资源定义

可以使用目标操作部署群集资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.Kusto/clusters 资源,请将以下 JSON 添加到模板。

{
  "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" ]
}

属性值

Microsoft.Kusto/clusters

名字 描述 价值
apiVersion API 版本 '2024-04-13'
标识 群集的标识(如果已配置)。 标识
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^.*$ (必需)
性能 群集属性。 ClusterProperties
SKU 群集的 SKU。 AzureSku(必需)
标签 资源标记 标记名称和值的字典。 请参阅模板 中的 标记
类型 资源类型 “Microsoft.Kusto/clusters”
群集的可用性区域。 字符串[]

接受的受众

名字 描述 价值
价值 表示接受受众的 GUID 或有效 URL。 字符串

AzureSku

名字 描述 价值
产能 群集的实例数。 整数 (int)
名字 SKU 名称。 “Dev(无 SLA)_Standard_D11_v2”
“Dev(无 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”(必需)
分层 SKU 层。 “Basic”
“标准”(必需)

标注策略

名字 描述 价值
标注类型 标注服务的类型,指定要访问的外部资源或服务的类型。 “azure_digital_twins”
“azure_openai”
“cosmosdb”
“external_data”
“genevametrics”
“kusto”
“mysql”
“postgresql”
“sandbox_artifacts”
“sql”
“webapi”
标注UriRegex 标注 URI 的正则表达式或 FQDN 模式。 字符串
outboundAccess 指示是否允许对指定的 URI 模式进行出站访问。 “允许”
“拒绝”

ClusterProperties

名字 描述 价值
acceptedAudiences 群集的接受受众。 接受的观众
allowedFqdnList 群集出口允许的 FQDN(完全限定域名)列表。 字符串[]
allowedIpRangeList 允许连接到群集的 CIDR 格式的 IP 列表。 字符串[]
callout政策 群集出口的标注策略列表。 标注政策
enableAutoStop 一个布尔值,该值指示群集是否可以自动停止(由于数据不足或没有活动数天)。 布尔
enableDiskEncryption 一个布尔值,该值指示群集的磁盘是否已加密。 布尔
enableDoubleEncryption 一个布尔值,该值指示是否启用了双重加密。 布尔
enablePurge 一个布尔值,该值指示是否启用了清除操作。 布尔
enableStreamingIngest 函数 一个布尔值,该值指示是否启用了流式引入。 布尔
发动机类型 引擎类型 “V2”
“V3”
keyVaultProperties 群集加密的 KeyVault 属性。 KeyVaultProperties
language扩展 群集的语言扩展列表。 语言扩展列表
optimizedAutoscale 优化的自动缩放定义。 优化自动缩放
publicIP类型 指示要创建的公共 IP 类型 - IPv4(默认)或 DualStack (IPv4 和 IPv6) “DualStack”
“IPv4”
publicNetworkAccess 默认情况下启用对群集的公共网络访问。 禁用后,仅允许与群集建立专用终结点连接 “Disabled”
“Enabled”
restrictOutboundNetworkAccess 是否限制出站网络访问。 值是可选的,但如果传入,则必须为“Enabled”或“Disabled” “Disabled”
“Enabled”
trustedExternalTenants 群集的外部租户。 TrustedExternalTenant[]
virtualClusterGraduationProperties 虚拟群集毕业属性 字符串

约束:
敏感值。 以安全参数的形式传入。
virtualNetworkConfiguration 虚拟网络定义。 VirtualNetworkConfiguration (虚拟网络配置)

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

名字 描述 价值

身份

名字 描述 价值
类型 使用的托管标识的类型。 类型“SystemAssigned,UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除所有标识。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned”(必需)
用户分配的标识 与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID:“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

名字 描述 价值

KeyVaultProperties

名字 描述 价值
键名称 密钥保管库密钥的名称。 字符串
keyVaultUri 密钥保管库的 URI。 字符串
keyVersion 密钥保管库密钥的版本。 字符串
用户身份 有权访问密钥的用户分配标识(ARM 资源 ID)。 字符串

语言扩展

名字 描述 价值
languageExtensionCustomImageName 语言扩展自定义映像名称。 字符串
languageExtensionImageName (语言扩展图像名称) 语言扩展映像名称。 “Python3_10_8”
“Python3_10_8_DL”
“Python3_11_7”
“Python3_11_7_DL”
“Python3_6_5”
“PythonCustomImage”
“R”
languageExtensionName (语言扩展名称) 语言扩展名称。 “PYTHON”
“R”

语言扩展列表

名字 描述 价值
价值 语言扩展列表。 LanguageExtension 语言扩展

优化自动缩放

名字 描述 价值
isEnabled 已启用 一个布尔值,该值指示是否启用了优化的自动缩放功能。 bool (必需)
最大 允许的最大实例计数。 int (必需)
最低 允许的最小实例计数。 int (必需)
版本 定义的模板版本,例如 1。 int (必需)

TrackedResourceTags

名字 描述 价值

TrustedExternalTenant

名字 描述 价值
价值 表示外部租户的 GUID。 字符串

VirtualNetworkConfiguration (虚拟网络配置)

名字 描述 价值
数据管理公共 IpId 数据管理的服务公共 IP 地址资源 ID。 string (必需)
引擎公共 IpId 引擎服务的公共 IP 地址资源 ID。 string (必需)
状态 启用后,群集将部署到配置的子网中,禁用后将从子网中删除该群集。 “Disabled”
“Enabled”
子网 ID 子网资源 ID。 string (必需)

用法示例

Azure 快速入门模板

以下 Azure 快速入门模板 部署此资源类型。

模板 描述
使用时间数据历史记录连接 Azure 数字孪生

部署到 Azure
此模板创建配置了时序数据历史记录连接的 Azure 数字孪生实例。 若要创建连接,必须创建其他资源,例如事件中心命名空间、事件中心、Azure 数据资源管理器群集和数据库。 数据将发送到事件中心,该事件中心最终将数据转发到 Azure 数据资源管理器群集。 数据存储在群集中的数据库表中
创建数据库 群集

部署到 Azure
使用此模板可以创建群集和数据库。
创建数据库观察程序

部署到 Azure
此示例为 Azure SQL 创建数据库观察程序,并配置其数据存储、SQL 目标和托管专用终结点
将 Azure 数据资源管理器群集部署到 VNet

部署到 Azure
此模板允许将群集部署到 VNet。
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB

部署到 Azure
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。
使用事件网格连接部署 Azure 数据资源管理器数据库

部署到 Azure
使用事件网格连接部署 Azure 数据资源管理器数据库。
使用事件中心连接部署 Azure 数据资源管理器数据库

部署到 Azure
使用事件中心连接部署 Azure 数据资源管理器数据库。
FinOps 中心

部署到 Azure
此模板创建新的 FinOps 中心实例,包括数据资源管理器、Data Lake 存储和数据工厂。

Terraform (AzAPI 提供程序)资源定义

可以使用目标操作部署群集资源类型:

有关每个 API 版本中已更改属性的列表,请参阅 更改日志

资源格式

若要创建 Microsoft.Kusto/clusters 资源,请将以下 Terraform 添加到模板。

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"
    ]
  }
}

属性值

Microsoft.Kusto/clusters

名字 描述 价值
标识 群集的标识(如果已配置)。 标识
位置 资源所在的地理位置 string (必需)
名字 资源名称 字符串

约束:
模式 = ^.*$ (必需)
parent_id 要向其应用此扩展资源的资源的 ID。 string (必需)
性能 群集属性。 ClusterProperties
SKU 群集的 SKU。 AzureSku(必需)
标签 资源标记 标记名称和值的字典。
类型 资源类型 “Microsoft.Kusto/clusters@2024-04-13”
群集的可用性区域。 字符串[]

接受的受众

名字 描述 价值
价值 表示接受受众的 GUID 或有效 URL。 字符串

AzureSku

名字 描述 价值
产能 群集的实例数。 整数 (int)
名字 SKU 名称。 “Dev(无 SLA)_Standard_D11_v2”
“Dev(无 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”(必需)
分层 SKU 层。 “Basic”
“标准”(必需)

标注策略

名字 描述 价值
标注类型 标注服务的类型,指定要访问的外部资源或服务的类型。 “azure_digital_twins”
“azure_openai”
“cosmosdb”
“external_data”
“genevametrics”
“kusto”
“mysql”
“postgresql”
“sandbox_artifacts”
“sql”
“webapi”
标注UriRegex 标注 URI 的正则表达式或 FQDN 模式。 字符串
outboundAccess 指示是否允许对指定的 URI 模式进行出站访问。 “允许”
“拒绝”

ClusterProperties

名字 描述 价值
acceptedAudiences 群集的接受受众。 接受的观众
allowedFqdnList 群集出口允许的 FQDN(完全限定域名)列表。 字符串[]
allowedIpRangeList 允许连接到群集的 CIDR 格式的 IP 列表。 字符串[]
callout政策 群集出口的标注策略列表。 标注政策
enableAutoStop 一个布尔值,该值指示群集是否可以自动停止(由于数据不足或没有活动数天)。 布尔
enableDiskEncryption 一个布尔值,该值指示群集的磁盘是否已加密。 布尔
enableDoubleEncryption 一个布尔值,该值指示是否启用了双重加密。 布尔
enablePurge 一个布尔值,该值指示是否启用了清除操作。 布尔
enableStreamingIngest 函数 一个布尔值,该值指示是否启用了流式引入。 布尔
发动机类型 引擎类型 “V2”
“V3”
keyVaultProperties 群集加密的 KeyVault 属性。 KeyVaultProperties
language扩展 群集的语言扩展列表。 语言扩展列表
optimizedAutoscale 优化的自动缩放定义。 优化自动缩放
publicIP类型 指示要创建的公共 IP 类型 - IPv4(默认)或 DualStack (IPv4 和 IPv6) “DualStack”
“IPv4”
publicNetworkAccess 默认情况下启用对群集的公共网络访问。 禁用后,仅允许与群集建立专用终结点连接 “Disabled”
“Enabled”
restrictOutboundNetworkAccess 是否限制出站网络访问。 值是可选的,但如果传入,则必须为“Enabled”或“Disabled” “Disabled”
“Enabled”
trustedExternalTenants 群集的外部租户。 TrustedExternalTenant[]
virtualClusterGraduationProperties 虚拟群集毕业属性 字符串

约束:
敏感值。 以安全参数的形式传入。
virtualNetworkConfiguration 虚拟网络定义。 VirtualNetworkConfiguration (虚拟网络配置)

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

名字 描述 价值

身份

名字 描述 价值
类型 使用的托管标识的类型。 类型“SystemAssigned,UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除所有标识。 “None”
“SystemAssigned”
“SystemAssigned,UserAssigned”
“UserAssigned”(必需)
用户分配的标识 与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID:“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

名字 描述 价值

KeyVaultProperties

名字 描述 价值
键名称 密钥保管库密钥的名称。 字符串
keyVaultUri 密钥保管库的 URI。 字符串
keyVersion 密钥保管库密钥的版本。 字符串
用户身份 有权访问密钥的用户分配标识(ARM 资源 ID)。 字符串

语言扩展

名字 描述 价值
languageExtensionCustomImageName 语言扩展自定义映像名称。 字符串
languageExtensionImageName (语言扩展图像名称) 语言扩展映像名称。 “Python3_10_8”
“Python3_10_8_DL”
“Python3_11_7”
“Python3_11_7_DL”
“Python3_6_5”
“PythonCustomImage”
“R”
languageExtensionName (语言扩展名称) 语言扩展名称。 “PYTHON”
“R”

语言扩展列表

名字 描述 价值
价值 语言扩展列表。 LanguageExtension 语言扩展

优化自动缩放

名字 描述 价值
isEnabled 已启用 一个布尔值,该值指示是否启用了优化的自动缩放功能。 bool (必需)
最大 允许的最大实例计数。 int (必需)
最低 允许的最小实例计数。 int (必需)
版本 定义的模板版本,例如 1。 int (必需)

TrackedResourceTags

名字 描述 价值

TrustedExternalTenant

名字 描述 价值
价值 表示外部租户的 GUID。 字符串

VirtualNetworkConfiguration (虚拟网络配置)

名字 描述 价值
数据管理公共 IpId 数据管理的服务公共 IP 地址资源 ID。 string (必需)
引擎公共 IpId 引擎服务的公共 IP 地址资源 ID。 string (必需)
状态 启用后,群集将部署到配置的子网中,禁用后将从子网中删除该群集。 “Disabled”
“Enabled”
子网 ID 子网资源 ID。 string (必需)

用法示例

Terraform 示例

部署 Kusto(也称为 Azure 数据资源管理器)群集的基本示例。

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    = ["*"]
}

部署 Kusto(也称为 Azure 数据资源管理器)群集的基本示例。

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    = ["*"]
}

Azure 验证模块

以下 Azure 验证模块 可用于部署此资源类型。

模块 描述
Kusto 群集 Kusto 群集的 AVM 资源模块