你当前正在访问 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' = {
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'
]
}
属性值
AcceptedAudiences
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 表示接受受众的 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” “标准”（必需） |
CalloutPolicy
| 名字 | 描述 | 价值 |
|---|---|---|
| calloutType | 标注服务的类型，指定要访问的外部资源或服务的类型。 | “azure_digital_twins” “azure_openai” “cosmosdb” “external_data” “genevametrics” “kusto” “mysql” “postgresql” “sandbox_artifacts” “sql” “webapi” |
| calloutUriRegex | 标注 URI 的正则表达式或 FQDN 模式。 | 字符串 |
| outboundAccess | 指示是否允许对指定的 URI 模式进行出站访问。 | “允许” “拒绝” |
ClusterProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| acceptedAudiences | 群集的接受受众。 | AcceptedAudiences[] |
| allowedFqdnList | 群集出口允许的 FQDN（完全限定域名）列表。 | string[] |
| allowedIpRangeList | 允许连接到群集的 CIDR 格式的 IP 列表。 | string[] |
| calloutPolicies | 群集出口的标注策略列表。 | CalloutPolicy[] |
| enableAutoStop | 一个布尔值，该值指示群集是否可以自动停止（由于数据不足或没有活动数天）。 | bool |
| enableDiskEncryption | 一个布尔值，该值指示群集的磁盘是否已加密。 | bool |
| enableDoubleEncryption | 一个布尔值，该值指示是否启用了双重加密。 | bool |
| enablePurge | 一个布尔值，该值指示是否启用了清除操作。 | bool |
| enableStreamingIngest | 一个布尔值，该值指示是否启用了流式引入。 | bool |
| engineType | 引擎类型 | “V2” “V3” |
| keyVaultProperties | 群集加密的 KeyVault 属性。 | KeyVaultProperties |
| languageExtensions | 群集的语言扩展列表。 | LanguageExtensionsList |
| optimizedAutoscale | 优化的自动缩放定义。 | OptimizedAutoscale |
| publicIPType | 指示要创建的公共 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”（必需） |
| userAssignedIdentities | 与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| 名字 | 描述 | 价值 |
|---|
KeyVaultProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| keyName | 密钥保管库密钥的名称。 | 字符串 |
| keyVaultUri | 密钥保管库的 URI。 | 字符串 |
| keyVersion | 密钥保管库密钥的版本。 | 字符串 |
| userIdentity | 有权访问密钥的用户分配标识（ARM 资源 ID）。 | 字符串 |
LanguageExtension
| 名字 | 描述 | 价值 |
|---|---|---|
| languageExtensionCustomImageName | 语言扩展自定义映像名称。 | 字符串 |
| languageExtensionImageName | 语言扩展映像名称。 | “Python3_10_8” “Python3_10_8_DL” “Python3_11_7” “Python3_11_7_DL” “Python3_6_5” “PythonCustomImage” “R” |
| languageExtensionName | 语言扩展名称。 | “PYTHON” “R” |
LanguageExtensionsList
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 语言扩展列表。 | LanguageExtension[] |
Microsoft.Kusto/clusters
| 名字 | 描述 | 价值 |
|---|---|---|
| 身份 | 群集的标识（如果已配置）。 | 标识 |
| 位置 | 资源所在的地理位置 | string （必需） |
| 名字 | 资源名称 | 字符串 约束： 模式 = ^.*$ （必需） |
| 性能 | 群集属性。 | ClusterProperties |
| sku | 群集的 SKU。 | AzureSku（必需） |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 区 | 群集的可用性区域。 | string[] |
OptimizedAutoscale
| 名字 | 描述 | 价值 |
|---|---|---|
| isEnabled | 一个布尔值，该值指示是否启用了优化的自动缩放功能。 | bool （必需） |
| 最大 | 允许的最大实例计数。 | int （必需） |
| 最低 | 允许的最小实例计数。 | int （必需） |
| 版本 | 定义的模板版本，例如 1。 | int （必需） |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
TrustedExternalTenant
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 表示外部租户的 GUID。 | 字符串 |
VirtualNetworkConfiguration
| 名字 | 描述 | 价值 |
|---|---|---|
| dataManagementPublicIpId | 数据管理的服务公共 IP 地址资源 ID。 | string （必需） |
| enginePublicIpId | 引擎服务的公共 IP 地址资源 ID。 | string （必需） |
| 州 | 启用后，群集将部署到配置的子网中，禁用后将从子网中删除该群集。 | “Disabled” “Enabled” |
| subnetId | 子网资源 ID。 | string （必需） |
快速入门示例
以下快速入门示例部署此资源类型。
| Bicep 文件 | 描述 |
|---|---|
| 使用时间数据历史记录连接 Azure 数字孪生 | 此模板创建配置了时序数据历史记录连接的 Azure 数字孪生实例。 若要创建连接，必须创建其他资源，例如事件中心命名空间、事件中心、Azure 数据资源管理器群集和数据库。 数据将发送到事件中心，该事件中心最终将数据转发到 Azure 数据资源管理器群集。 数据存储在群集中的数据库表中 |
| 创建数据库观察程序 | 此示例为 Azure SQL 创建数据库观察程序，并配置其数据存储、SQL 目标和托管专用终结点 |
| 使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB | 使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。 |
| 使用事件网格连接部署 Azure 数据资源管理器数据库 | 使用事件网格连接部署 Azure 数据资源管理器数据库。 |
| 使用事件中心连接部署 Azure 数据资源管理器数据库 | 使用事件中心连接部署 Azure 数据资源管理器数据库。 |
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" ]
}
属性值
AcceptedAudiences
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 表示接受受众的 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” “标准”（必需） |
CalloutPolicy
| 名字 | 描述 | 价值 |
|---|---|---|
| calloutType | 标注服务的类型，指定要访问的外部资源或服务的类型。 | “azure_digital_twins” “azure_openai” “cosmosdb” “external_data” “genevametrics” “kusto” “mysql” “postgresql” “sandbox_artifacts” “sql” “webapi” |
| calloutUriRegex | 标注 URI 的正则表达式或 FQDN 模式。 | 字符串 |
| outboundAccess | 指示是否允许对指定的 URI 模式进行出站访问。 | “允许” “拒绝” |
ClusterProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| acceptedAudiences | 群集的接受受众。 | AcceptedAudiences[] |
| allowedFqdnList | 群集出口允许的 FQDN（完全限定域名）列表。 | string[] |
| allowedIpRangeList | 允许连接到群集的 CIDR 格式的 IP 列表。 | string[] |
| calloutPolicies | 群集出口的标注策略列表。 | CalloutPolicy[] |
| enableAutoStop | 一个布尔值，该值指示群集是否可以自动停止（由于数据不足或没有活动数天）。 | bool |
| enableDiskEncryption | 一个布尔值，该值指示群集的磁盘是否已加密。 | bool |
| enableDoubleEncryption | 一个布尔值，该值指示是否启用了双重加密。 | bool |
| enablePurge | 一个布尔值，该值指示是否启用了清除操作。 | bool |
| enableStreamingIngest | 一个布尔值，该值指示是否启用了流式引入。 | bool |
| engineType | 引擎类型 | “V2” “V3” |
| keyVaultProperties | 群集加密的 KeyVault 属性。 | KeyVaultProperties |
| languageExtensions | 群集的语言扩展列表。 | LanguageExtensionsList |
| optimizedAutoscale | 优化的自动缩放定义。 | OptimizedAutoscale |
| publicIPType | 指示要创建的公共 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”（必需） |
| userAssignedIdentities | 与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| 名字 | 描述 | 价值 |
|---|
KeyVaultProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| keyName | 密钥保管库密钥的名称。 | 字符串 |
| keyVaultUri | 密钥保管库的 URI。 | 字符串 |
| keyVersion | 密钥保管库密钥的版本。 | 字符串 |
| userIdentity | 有权访问密钥的用户分配标识（ARM 资源 ID）。 | 字符串 |
LanguageExtension
| 名字 | 描述 | 价值 |
|---|---|---|
| languageExtensionCustomImageName | 语言扩展自定义映像名称。 | 字符串 |
| languageExtensionImageName | 语言扩展映像名称。 | “Python3_10_8” “Python3_10_8_DL” “Python3_11_7” “Python3_11_7_DL” “Python3_6_5” “PythonCustomImage” “R” |
| languageExtensionName | 语言扩展名称。 | “PYTHON” “R” |
LanguageExtensionsList
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 语言扩展列表。 | LanguageExtension[] |
Microsoft.Kusto/clusters
| 名字 | 描述 | 价值 |
|---|---|---|
| apiVersion | API 版本 | '2024-04-13' |
| 身份 | 群集的标识（如果已配置）。 | 标识 |
| 位置 | 资源所在的地理位置 | string （必需） |
| 名字 | 资源名称 | 字符串 约束： 模式 = ^.*$ （必需） |
| 性能 | 群集属性。 | ClusterProperties |
| sku | 群集的 SKU。 | AzureSku（必需） |
| 标签 | 资源标记 | 标记名称和值的字典。 请参阅模板 中的 |
| 类型 | 资源类型 | “Microsoft.Kusto/clusters” |
| 区 | 群集的可用性区域。 | string[] |
OptimizedAutoscale
| 名字 | 描述 | 价值 |
|---|---|---|
| isEnabled | 一个布尔值，该值指示是否启用了优化的自动缩放功能。 | bool （必需） |
| 最大 | 允许的最大实例计数。 | int （必需） |
| 最低 | 允许的最小实例计数。 | int （必需） |
| 版本 | 定义的模板版本，例如 1。 | int （必需） |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
TrustedExternalTenant
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 表示外部租户的 GUID。 | 字符串 |
VirtualNetworkConfiguration
| 名字 | 描述 | 价值 |
|---|---|---|
| dataManagementPublicIpId | 数据管理的服务公共 IP 地址资源 ID。 | string （必需） |
| enginePublicIpId | 引擎服务的公共 IP 地址资源 ID。 | string （必需） |
| 州 | 启用后，群集将部署到配置的子网中，禁用后将从子网中删除该群集。 | “Disabled” “Enabled” |
| subnetId | 子网资源 ID。 | string （必需） |
快速入门模板
以下快速入门模板部署此资源类型。
| 模板 | 描述 |
|---|---|
使用时间数据历史记录连接 Azure 数字孪生
|
此模板创建配置了时序数据历史记录连接的 Azure 数字孪生实例。 若要创建连接，必须创建其他资源，例如事件中心命名空间、事件中心、Azure 数据资源管理器群集和数据库。 数据将发送到事件中心，该事件中心最终将数据转发到 Azure 数据资源管理器群集。 数据存储在群集中的数据库表中 |
|
创建数据库 群集
|
使用此模板可以创建群集和数据库。 |
|
创建数据库观察程序
|
此示例为 Azure SQL 创建数据库观察程序，并配置其数据存储、SQL 目标和托管专用终结点 |
|
将 Azure 数据资源管理器群集部署到 VNet
|
此模板允许将群集部署到 VNet。 |
|
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB
|
使用 Cosmos DB 连接部署 Azure 数据资源管理器 DB。 |
|
使用事件网格连接部署 Azure 数据资源管理器数据库
|
使用事件网格连接部署 Azure 数据资源管理器数据库。 |
|
使用事件中心连接部署 Azure 数据资源管理器数据库
|
使用事件中心连接部署 Azure 数据资源管理器数据库。 |
Terraform （AzAPI 提供程序）资源定义
可以使用目标操作部署群集资源类型：
- 资源组
有关每个 API 版本中已更改属性的列表，请参阅 更改日志。
资源格式
若要创建 Microsoft.Kusto/clusters 资源，请将以下 Terraform 添加到模板。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Kusto/clusters@2024-04-13"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
name = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
zones = [
"string"
]
body = jsonencode({
properties = {
acceptedAudiences = [
{
value = "string"
}
]
allowedFqdnList = [
"string"
]
allowedIpRangeList = [
"string"
]
calloutPolicies = [
{
calloutType = "string"
calloutUriRegex = "string"
outboundAccess = "string"
}
]
enableAutoStop = bool
enableDiskEncryption = bool
enableDoubleEncryption = bool
enablePurge = bool
enableStreamingIngest = bool
engineType = "string"
keyVaultProperties = {
keyName = "string"
keyVaultUri = "string"
keyVersion = "string"
userIdentity = "string"
}
languageExtensions = {
value = [
{
languageExtensionCustomImageName = "string"
languageExtensionImageName = "string"
languageExtensionName = "string"
}
]
}
optimizedAutoscale = {
isEnabled = bool
maximum = int
minimum = int
version = int
}
publicIPType = "string"
publicNetworkAccess = "string"
restrictOutboundNetworkAccess = "string"
trustedExternalTenants = [
{
value = "string"
}
]
virtualClusterGraduationProperties = "string"
virtualNetworkConfiguration = {
dataManagementPublicIpId = "string"
enginePublicIpId = "string"
state = "string"
subnetId = "string"
}
}
})
}
属性值
AcceptedAudiences
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 表示接受受众的 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” “标准”（必需） |
CalloutPolicy
| 名字 | 描述 | 价值 |
|---|---|---|
| calloutType | 标注服务的类型，指定要访问的外部资源或服务的类型。 | “azure_digital_twins” “azure_openai” “cosmosdb” “external_data” “genevametrics” “kusto” “mysql” “postgresql” “sandbox_artifacts” “sql” “webapi” |
| calloutUriRegex | 标注 URI 的正则表达式或 FQDN 模式。 | 字符串 |
| outboundAccess | 指示是否允许对指定的 URI 模式进行出站访问。 | “允许” “拒绝” |
ClusterProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| acceptedAudiences | 群集的接受受众。 | AcceptedAudiences[] |
| allowedFqdnList | 群集出口允许的 FQDN（完全限定域名）列表。 | string[] |
| allowedIpRangeList | 允许连接到群集的 CIDR 格式的 IP 列表。 | string[] |
| calloutPolicies | 群集出口的标注策略列表。 | CalloutPolicy[] |
| enableAutoStop | 一个布尔值，该值指示群集是否可以自动停止（由于数据不足或没有活动数天）。 | bool |
| enableDiskEncryption | 一个布尔值，该值指示群集的磁盘是否已加密。 | bool |
| enableDoubleEncryption | 一个布尔值，该值指示是否启用了双重加密。 | bool |
| enablePurge | 一个布尔值，该值指示是否启用了清除操作。 | bool |
| enableStreamingIngest | 一个布尔值，该值指示是否启用了流式引入。 | bool |
| engineType | 引擎类型 | “V2” “V3” |
| keyVaultProperties | 群集加密的 KeyVault 属性。 | KeyVaultProperties |
| languageExtensions | 群集的语言扩展列表。 | LanguageExtensionsList |
| optimizedAutoscale | 优化的自动缩放定义。 | OptimizedAutoscale |
| publicIPType | 指示要创建的公共 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”（必需） |
| userAssignedIdentities | 与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 | IdentityUserAssignedIdentities |
IdentityUserAssignedIdentities
| 名字 | 描述 | 价值 |
|---|
KeyVaultProperties
| 名字 | 描述 | 价值 |
|---|---|---|
| keyName | 密钥保管库密钥的名称。 | 字符串 |
| keyVaultUri | 密钥保管库的 URI。 | 字符串 |
| keyVersion | 密钥保管库密钥的版本。 | 字符串 |
| userIdentity | 有权访问密钥的用户分配标识（ARM 资源 ID）。 | 字符串 |
LanguageExtension
| 名字 | 描述 | 价值 |
|---|---|---|
| languageExtensionCustomImageName | 语言扩展自定义映像名称。 | 字符串 |
| languageExtensionImageName | 语言扩展映像名称。 | “Python3_10_8” “Python3_10_8_DL” “Python3_11_7” “Python3_11_7_DL” “Python3_6_5” “PythonCustomImage” “R” |
| languageExtensionName | 语言扩展名称。 | “PYTHON” “R” |
LanguageExtensionsList
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 语言扩展列表。 | LanguageExtension[] |
Microsoft.Kusto/clusters
| 名字 | 描述 | 价值 |
|---|---|---|
| 身份 | 群集的标识（如果已配置）。 | 标识 |
| 位置 | 资源所在的地理位置 | string （必需） |
| 名字 | 资源名称 | 字符串 约束： 模式 = ^.*$ （必需） |
| 性能 | 群集属性。 | ClusterProperties |
| sku | 群集的 SKU。 | AzureSku（必需） |
| 标签 | 资源标记 | 标记名称和值的字典。 |
| 类型 | 资源类型 | “Microsoft.Kusto/clusters@2024-04-13” |
| 区 | 群集的可用性区域。 | string[] |
OptimizedAutoscale
| 名字 | 描述 | 价值 |
|---|---|---|
| isEnabled | 一个布尔值，该值指示是否启用了优化的自动缩放功能。 | bool （必需） |
| 最大 | 允许的最大实例计数。 | int （必需） |
| 最低 | 允许的最小实例计数。 | int （必需） |
| 版本 | 定义的模板版本，例如 1。 | int （必需） |
TrackedResourceTags
| 名字 | 描述 | 价值 |
|---|
TrustedExternalTenant
| 名字 | 描述 | 价值 |
|---|---|---|
| 价值 | 表示外部租户的 GUID。 | 字符串 |
VirtualNetworkConfiguration
| 名字 | 描述 | 价值 |
|---|---|---|
| dataManagementPublicIpId | 数据管理的服务公共 IP 地址资源 ID。 | string （必需） |
| enginePublicIpId | 引擎服务的公共 IP 地址资源 ID。 | string （必需） |
| 州 | 启用后，群集将部署到配置的子网中，禁用后将从子网中删除该群集。 | “Disabled” “Enabled” |
| subnetId | 子网资源 ID。 | string （必需） |