Clusters - Create Or Update

Servicio:: Azure Kusto

Versión de la API:: 2025-02-14

Cree o actualice un clúster de Kusto.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
clusterName	path	True	string pattern: ^.*$	Nombre del clúster de Kusto.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
If-Match		string	ETag del clúster. Omita este valor para sobrescribir siempre el clúster actual. Especifique el valor de ETag visto por última vez para evitar que se sobrescriba accidentalmente los cambios simultáneos.
If-None-Match		string	Establézcalo en "*" para permitir la creación de un nuevo clúster, pero para evitar la actualización de un clúster existente. Otros valores darán como resultado una respuesta con error de condición previa 412.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
location	True	string	Ubicación geográfica donde reside el recurso
sku	True	AzureSku	SKU del clúster.
identity		Identity	Identidad del clúster, si está configurada.
properties.acceptedAudiences		AcceptedAudiences[]	Audiencias aceptadas del clúster.
properties.allowedFqdnList		string[]	Lista de FQDN permitidos (nombre de dominio completo) para la salida del clúster.
properties.allowedIpRangeList		string[]	La lista de ips con el formato CIDR permitido para conectarse al clúster.
properties.calloutPolicies		CalloutPolicy[]	Lista de directivas de llamada para la salida del clúster.
properties.enableAutoStop		boolean	Valor booleano que indica si el clúster se podría detener automáticamente (debido a la falta de datos o a ninguna actividad durante muchos días).
properties.enableDiskEncryption		boolean	Valor booleano que indica si los discos del clúster están cifrados.
properties.enableDoubleEncryption		boolean	Valor booleano que indica si el cifrado doble está habilitado.
properties.enablePurge		boolean	Valor booleano que indica si las operaciones de purga están habilitadas.
properties.enableStreamingIngest		boolean	Valor booleano que indica si la ingesta de streaming está habilitada.
properties.engineType		EngineType	Tipo de motor
properties.keyVaultProperties		KeyVaultProperties	Propiedades de KeyVault para el cifrado del clúster.
properties.languageExtensions		LanguageExtensionsList	Lista de extensiones de lenguaje del clúster.
properties.optimizedAutoscale		OptimizedAutoscale	Definición de escalado automático optimizada.
properties.publicIPType		PublicIPType	Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6)
properties.publicNetworkAccess		PublicNetworkAccess	El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster.
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
properties.trustedExternalTenants		TrustedExternalTenant[]	Inquilinos externos del clúster.
properties.virtualClusterGraduationProperties		string (password)	Propiedades de graduación de clúster virtual
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Definición de red virtual.
tags		object	Etiquetas de recursos.
zones		string[]	Zonas de disponibilidad.

Respuestas

Nombre	Tipo	Description
200 OK	Cluster	Operación de actualización del recurso "Clúster" correcta
201 Created	Cluster	Operación de creación de recursos "Clúster" realizada correctamente Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

Cluster

Operación de actualización del recurso "Clúster" correcta

201 Created

Cluster

Operación de creación de recursos "Clúster" realizada correctamente

Encabezados

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

KustoClusterCreateWithCMKFederatedIdentity

KustoClusterCreateWithCMKUserAssignedIdentity

KustoClustersCreateOrUpdate

KustoClusterCreateWithCMKFederatedIdentity

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
}

status code:: 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

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
}

status code:: 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

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
  }
}

status code:: 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"
  }
}

Definiciones

Nombre	Description
AcceptedAudiences	Representa una audiencia aceptada en la que el clúster confía.
AzureSku	Azure SKU definition.
AzureSkuName	Nombre de la SKU.
AzureSkuTier	Nivel de SKU.
CalloutPolicy	Configuración para políticas de callout externas, incluyendo patrones de URI, tipos de acceso y tipos de servicio.
CalloutType	Tipo del servicio de llamada, especificando el tipo de recurso externo o servicio al que se accede.
Cluster	Clase que representa un grupo Kusto.
ClusterNetworkAccessFlag	Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties
createdByType	Tipo de identidad que creó el recurso.
EngineType	Tipo de motor
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
Identity	Identidad del recurso.
IdentityType	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará todas las identidades.
KeyVaultProperties	Propiedades del almacén de claves.
LanguageExtension	El objeto de extensión del lenguaje.
LanguageExtensionImageName	Nombre de imagen de la extensión de idioma.
LanguageExtensionName	Extensión de lenguaje que puede ejecutarse dentro de la consulta KQL.
LanguageExtensionsList	La lista de objetos de extensión del lenguaje.
MigrationClusterProperties	Representa una propiedad de un clúster que forma parte de una migración.
MigrationClusterRole	El papel del clúster en el proceso de migración.
OptimizedAutoscale	Una clase que contiene la definición optimizada de escala automática.
OutboundAccess	Indica si se permite el acceso saliente para el patrón de URI especificado.
PrivateEndpointConnection	Una conexión de punto de conexión privado
PrivateEndpointProperty	Punto de conexión privado al que pertenece la conexión.
PrivateLinkServiceConnectionStateProperty	Estado de conexión de la conexión de punto de conexión privado.
ProvisioningState	Estado aprovisionado del recurso.
PublicIPType	Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6)
PublicNetworkAccess	El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster.
State	El estado del recurso.
systemData	Metadatos relativos a la creación y última modificación del recurso.
TrustedExternalTenant	Representa un ID de tenant en el que el clúster confía.
VirtualNetworkConfiguration	Una clase que contiene definición de red virtual.
VnetState	Cuando se habilita, el clúster se implementa en la subred configurada, cuando se deshabilite se quitará de la subred.
ZoneStatus	Indica si el grupo es zonal o no zonal.

