Clusters - Create Or Update

Vytvořte nebo aktualizujte cluster Kusto.

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

Parametry identifikátoru URI

Name In Required Type Description
clusterName
path True
  • string

Název clusteru Kusto.

resourceGroupName
path True
  • string

Název skupiny prostředků, která obsahuje cluster Kusto.

subscriptionId
path True
  • string

Získá přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří část identifikátoru URI pro každé volání služby.

api-version
query True
  • string

Verze rozhraní API klienta

Text požadavku

Name Required Type Description
location True
  • string

Geografické umístění, kde je prostředek umístěn

sku True

SKU clusteru.

identity

Identita clusteru, je-li nakonfigurován.

properties.enableDiskEncryption
  • boolean

Logická hodnota, která indikuje, jestli jsou disky clusteru šifrované.

properties.enableDoubleEncryption
  • boolean

Logická hodnota, která označuje, zda je povoleno šifrování typu Double.

properties.enablePurge
  • boolean

Logická hodnota, která určuje, zda jsou povoleny operace vyprázdnění.

properties.enableStreamingIngest
  • boolean

Logická hodnota, která určuje, zda je povolena možnost ingestování datových proudů.

properties.engineType

Typ modulu

properties.keyVaultProperties

Vlastnosti trezoru klíčů pro šifrování clusteru

properties.optimizedAutoscale

Optimalizovaná definice automatického škálování

properties.trustedExternalTenants

Externí klienti clusteru.

properties.virtualNetworkConfiguration

Definice virtuální sítě.

tags
  • object

Značky prostředků.

zones
  • string[]

Zóny dostupnosti clusteru.

Odpovědi

Name Type Description
200 OK

Cluster se úspěšně aktualizoval.

201 Created

Cluster se úspěšně vytvořil.

Other Status Codes

Chybová odezva popisující, proč se operace nezdařila

Příklady

KustoClustersCreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/clusters/kustoclusterrptest4?api-version=2020-09-18
{
  "location": "westus",
  "sku": {
    "name": "Standard_L8s",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false
  }
}

Sample Response

{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/KustoClusterRPTest4",
  "name": "KustoClusterRPTest4",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "keyVaultProperties": {
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyName": "keyName",
      "keyVersion": "keyVersion"
    },
    "engineType": "V2"
  },
  "sku": {
    "name": "Standard_L8s",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "userAssignedIdentities": {}
  }
}
{
  "id": "/subscriptions/12345678-1234-1234-1234-123456789098/resourceGroups/kustorptest/providers/Microsoft.Kusto/Clusters/KustoClusterRPTest4",
  "name": "KustoClusterRPTest4",
  "type": "Microsoft.Kusto/Clusters",
  "location": "westus",
  "properties": {
    "provisioningState": "Succeeded",
    "enableStreamingIngest": true,
    "enablePurge": true,
    "enableDoubleEncryption": false,
    "keyVaultProperties": {
      "keyVaultUri": "https://dummy.keyvault.com",
      "keyName": "keyName",
      "keyVersion": "keyVersion"
    },
    "engineType": "V2"
  },
  "sku": {
    "name": "Standard_L8s",
    "capacity": 2,
    "tier": "Standard"
  },
  "identity": {
    "type": "SystemAssigned",
    "tenantId": "b932977f-6277-4ab7-a2cd-5bd21f07aaf4",
    "principalId": "faabad1f-4876-463c-af9d-6ba2d2d2394c",
    "userAssignedIdentities": {}
  }
}

Definice

AzureSku

Definice SKU Azure

AzureSkuName

Název SKU

AzureSkuTier

Úroveň SKU.

CloudError

Odpověď na chybu od Kusto.

CloudErrorBody

Odpověď na chybu od Kusto.

Cluster

Třída představující cluster Kusto

EngineType

Typ modulu

Identity

Identita prostředku

IdentityType

