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

Clusters - Create Or Update

服务:
Azure Kusto
API 版本:
2025-02-14

创建或更新 Kusto 群集。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Kusto/clusters/{clusterName}?api-version=2025-02-14

URI 参数

名称 在 必需 类型 说明
clusterName
 path True

string

pattern: ^.*$

Kusto 群集的名称。
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

资源组的名称。 此名称不区分大小写。
subscriptionId
 path True

string

minLength: 1

目标订阅的 ID。
api-version
 query True

string

minLength: 1

用于此作的 API 版本。

请求头

名称 必需 类型 说明
If-Match

string

群集的 ETag。 省略此值以始终覆盖当前群集。 指定最后一次看到的 ETag 值，以防止意外覆盖并发更改。
If-None-Match

string

设置为“*”以允许创建新群集，但要防止更新现有群集。 其他值将导致 412 预条件失败响应。

请求正文

名称 必需 类型 说明
location True

string

资源所在的地理位置
sku True

AzureSku

群集的 SKU。
identity

Identity

群集的标识（如果已配置）。
properties.acceptedAudiences

AcceptedAudiences[]

群集的接受受众。
properties.allowedFqdnList

string[]

群集出口允许的 FQDN（完全限定域名）列表。
properties.allowedIpRangeList

string[]

允许连接到群集的 CIDR 格式的 IP 列表。
properties.calloutPolicies

CalloutPolicy[]

群集出口的标注策略列表。
properties.enableAutoStop

boolean

一个布尔值，该值指示群集是否可以自动停止（由于数据不足或没有活动数天）。
properties.enableDiskEncryption

boolean

一个布尔值，该值指示群集的磁盘是否已加密。
properties.enableDoubleEncryption

boolean

一个布尔值，该值指示是否启用了双重加密。
properties.enablePurge

boolean

一个布尔值，该值指示是否启用了清除操作。
properties.enableStreamingIngest

boolean

一个布尔值，该值指示是否启用了流式引入。
properties.engineType

EngineType

引擎类型
properties.keyVaultProperties

KeyVaultProperties

群集加密的 KeyVault 属性。
properties.languageExtensions

LanguageExtensionsList

群集的语言扩展列表。
properties.optimizedAutoscale

OptimizedAutoscale

优化的自动缩放定义。
properties.publicIPType

PublicIPType

指示要创建的公共 IP 类型 - IPv4（默认）或 DualStack （IPv4 和 IPv6）
properties.publicNetworkAccess

PublicNetworkAccess

默认情况下启用对群集的公共网络访问。 禁用后，仅允许与群集建立专用终结点连接
properties.restrictOutboundNetworkAccess

ClusterNetworkAccessFlag

是否限制出站网络访问。 值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
properties.trustedExternalTenants

TrustedExternalTenant[]

群集的外部租户。
properties.virtualClusterGraduationProperties

string (password)

虚拟群集毕业属性
properties.virtualNetworkConfiguration

VirtualNetworkConfiguration

虚拟网络定义。
tags

object

资源标记。
zones

string[]

可用性区域。

响应

名称 类型 说明
200 OK

Cluster

资源“群集”更新作成功
201 Created

Cluster

资源“群集”创建作成功

标头

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流程。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

KustoClusterCreateWithCMKFederatedIdentity
KustoClusterCreateWithCMKUserAssignedIdentity
KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

示例请求

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/clusters/kustoClusterCMK?api-version=2025-02-14

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  }
}

示例响应

状态代码:
200 
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}
状态代码:
201 
Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity",
      "federatedIdentityClientId": "11111111-2222-3333-4444-555555555555"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClusterCreateWithCMKUserAssignedIdentity

示例请求

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/clusters/kustoClusterCMK?api-version=2025-02-14

{
  "location": "westus",
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {}
    }
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  }
}

示例响应