AcceptedAudiences

Objeto

Representa una audiencia aceptada en la que el clúster confía.

Nombre	Tipo	Description
value	string	GUID o dirección URL válida que representa una audiencia aceptada.

AzureSku

Objeto

Azure SKU definition.

Nombre	Tipo	Description
capacity	integer (int32)	Número de instancias del clúster.
name	AzureSkuName	Nombre de la SKU.
tier	AzureSkuTier	Nivel de SKU.

AzureSkuName

Enumeración

Nombre de la SKU.

Valor	Description
Dev(No SLA)_Standard_D11_v2	Dev (sin SLA)_Standard_D11_v2
Dev(No SLA)_Standard_E2a_v4	Dev (Sin 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

Enumeración

Nivel de SKU.

Valor	Description
Basic	Básico
Standard	Estándar

CalloutPolicy

Objeto

Configuración para políticas de callout externas, incluyendo patrones de URI, tipos de acceso y tipos de servicio.

Nombre	Tipo	Description
calloutId	string	Identificador único de la configuración de la llamada.
calloutType	CalloutType	Tipo del servicio de llamada, especificando el tipo de recurso externo o servicio al que se accede.
calloutUriRegex	string	Expresión regular o patrón FQDN para el URI de la llamada.
outboundAccess	OutboundAccess	Indica si se permite el acceso saliente para el patrón de URI especificado.

CalloutType

Enumeración

Tipo del servicio de llamada, especificando el tipo de recurso externo o servicio al que se accede.

Valor	Description
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

Objeto

Clase que representa un grupo Kusto.

Nombre	Tipo	Valor predeterminado	Description
etag	string		"Si se proporciona etag en el cuerpo de la respuesta, también se puede proporcionar como un encabezado según la convención etag normal. Las etiquetas de entidad se usan para comparar dos o más entidades del mismo recurso solicitado. HTTP / 1.1 usa etiquetas de entidad en los campos de encabezado etag (sección 14.19), If-Match (sección 14.24), If-None-Match (sección 14.26) y If-Range (sección 14.27)").
id	string		Identificador de recurso completo para el recurso. Ej: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identidad del clúster, si está configurada.
location	string		Ubicación geográfica donde reside el recurso
name	string		Nombre del recurso
properties.acceptedAudiences	AcceptedAudiences[]		Audiencias aceptadas del clúster.
properties.allowedFqdnList	string[]		Lista de FQDN permitidos (nombre de dominio completo) para la salida del clúster.
properties.allowedIpRangeList	string[]		La lista de ips con el formato CIDR permitido para conectarse al clúster.
properties.calloutPolicies	CalloutPolicy[]		Lista de directivas de llamada para la salida del clúster.
properties.dataIngestionUri	string		El URI de ingesta de datos del clúster.
properties.enableAutoStop	boolean	True	Valor booleano que indica si el clúster se podría detener automáticamente (debido a la falta de datos o a ninguna actividad durante muchos días).
properties.enableDiskEncryption	boolean	False	Valor booleano que indica si los discos del clúster están cifrados.
properties.enableDoubleEncryption	boolean	False	Valor booleano que indica si el cifrado doble está habilitado.
properties.enablePurge	boolean	False	Valor booleano que indica si las operaciones de purga están habilitadas.
properties.enableStreamingIngest	boolean	False	Valor booleano que indica si la ingesta de streaming está habilitada.
properties.engineType	EngineType	V3	Tipo de motor
properties.keyVaultProperties	KeyVaultProperties		Propiedades de KeyVault para el cifrado del clúster.
properties.languageExtensions	LanguageExtensionsList		Lista de extensiones de lenguaje del clúster.
properties.migrationCluster	MigrationClusterProperties		Propiedades del clúster de pares implicado en una migración hacia/desde este clúster.
properties.optimizedAutoscale	OptimizedAutoscale		Definición de escalado automático optimizada.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Lista de conexiones de punto de conexión privado.
properties.provisioningState	ProvisioningState		Estado aprovisionado del recurso.
properties.publicIPType	PublicIPType	IPv4	Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster.
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".
properties.state	State		El estado del recurso.
properties.stateReason	string		La razón del estado actual del cúmulo.
properties.trustedExternalTenants	TrustedExternalTenant[]		Inquilinos externos del clúster.
properties.uri	string		La URI del clúster.
properties.virtualClusterGraduationProperties	string (password)		Propiedades de graduación de clúster virtual
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definición de red virtual.
properties.zoneStatus	ZoneStatus		Indica si el grupo es zonal o no zonal.
sku	AzureSku		SKU del clúster.
systemData	systemData		Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object		Etiquetas de recursos.
type	string		Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
zones	string[]		Zonas de disponibilidad.