Typ použité spravované identity. Typ "SystemAssigned, UserAssigned" zahrnuje implicitně vytvořenou identitu a sadu uživatelsky přiřazených identit. Typ None odstraní všechny identity.

KeyVaultProperties

Vlastnosti trezoru klíčů

LanguageExtension

Objekt rozšíření jazyka.

languageExtensionName

Název jazykové rozšíření.

LanguageExtensionsList

Seznam objektů rozšíření jazyka.

OptimizedAutoscale

Třída, která obsahuje optimalizovanou definici automatického škálování.

ProvisioningState

Zřízený stav prostředku.

State

Stav prostředku.

TrustedExternalTenant

Představuje ID tenanta, kterému cluster důvěřuje.

UserAssignedIdentities

Seznam identit uživatelů přidružených k Kusto clusteru. Odkazy na klíč uživatele slovníku identity budou mít ID prostředků ARM ve formátu: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} '.

VirtualNetworkConfiguration

Třída, která obsahuje definici virtuální sítě.

AzureSku

Definice SKU Azure

Name Type Description
capacity
  • integer

Počet instancí clusteru

name

Název SKU

tier

Úroveň SKU.

AzureSkuName

Název SKU

Name Type Description
Dev(No SLA)_Standard_D11_v2
  • string
Dev(No SLA)_Standard_E2a_v4
  • string
Standard_D11_v2
  • string
Standard_D12_v2
  • string
Standard_D13_v2
  • string
Standard_D14_v2
  • string
Standard_DS13_v2+1TB_PS
  • string
Standard_DS13_v2+2TB_PS
  • string
Standard_DS14_v2+3TB_PS
  • string
Standard_DS14_v2+4TB_PS
  • string
Standard_E16a_v4
  • string
Standard_E16as_v4+3TB_PS
  • string
Standard_E16as_v4+4TB_PS
  • string
Standard_E2a_v4
  • string
Standard_E4a_v4
  • string
Standard_E64i_v3
  • string
Standard_E8a_v4
  • string
Standard_E8as_v4+1TB_PS
  • string
Standard_E8as_v4+2TB_PS
  • string
Standard_L16s
  • string
Standard_L4s
  • string
Standard_L8s
  • string

AzureSkuTier

Úroveň SKU.

Name Type Description
Basic
  • string
Standard
  • string

CloudError

Odpověď na chybu od Kusto.

Name Type Description
error

Odpověď na chybu od Kusto.

CloudErrorBody

Odpověď na chybu od Kusto.

Name Type Description
code
  • string

Identifikátor chyby Kódy jsou invariantní a mají být zpracovány programově.

details

Seznam dalších podrobností o chybě.

message
  • string

Zpráva popisující chybu, která je vhodná pro zobrazení v uživatelském rozhraní.

target
  • string

Cíl konkrétní chyby. Například název vlastnosti v chybě.

Cluster

Třída představující cluster Kusto

Name Type Description
id
  • string

Plně kvalifikované ID prostředku pro daný prostředek. Ex-/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identita clusteru, je-li nakonfigurován.

location
  • string

Geografické umístění, kde je prostředek umístěn

name
  • string

Název prostředku

properties.dataIngestionUri
  • string

Identifikátor URI pro přijímání dat clusteru.

properties.enableDiskEncryption
  • boolean

Logická hodnota, která indikuje, jestli jsou disky clusteru šifrované.

properties.enableDoubleEncryption
  • boolean

Logická hodnota, která označuje, zda je povoleno šifrování typu Double.

properties.enablePurge
  • boolean

Logická hodnota, která určuje, zda jsou povoleny operace vyprázdnění.

properties.enableStreamingIngest
  • boolean

Logická hodnota, která určuje, zda je povolena možnost ingestování datových proudů.

properties.engineType

Typ modulu

properties.keyVaultProperties

Vlastnosti trezoru klíčů pro šifrování clusteru

properties.languageExtensions

Seznam jazykových rozšíření clusteru

properties.optimizedAutoscale

Optimalizovaná definice automatického škálování