状态代码:
200 
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}
状态代码:
201 
Azure-AsyncOperation: https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/providers/Microsoft.Kusto/locations/westus/operationResults/742bef43-608b-4b58-ba96-6f7a32ec5f0f?api-version=2025-02-14
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.Kusto/Clusters/kustoClusterCMK",
  "name": "kustoClusterCMK",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Running",
    "enableDiskEncryption": false,
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "enableAutoStop": true,
    "publicIPType": "IPv4",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled",
    "keyVaultProperties": {
      "keyVaultUri": "https://myvault.vault.azure.net",
      "keyName": "myClusterCMKKey",
      "keyVersion": "12345678-1234-1234-1234-123456789098",
      "userIdentity": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity"
    },
    "engineType": "V3"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "tier": "Standard",
    "capacity": 2
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustoRgTest/providers/Microsoft.ManagedIdentity/userAssignedIdentities/kustoClusterIdentity": {
        "clientId": "11111111-2222-3333-4444-555555555555",
        "principalId": "66666666-7777-8888-9999-000000000000"
      }
    }
  },
  "etag": "abcd1234"
}

KustoClustersCreateOrUpdate

示例请求

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoCluster?api-version=2025-02-14

{
  "identity": {
    "type": "SystemAssigned"
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

示例响应

状态代码:
200 
{
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "etag": "abcd",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "userAssignedIdentities": {}
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDiskEncryption": false,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "engineType": "V3",
    "keyVaultProperties": {
      "keyName": "keyName",
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyVersion": "keyVersion"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "provisioningState": "Succeeded",
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}
状态代码:
201 
{
  "name": "kustoCluster",
  "type": "Microsoft.Kusto/Clusters",
  "etag": "abcd123",
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/kustoCluster",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "userAssignedIdentities": {}
  },
  "location": "westus",
  "properties": {
    "allowedIpRangeList": [
      "0.0.0.0/0"
    ],
    "enableAutoStop": true,
    "enableDiskEncryption": false,
    "enableDoubleEncryption": false,
    "enablePurge": true,
    "enableStreamingIngest": true,
    "engineType": "V3",
    "keyVaultProperties": {
      "keyName": "keyName",
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyVersion": "keyVersion"
    },
    "languageExtensions": {
      "value": [
        {
          "languageExtensionImageName": "Python3_10_8",
          "languageExtensionName": "PYTHON"
        },
        {
          "languageExtensionImageName": "R",
          "languageExtensionName": "R"
        }
      ]
    },
    "provisioningState": "Succeeded",
    "publicIPType": "DualStack",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Disabled"
  },
  "sku": {
    "name": "Standard_L16as_v3",
    "capacity": 2,
    "tier": "Standard"
  }
}

定义

名称 说明
AcceptedAudiences

代表一个被集群信任的接受受众。
AzureSku

Azure SKU definition.
AzureSkuName

SKU 名称。
AzureSkuTier

SKU 层。
CalloutPolicy

外部调用策略配置，包括URI模式、访问类型和服务类型。
CalloutType

标注服务的类型，指定要访问的外部资源或服务的类型。
Cluster

类别代表Kusto集群。
ClusterNetworkAccessFlag

是否限制出站网络访问。 值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
createdByType

创建资源的标识的类型。
EngineType

引擎类型
ErrorAdditionalInfo

资源管理错误附加信息。
ErrorDetail

错误详细信息。
ErrorResponse

错误响应
Identity

资源的标识。
IdentityType

使用的托管标识的类型。 类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除所有标识。
KeyVaultProperties

密钥保管库的属性。
LanguageExtension

语言扩展对象。
LanguageExtensionImageName

语言扩展图片名称。
LanguageExtensionName

可以在 KQL 查询中运行的语言扩展。
LanguageExtensionsList

语言扩展对象列表。
MigrationClusterProperties

表示迁徙中一个集群的性质。
MigrationClusterRole

集群在迁移过程中的作用。
OptimizedAutoscale

包含优化自扩展定义的类。
OutboundAccess

指示是否允许对指定的 URI 模式进行出站访问。
PrivateEndpointConnection

专用终结点连接
PrivateEndpointProperty

连接所属的专用终结点。
PrivateLinkServiceConnectionStateProperty

专用终结点连接的连接状态。
ProvisioningState

资源的预配状态。
PublicIPType

指示要创建的公共 IP 类型 - IPv4（默认）或 DualStack （IPv4 和 IPv6）
PublicNetworkAccess

默认情况下启用对群集的公共网络访问。 禁用后，仅允许与群集建立专用终结点连接
State

资源的状态。
systemData

与创建和上次修改资源相关的元数据。
TrustedExternalTenant

表示集群信任的租户ID。
VirtualNetworkConfiguration

一个包含虚拟网络定义的类。
VnetState

启用后，群集将部署到配置的子网中，禁用后将从子网中删除该群集。
ZoneStatus

表示该星团是带状还是非带状。

AcceptedAudiences

对象

代表一个被集群信任的接受受众。

名称 类型 说明
value

string

表示接受受众的 GUID 或有效 URL。

AzureSku

对象

Azure SKU definition.

名称 类型 说明
capacity

integer (int32)

群集的实例数。
name

AzureSkuName

SKU 名称。
tier

AzureSkuTier

SKU 层。

AzureSkuName

枚举

SKU 名称。

值 说明
Dev(No SLA)_Standard_D11_v2

Dev（No SLA）_Standard_D11_v2
Dev(No SLA)_Standard_E2a_v4

Dev（无SLA）_Standard_E2a_v4
Standard_D11_v2

Standard_D11_v2
Standard_D12_v2

Standard_D12_v2
Standard_D13_v2

Standard_D13_v2
Standard_D14_v2

Standard_D14_v2
Standard_D32d_v4

Standard_D32d_v4
Standard_D16d_v5

Standard_D16d_v5
Standard_D32d_v5

Standard_D32d_v5
Standard_DS13_v2+1TB_PS

Standard_DS13_v2+1TB_PS
Standard_DS13_v2+2TB_PS

Standard_DS13_v2+2TB_PS
Standard_DS14_v2+3TB_PS

Standard_DS14_v2+3TB_PS
Standard_DS14_v2+4TB_PS

Standard_DS14_v2+4TB_PS
Standard_L4s

Standard_L4s
Standard_L8s

Standard_L8s
Standard_L16s

Standard_L16s
Standard_L8s_v2

Standard_L8s_v2
Standard_L16s_v2

Standard_L16s_v2
Standard_L8s_v3

Standard_L8s_v3
Standard_L16s_v3

Standard_L16s_v3
Standard_L32s_v3

Standard_L32s_v3
Standard_L8as_v3

Standard_L8as_v3
Standard_L16as_v3

Standard_L16as_v3
Standard_L32as_v3

Standard_L32as_v3
Standard_E64i_v3

Standard_E64i_v3
Standard_E80ids_v4

Standard_E80ids_v4
Standard_E2a_v4

Standard_E2a_v4
Standard_E4a_v4

Standard_E4a_v4
Standard_E8a_v4

Standard_E8a_v4
Standard_E16a_v4

Standard_E16a_v4
Standard_E8as_v4+1TB_PS

Standard_E8as_v4+1TB_PS
Standard_E8as_v4+2TB_PS

Standard_E8as_v4+2TB_PS
Standard_E16as_v4+3TB_PS

Standard_E16as_v4+3TB_PS
Standard_E16as_v4+4TB_PS

Standard_E16as_v4+4TB_PS
Standard_E8as_v5+1TB_PS

Standard_E8as_v5+1TB_PS
Standard_E8as_v5+2TB_PS

Standard_E8as_v5+2TB_PS
Standard_E16as_v5+3TB_PS

Standard_E16as_v5+3TB_PS
Standard_E16as_v5+4TB_PS

Standard_E16as_v5+4TB_PS
Standard_E2ads_v5

Standard_E2ads_v5
Standard_E4ads_v5

Standard_E4ads_v5
Standard_E8ads_v5

Standard_E8ads_v5
Standard_E16ads_v5

Standard_E16ads_v5
Standard_EC8as_v5+1TB_PS

Standard_EC8as_v5+1TB_PS
Standard_EC8as_v5+2TB_PS

Standard_EC8as_v5+2TB_PS
Standard_EC16as_v5+3TB_PS

Standard_EC16as_v5+3TB_PS
Standard_EC16as_v5+4TB_PS

Standard_EC16as_v5+4TB_PS
Standard_EC8ads_v5

Standard_EC8ads_v5
Standard_EC16ads_v5

Standard_EC16ads_v5
Standard_E8s_v4+1TB_PS

Standard_E8s_v4+1TB_PS
Standard_E8s_v4+2TB_PS

Standard_E8s_v4+2TB_PS
Standard_E16s_v4+3TB_PS

Standard_E16s_v4+3TB_PS
Standard_E16s_v4+4TB_PS

Standard_E16s_v4+4TB_PS
Standard_E8s_v5+1TB_PS

Standard_E8s_v5+1TB_PS
Standard_E8s_v5+2TB_PS

Standard_E8s_v5+2TB_PS
Standard_E16s_v5+3TB_PS

Standard_E16s_v5+3TB_PS
Standard_E16s_v5+4TB_PS

Standard_E16s_v5+4TB_PS
Standard_E2d_v4

Standard_E2d_v4
Standard_E4d_v4

Standard_E4d_v4
Standard_E8d_v4

Standard_E8d_v4
Standard_E16d_v4

Standard_E16d_v4
Standard_E2d_v5

Standard_E2d_v5
Standard_E4d_v5

Standard_E4d_v5
Standard_E8d_v5

Standard_E8d_v5
Standard_E16d_v5

Standard_E16d_v5

AzureSkuTier

枚举

SKU 层。

值 说明
Basic

基本
Standard

标准

CalloutPolicy

对象

外部调用策略配置，包括URI模式、访问类型和服务类型。

名称 类型 说明
calloutId

string

标注配置的唯一标识符。
calloutType

CalloutType

标注服务的类型，指定要访问的外部资源或服务的类型。
calloutUriRegex

string

标注 URI 的正则表达式或 FQDN 模式。
outboundAccess

OutboundAccess

指示是否允许对指定的 URI 模式进行出站访问。

CalloutType

枚举

标注服务的类型，指定要访问的外部资源或服务的类型。

值 说明
kusto

Kusto 数据分析服务
sql

sql
cosmosdb

cosmosdb
external_data

external_data
azure_digital_twins

azure_digital_twins
sandbox_artifacts

sandbox_artifacts
webapi

WebAPI 的
mysql

mysql
postgresql

postgresql
genevametrics

Genevametrics
azure_openai

azure_openai

Cluster

对象

类别代表Kusto集群。

名称 类型 默认值 说明
etag

string

“如果在响应正文中提供了 etag，则也可以根据正常的 etag 约定将其作为标头提供。 实体标记用于比较同一请求资源的两个或多个实体。 HTTP/1.1 在 etag（第 14.19 节）、If-Match（第 14.24 节）、If-None-Match（第 14.26 节）和 If-Range（第 14.27 节）标头字段中使用实体标签。
id

string

资源的完全限定资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

Identity

群集的标识（如果已配置）。
location

string

资源所在的地理位置
name

string

资源的名称
properties.acceptedAudiences

AcceptedAudiences[]

群集的接受受众。
properties.allowedFqdnList

string[]

群集出口允许的 FQDN（完全限定域名）列表。
properties.allowedIpRangeList

string[]

允许连接到群集的 CIDR 格式的 IP 列表。
properties.calloutPolicies

CalloutPolicy[]

群集出口的标注策略列表。
properties.dataIngestionUri

string

集群数据导入URI。
properties.enableAutoStop

boolean

True

一个布尔值，该值指示群集是否可以自动停止（由于数据不足或没有活动数天）。
properties.enableDiskEncryption

boolean

False

一个布尔值，该值指示群集的磁盘是否已加密。
properties.enableDoubleEncryption

boolean

False

一个布尔值，该值指示是否启用了双重加密。
properties.enablePurge

boolean

False

一个布尔值，该值指示是否启用了清除操作。
properties.enableStreamingIngest

boolean

False

一个布尔值，该值指示是否启用了流式引入。
properties.engineType

EngineType

V3

引擎类型
properties.keyVaultProperties

KeyVaultProperties

群集加密的 KeyVault 属性。
properties.languageExtensions

LanguageExtensionsList

群集的语言扩展列表。
properties.migrationCluster

MigrationClusterProperties

涉及迁移至/离开该集群的节点集群属性。
properties.optimizedAutoscale

OptimizedAutoscale

优化的自动缩放定义。
properties.privateEndpointConnections

PrivateEndpointConnection[]

专用终结点连接的列表。
properties.provisioningState

ProvisioningState

资源的预配状态。
properties.publicIPType

PublicIPType

IPv4

指示要创建的公共 IP 类型 - IPv4（默认）或 DualStack （IPv4 和 IPv6）
properties.publicNetworkAccess

PublicNetworkAccess

Enabled

默认情况下启用对群集的公共网络访问。 禁用后，仅允许与群集建立专用终结点连接
properties.restrictOutboundNetworkAccess

ClusterNetworkAccessFlag

Disabled

是否限制出站网络访问。 值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
properties.state

State

资源的状态。
properties.stateReason

string

集群现状的原因。
properties.trustedExternalTenants

TrustedExternalTenant[]

群集的外部租户。
properties.uri

string

上呼吸道感染群。
properties.virtualClusterGraduationProperties

string (password)

虚拟群集毕业属性
properties.virtualNetworkConfiguration

VirtualNetworkConfiguration

虚拟网络定义。
properties.zoneStatus

ZoneStatus

表示该星团是带状还是非带状。
sku

AzureSku

群集的 SKU。
systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags

object

资源标记。
type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”
zones

string[]

可用性区域。

ClusterNetworkAccessFlag

枚举

是否限制出站网络访问。 值是可选的，但如果传入，则必须为“Enabled”或“Disabled”

值 说明
Enabled

已启用
Disabled

已禁用

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

对象
名称 类型 说明
clientId

string

用户分配标识的客户端 ID。
principalId

string

用户分配标识的主体 ID。

createdByType

枚举

创建资源的标识的类型。

值 说明
User
Application
ManagedIdentity
Key

EngineType

枚举

引擎类型

值 说明
V2

V2
V3

V3

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。
type

string

其他信息类型。

ErrorDetail

对象

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。
code

string

错误代码。
details

ErrorDetail[]

错误详细信息。
message

string

错误消息。
target

string

错误目标。

ErrorResponse

对象

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

Identity

对象

资源的标识。

名称 类型 说明
principalId

string

资源标识的主体 ID。
tenantId

string

资源的租户 ID。
type

IdentityType

使用的托管标识的类型。 类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除所有标识。
userAssignedIdentities

<string,  ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties>

与 Kusto 群集关联的用户标识列表。 用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。

IdentityType

枚举

使用的托管标识的类型。 类型“SystemAssigned，UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除所有标识。

值 说明
None

没有
SystemAssigned

SystemAssigned
UserAssigned

UserAssigned
SystemAssigned, UserAssigned

系统分配、用户分配

KeyVaultProperties

对象

密钥保管库的属性。

名称 类型 说明
federatedIdentityClientId

string

多租户 Microsoft Entra 应用的应用程序（客户端）ID。 用于跨租户客户管理密钥场景，加密密钥存储在与集群不同的租户中。 应用程序必须配置用户分配的托管身份作为联邦身份凭证。
keyName

string

密钥保管库密钥的名称。
keyVaultUri

string

密钥保管库的 URI。
keyVersion

string

密钥保管库密钥的版本。
userIdentity

string

有权访问密钥的用户分配标识（ARM 资源 ID）。 该身份必须对密钥库密钥拥有“获取”、“封装密钥”和“展开密钥”权限，或者被赋予“密钥库加密服务加密用户”角色。

LanguageExtension

对象

语言扩展对象。

名称 类型 说明
languageExtensionCustomImageName

string

沙盒自定义图片名称应启用为活跃语言扩展。 沙箱自定义映像是集群子资源。 当该属性被设置时，LanguageExtensionImageName 应设置为“PythonCustomImage”。
languageExtensionImageName

LanguageExtensionImageName

语言扩展映像名称。
languageExtensionName

LanguageExtensionName

语言扩展名称。

LanguageExtensionImageName

枚举

语言扩展图片名称。

值 说明
R

R
Python3_6_5

Python3_6_5
Python3_10_8

Python3_10_8
Python3_10_8_DL

Python3_10_8_DL
PythonCustomImage

Python定制图片
Python3_11_7

Python3_11_7
Python3_11_7_DL

Python3_11_7_DL

LanguageExtensionName

枚举

可以在 KQL 查询中运行的语言扩展。

值 说明
PYTHON

蟒
R

R

LanguageExtensionsList

对象

语言扩展对象列表。

名称 类型 说明
nextLink

string

链接到下一页资源。
value

LanguageExtension[]

语言扩展列表。

MigrationClusterProperties

对象

表示迁徙中一个集群的性质。

名称 类型 说明
dataIngestionUri

string

集群的公开数据导入网址。
id

string

集群的资源ID。
role

MigrationClusterRole

集群在迁移过程中的作用。
uri

string

集群的公共网址。

MigrationClusterRole

枚举

集群在迁移过程中的作用。

值 说明
Source

来源
Destination

目的地

OptimizedAutoscale

对象

包含优化自扩展定义的类。

名称 类型 说明
isEnabled

boolean

一个布尔值，该值指示是否启用了优化的自动缩放功能。
maximum

integer (int32)

允许的最大实例计数。
minimum

integer (int32)

允许的最小实例计数。
version

integer (int32)

定义的模板版本，例如 1。

OutboundAccess

枚举

指示是否允许对指定的 URI 模式进行出站访问。

值 说明
Allow

允许
Deny

Deny

PrivateEndpointConnection

对象

专用终结点连接

名称 类型 说明
id

string

资源的完全限定资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

资源的名称
properties.groupId

string

专用终结点的组 ID。
properties.privateEndpoint

PrivateEndpointProperty

连接所属的专用终结点。
properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionStateProperty

专用终结点连接的连接状态。
properties.provisioningState

string

专用终结点的预配状态。
systemData

systemData

包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type

string

资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

PrivateEndpointProperty

对象

连接所属的专用终结点。

名称 类型 说明
id

string

专用终结点的资源 ID。

PrivateLinkServiceConnectionStateProperty

对象

专用终结点连接的连接状态。

名称 类型 说明
actionsRequired

string

除基本工作流之外所需的任何作（批准/拒绝/断开连接）
description

string

专用链接服务连接说明。
status

string

专用链接服务连接状态。

ProvisioningState

枚举

资源的预配状态。

值 说明
Running

Running
Creating

创建
Deleting

正在删除
Succeeded

成功
Failed

Failed
Moving

移动
Canceled

已取消

PublicIPType

枚举

指示要创建的公共 IP 类型 - IPv4（默认）或 DualStack （IPv4 和 IPv6）

值 说明
IPv4

IPv4
DualStack

双栈

PublicNetworkAccess

枚举

默认情况下启用对群集的公共网络访问。 禁用后，仅允许与群集建立专用终结点连接

值 说明
Enabled

已启用
Disabled

已禁用
SecuredByPerimeter

SecuredByPerimeter

State

枚举

资源的状态。

值 说明
Creating

创建
Unavailable

不可用
Running

Running
Deleting

正在删除
Deleted

已删除
Stopping

正在停止
Stopped

已停止
Starting

正在启动
Updating

更新
Migrated

已迁移

systemData

对象

与创建和上次修改资源相关的元数据。

名称 类型 说明
createdAt

string (date-time)

资源创建时间戳（UTC）。
createdBy

string

创建资源的标识。
createdByType

createdByType

创建资源的标识的类型。
lastModifiedAt

string (date-time)

上次修改的资源时间戳（UTC）
lastModifiedBy

string

上次修改资源的标识。
lastModifiedByType

createdByType

上次修改资源的标识的类型。

TrustedExternalTenant

对象

表示集群信任的租户ID。

名称 类型 说明
value

string

表示外部租户的 GUID。

VirtualNetworkConfiguration

对象

一个包含虚拟网络定义的类。

名称 类型 默认值 说明
dataManagementPublicIpId

string

数据管理的服务公共 IP 地址资源 ID。
enginePublicIpId

string

引擎服务的公共 IP 地址资源 ID。
state

VnetState

Enabled

启用后，群集将部署到配置的子网中，禁用后将从子网中删除该群集。
subnetId

string

子网资源 ID。

VnetState

枚举

启用后，群集将部署到配置的子网中，禁用后将从子网中删除该群集。

值 说明
Enabled

已启用
Disabled

已禁用

ZoneStatus

枚举

表示该星团是带状还是非带状。

值 说明
NonZonal

非分区
ZonalInconsistency

区域不一致
Zonal

区域