ClusterNetworkAccessFlag

Enumeración

Si se va a restringir o no el acceso de red saliente. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

Valor	Description
Enabled	Habilitado
Disabled	Deshabilitado

ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties

Objeto

Nombre	Tipo	Description
clientId	string	Identificador de cliente de la identidad asignada por el usuario.
principalId	string	Identificador principal de la identidad asignada por el usuario.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

EngineType

Enumeración

Tipo de motor

Valor	Description
V2	V2
V3	V3

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

Identity

Objeto

Identidad del recurso.

Nombre	Tipo	Description
principalId	string	Identificador de entidad de seguridad de la identidad del recurso.
tenantId	string	Identificador de inquilino del recurso.
type	IdentityType	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará todas las identidades.
userAssignedIdentities	<string, ComponentsSgqdofSchemasIdentityPropertiesUserassignedidentitiesAdditionalproperties>	Lista de identidades de usuario asociadas al clúster de Kusto. Las referencias de clave de diccionario de identidad de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumeración

Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará todas las identidades.

Valor	Description
None	Ninguno
SystemAssigned	SystemAssigned
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	SystemAssigned, UserAssigned

KeyVaultProperties

Objeto

Propiedades del almacén de claves.

Nombre	Tipo	Description
federatedIdentityClientId	string	El ID de la aplicación (cliente) de la aplicación Microsoft Entra multi-inquilino. Se utiliza en escenarios de clave gestionada por el cliente entre inquilinos, donde la clave de cifrado se almacena en un tenant diferente al del clúster. La aplicación debe configurarse con la identidad gestionada asignada por el usuario como credencial de identidad federada.
keyName	string	Nombre de la clave del almacén de claves.
keyVaultUri	string	Identificador URI del almacén de claves.
keyVersion	string	Versión de la clave del almacén de claves.
userIdentity	string	Identidad asignada por el usuario (identificador de recurso de ARM) que tiene acceso a la clave. La identidad debe tener los permisos 'Obtener', 'Envolver la clave' y 'Desplegar la clave' en la clave de Key Vault, o tener asignado el rol de 'Usuario de Cifrado del Servicio Cripto de Key Vault'.

LanguageExtension

Objeto

El objeto de extensión del lenguaje.

Nombre	Tipo	Description
languageExtensionCustomImageName	string	El nombre de la imagen personalizada del sandbox que debería estar habilitado como extensión de lenguaje activa. Sandbox custom image es un subrecurso de clúster. Cuando esta propiedad está activada, LanguageExtensionImageName debe estar en 'PythonCustomImage'.
languageExtensionImageName	LanguageExtensionImageName	Nombre de la imagen de la extensión de idioma.
languageExtensionName	LanguageExtensionName	Nombre de la extensión de lenguaje.

LanguageExtensionImageName

Enumeración

Nombre de imagen de la extensión de idioma.

Valor	Description
R	R
Python3_6_5	Python3_6_5
Python3_10_8	Python3_10_8
Python3_10_8_DL	Python3_10_8_DL
PythonCustomImage	PythonCustomImage
Python3_11_7	Python3_11_7
Python3_11_7_DL	Python3_11_7_DL

LanguageExtensionName

Enumeración

Extensión de lenguaje que puede ejecutarse dentro de la consulta KQL.

Valor	Description
PYTHON	PITÓN
R	R

LanguageExtensionsList