properties.provisioningState

Zřízený stav prostředku.

properties.state

Stav prostředku.

properties.stateReason
  • string

Důvod pro aktuální stav clusteru.

properties.trustedExternalTenants

Externí klienti clusteru.

properties.uri
  • string

Identifikátor URI clusteru

properties.virtualNetworkConfiguration

Definice virtuální sítě.

sku

SKU clusteru.

tags
  • object

Značky prostředků.

type
  • string

Typ prostředku. Například "Microsoft. COMPUTE/virtualMachines" nebo "Microsoft. Storage/storageAccounts"

zones
  • string[]

Zóny dostupnosti clusteru.

EngineType

Typ modulu

Name Type Description
V2
  • string
V3
  • string

Identity

Identita prostředku

Name Type Description
principalId
  • string

ID objektu zabezpečení identity prostředku

tenantId
  • string

ID tenanta prostředku

type

Typ použité spravované identity. Typ "SystemAssigned, UserAssigned" zahrnuje implicitně vytvořenou identitu a sadu uživatelsky přiřazených identit. Typ None odstraní všechny identity.

userAssignedIdentities

Seznam identit uživatelů přidružených k Kusto clusteru. Odkazy na klíč uživatele slovníku identity budou mít ID prostředků ARM ve formátu: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} '.

IdentityType

Typ použité spravované identity. Typ "SystemAssigned, UserAssigned" zahrnuje implicitně vytvořenou identitu a sadu uživatelsky přiřazených identit. Typ None odstraní všechny identity.

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned, UserAssigned
  • string
UserAssigned
  • string

KeyVaultProperties

Vlastnosti trezoru klíčů

Name Type Description
keyName
  • string

Název klíče trezoru klíčů

keyVaultUri
  • string

Identifikátor URI trezoru klíčů

keyVersion
  • string

Verze klíče trezoru klíčů

userIdentity
  • string

Identita přiřazená uživatelem (ID prostředku ARM), která má přístup ke klíči

LanguageExtension

Objekt rozšíření jazyka.

Name Type Description
languageExtensionName

Název jazykové rozšíření.

languageExtensionName

Název jazykové rozšíření.

Name Type Description
PYTHON
  • string
R
  • string

LanguageExtensionsList

Seznam objektů rozšíření jazyka.

Name Type Description
value

Seznam jazykových rozšíření

OptimizedAutoscale

Třída, která obsahuje optimalizovanou definici automatického škálování.

Name Type Description
isEnabled
  • boolean

Logická hodnota, která označuje, zda je povolena funkce optimalizovaného automatického škálování.

maximum
  • integer

Maximální počet povolených instancí

minimum
  • integer

Minimální počet povolených instancí

version
  • integer

Verze definované šablony, pro instanci 1.

ProvisioningState

Zřízený stav prostředku.

Name Type Description
Creating
  • string
Deleting
  • string
Failed
  • string
Moving
  • string
Running
  • string
Succeeded
  • string

State

Stav prostředku.

Name Type Description
Creating
  • string
Deleted
  • string
Deleting
  • string
Running
  • string
Starting
  • string
Stopped
  • string
Stopping
  • string
Unavailable
  • string
Updating
  • string

TrustedExternalTenant

Představuje ID tenanta, kterému cluster důvěřuje.

Name Type Description
value
  • string

Identifikátor GUID představující externího tenanta

UserAssignedIdentities

Seznam identit uživatelů přidružených k Kusto clusteru. Odkazy na klíč uživatele slovníku identity budou mít ID prostředků ARM ve formátu: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} '.

Name Type Description

VirtualNetworkConfiguration

Třída, která obsahuje definici virtuální sítě.

Name Type Description
dataManagementPublicIpId
  • string

ID prostředku veřejné IP adresy služby správy dat.

enginePublicIpId
  • string

ID prostředku veřejné IP adresy služby Engine.

subnetId
  • string

ID prostředku podsítě.