Objeto

La lista de objetos de extensión del lenguaje.

Nombre	Tipo	Description
nextLink	string	El enlace a la siguiente página de recursos.
value	LanguageExtension[]	Lista de extensiones de lenguaje.

MigrationClusterProperties

Objeto

Representa una propiedad de un clúster que forma parte de una migración.

Nombre	Tipo	Description
dataIngestionUri	string	La URL de ingesta de datos públicos del clúster.
id	string	El ID de recurso del clúster.
role	MigrationClusterRole	El papel del clúster en el proceso de migración.
uri	string	La URL pública del clúster.

MigrationClusterRole

Enumeración

El papel del clúster en el proceso de migración.

Valor	Description
Source	Fuente
Destination	Destino

OptimizedAutoscale

Objeto

Una clase que contiene la definición optimizada de escala automática.

Nombre	Tipo	Description
isEnabled	boolean	Valor booleano que indica si la característica de escalabilidad automática optimizada está habilitada o no.
maximum	integer (int32)	Número máximo de instancias permitidas.
minimum	integer (int32)	Número mínimo de instancias permitidas.
version	integer (int32)	Versión de la plantilla definida, por ejemplo 1.

OutboundAccess

Enumeración

Indica si se permite el acceso saliente para el patrón de URI especificado.

Valor	Description
Allow	Permitir
Deny	Negar

PrivateEndpointConnection

Objeto

Una conexión de punto de conexión privado

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Ej: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso
properties.groupId	string	Id. de grupo del punto de conexión privado.
properties.privateEndpoint	PrivateEndpointProperty	Punto de conexión privado al que pertenece la conexión.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de conexión de la conexión de punto de conexión privado.
properties.provisioningState	string	Estado de aprovisionamiento del punto de conexión privado.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Objeto

Punto de conexión privado al que pertenece la conexión.

Nombre	Tipo	Description
id	string	Identificador de recurso del punto de conexión privado.

PrivateLinkServiceConnectionStateProperty

Objeto

Estado de conexión de la conexión de punto de conexión privado.

Nombre	Tipo	Description
actionsRequired	string	Cualquier acción necesaria más allá del flujo de trabajo básico (aprobar, rechazar o desconectar)
description	string	Descripción de la conexión del servicio private link.
status	string	Estado de conexión del servicio private link.

ProvisioningState

Enumeración

Estado aprovisionado del recurso.

Valor	Description
Running	Correr
Creating	Creando
Deleting	Eliminando
Succeeded	Succeeded
Failed	Fallido
Moving	Conmovedor
Canceled	Cancelado

PublicIPType

Enumeración

Indica qué tipo de dirección IP pública se va a crear: IPv4 (valor predeterminado) o DualStack (IPv4 e IPv6)

Valor	Description
IPv4	IPv4
DualStack	DualStack

PublicNetworkAccess

Enumeración

El acceso de red pública al clúster está habilitado de forma predeterminada. Cuando está deshabilitada, solo se permite la conexión de punto de conexión privado al clúster.

Valor	Description
Enabled	Habilitado
Disabled	Deshabilitado
SecuredByPerimeter	AseguradoPorPerímetro

State

Enumeración

El estado del recurso.

Valor	Description
Creating	Creando
Unavailable	No disponible
Running	Correr
Deleting	Eliminando
Deleted	Borrado
Stopping	Parar
Stopped	Detenido
Starting	Iniciando
Updating	Actualización
Migrated	Migrado

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

TrustedExternalTenant

Objeto

Representa un ID de tenant en el que el clúster confía.

Nombre	Tipo	Description
value	string	GUID que representa un inquilino externo.

VirtualNetworkConfiguration

Objeto

Una clase que contiene definición de red virtual.

Nombre	Tipo	Valor predeterminado	Description
dataManagementPublicIpId	string		Identificador de recurso de la dirección IP pública del servicio de administración de datos.
enginePublicIpId	string		Identificador de recurso de la dirección IP pública del servicio de motor.
state	VnetState	Enabled	Cuando se habilita, el clúster se implementa en la subred configurada, cuando se deshabilite se quitará de la subred.
subnetId	string		Identificador del recurso de subred.

VnetState

Enumeración

Cuando se habilita, el clúster se implementa en la subred configurada, cuando se deshabilite se quitará de la subred.

Valor	Description
Enabled	Habilitado
Disabled	Deshabilitado

ZoneStatus

Enumeración

Indica si el grupo es zonal o no zonal.

Valor	Description
NonZonal	No Zonal
ZonalInconsistency	Inconsistencia ZonalT
Zonal	Zonal