Microsoft.Kusto/clusters 2019-11-09 - Bicep, ARM template & Terraform AzAPI reference

Bicep kaynak tanımı

Kümeler kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Kusto/clusters kaynağı oluşturmak için şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.Kusto/clusters@2019-11-09' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  properties: {
    enableDiskEncryption: bool
    enableStreamingIngest: bool
    keyVaultProperties: {
      keyName: 'string'
      keyVaultUri: 'string'
      keyVersion: 'string'
    }
    optimizedAutoscale: {
      isEnabled: bool
      maximum: int
      minimum: int
      version: int
    }
    trustedExternalTenants: [
      {
        value: 'string'
      }
    ]
    virtualNetworkConfiguration: {
      dataManagementPublicIpId: 'string'
      enginePublicIpId: 'string'
      subnetId: 'string'
    }
  }
  zones: [
    'string'
  ]
}

Özellik değerleri

Küme

Ad	Açıklama	Değer
ad	Kaynak adı	dize (gerekli) Karakter sınırı: 4-22 Geçerli karakterler: Küçük harfler ve sayılar. Harfle başlayın. Kaynak adı Azure genelinde benzersiz olmalıdır.
yer	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
Etiketler	Kaynak etiketleri.	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
Sku	Kümenin SKU'su.	AzureSku (gerekli)
kimlik	Yapılandırıldıysa kümenin kimliği.	kimlik
Özellikler	Küme özellikleri.	ClusterProperties
Bölge	Kümenin kullanılabilirlik alanları.	string[]

Kimlik

Ad	Açıklama	Değer
tür	Kimlik türü.	'Hiçbiri' 'SystemAssigned' (gerekli)
userAssignedIdentities	Kusto kümesiyle ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlük anahtarı başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermiyor. Tüm özellikler ReadOnly'dir.

ClusterProperties

Ad	Açıklama	Değer
enableDiskEncryption	Küme disklerinin şifrelenip şifrelenmediğini gösteren boole değeri.	Bool
enableStreamingIngest	Akış alma işleminin etkinleştirilip etkinleştirilmediğini gösteren boole değeri.	Bool
keyVaultProperties	Küme şifrelemesi için KeyVault özellikleri.	KeyVaultProperties
optimizedAutoscale	İyileştirilmiş otomatik ölçeklendirme tanımı.	OptimizedAutoscale
trustedExternalTenants	Kümenin dış kiracıları.	TrustedExternalTenant[]
virtualNetworkConfiguration	Sanal ağ tanımı.	VirtualNetworkConfiguration

KeyVaultProperties

Ad	Açıklama	Değer
keyName	Anahtar kasası anahtarının adı.	dize (gerekli)
keyVaultUri	Anahtar kasasının Uri'sini.	dize (gerekli)
keyVersion	Anahtar kasası anahtarının sürümü.	dize (gerekli)

OptimizedAutoscale

Ad	Açıklama	Değer
isEnabled	İyileştirilmiş otomatik ölçeklendirme özelliğinin etkinleştirilip etkinleştirilmediğini gösteren boole değeri.	bool (gerekli)
maksimum	İzin verilen en fazla örnek sayısı.	int (gerekli)
asgari	İzin verilen en düşük örnek sayısı.	int (gerekli)
Sürüm	Şablonun tanımlı sürümü, örneğin 1.	int (gerekli)

TrustedExternalTenant

Ad	Açıklama	Değer
değer	Dış kiracıyı temsil eden GUID.	dizgi

VirtualNetworkConfiguration

Ad	Açıklama	Değer
dataManagementPublicIpId	Veri yönetiminin hizmet genel IP adresi kaynak kimliği.	dize (gerekli)
enginePublicIpId	Altyapı hizmetinin genel IP adresi kaynak kimliği.	dize (gerekli)
subnetId	Alt ağ kaynak kimliği.	dize (gerekli)

AzureSku

Ad	Açıklama	Değer
kapasite	Kümenin örnek sayısı.	Int
ad	SKU adı.	'Geliştirme(SLA Yok)_Standard_D11_v2' 'Standard_D11_v2' 'Standard_D12_v2' 'Standard_D13_v2' 'Standard_D14_v2' 'Standard_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_L16s' 'Standard_L4s' 'Standard_L8s' (gerekli)
Katmanı	SKU katmanı.	'Temel' 'Standart' (gerekli)

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Açıklama
Veritabanı izleyicisi oluşturma 'a dağıtma	Bu örnek, Azure SQL için bir veritabanı izleyicisi oluşturur ve veri deposunu, SQL hedeflerini ve yönetilen özel uç noktalarını yapılandırmaktadır
Zaman Veri Geçmişi Bağlantısı ile Azure Digital Twins'i 'a dağıtma	Bu şablon, zaman serisi veri geçmişi bağlantısıyla yapılandırılmış bir Azure Digital Twins örneği oluşturur. Bağlantı oluşturmak için Event Hubs ad alanı, olay hub'ı, Azure Veri Gezgini kümesi ve veritabanı gibi diğer kaynakların oluşturulması gerekir. Veriler, sonunda verileri Azure Veri Gezgini kümesine ileden bir olay hub'ına gönderilir. Veriler kümedeki bir veritabanı tablosunda depolanır
Veritabanı küme oluşturma 'a dağıtma	Bu şablon bir küme ve veritabanı oluşturmanıza olanak tanır.
Cosmos DB bağlantı ile Azure Veri Gezgini DB dağıtma 'a dağıtma	Cosmos DB bağlantısı ile Azure Veri Gezgini DB'yi dağıtın.
Event Grid bağlantısıyla Azure Veri Gezgini veritabanı dağıtma 'a dağıtma	Event Grid bağlantısıyla Azure Veri Gezgini veritabanı dağıtma.
Olay Hub'ı bağlantı ile Azure Veri Gezgini veritabanı dağıtma 'a dağıtma	Olay Hub'ı bağlantısıyla Azure Veri Gezgini veritabanı dağıtma.
Azure Veri Gezgini kümesini sanal ağınıza dağıtma 'a dağıtma	Bu şablon, sanal ağınıza bir küme dağıtmanıza olanak tanır.

ARM şablonu kaynak tanımı

Kümeler kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Kusto/clusters kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.Kusto/clusters",
  "apiVersion": "2019-11-09",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {}
    }
  },
  "properties": {
    "enableDiskEncryption": "bool",
    "enableStreamingIngest": "bool",
    "keyVaultProperties": {
      "keyName": "string",
      "keyVaultUri": "string",
      "keyVersion": "string"
    },
    "optimizedAutoscale": {
      "isEnabled": "bool",
      "maximum": "int",
      "minimum": "int",
      "version": "int"
    },
    "trustedExternalTenants": [
      {
        "value": "string"
      }
    ],
    "virtualNetworkConfiguration": {
      "dataManagementPublicIpId": "string",
      "enginePublicIpId": "string",
      "subnetId": "string"
    }
  },
  "zones": [ "string" ]
}

Özellik değerleri

Küme

Ad	Açıklama	Değer
tür	Kaynak türü	'Microsoft.Kusto/clusters'
apiVersion	Kaynak API'sinin sürümü	'2019-11-09'
ad	Kaynak adı	dize (gerekli) Karakter sınırı: 4-22 Geçerli karakterler: Küçük harfler ve sayılar. Harfle başlayın. Kaynak adı Azure genelinde benzersiz olmalıdır.
yer	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
Etiketler	Kaynak etiketleri.	Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
Sku	Kümenin SKU'su.	AzureSku (gerekli)
kimlik	Yapılandırıldıysa kümenin kimliği.	kimlik
Özellikler	Küme özellikleri.	ClusterProperties
Bölge	Kümenin kullanılabilirlik alanları.	string[]

Kimlik

Ad	Açıklama	Değer
tür	Kimlik türü.	'Hiçbiri' 'SystemAssigned' (gerekli)
userAssignedIdentities	Kusto kümesiyle ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlük anahtarı başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermiyor. Tüm özellikler ReadOnly'dir.

ClusterProperties

Ad	Açıklama	Değer
enableDiskEncryption	Küme disklerinin şifrelenip şifrelenmediğini gösteren boole değeri.	Bool
enableStreamingIngest	Akış alma işleminin etkinleştirilip etkinleştirilmediğini gösteren boole değeri.	Bool
keyVaultProperties	Küme şifrelemesi için KeyVault özellikleri.	KeyVaultProperties
optimizedAutoscale	İyileştirilmiş otomatik ölçeklendirme tanımı.	OptimizedAutoscale
trustedExternalTenants	Kümenin dış kiracıları.	TrustedExternalTenant[]
virtualNetworkConfiguration	Sanal ağ tanımı.	VirtualNetworkConfiguration

KeyVaultProperties

Ad	Açıklama	Değer
keyName	Anahtar kasası anahtarının adı.	dize (gerekli)
keyVaultUri	Anahtar kasasının Uri'sini.	dize (gerekli)
keyVersion	Anahtar kasası anahtarının sürümü.	dize (gerekli)

OptimizedAutoscale

Ad	Açıklama	Değer
isEnabled	İyileştirilmiş otomatik ölçeklendirme özelliğinin etkinleştirilip etkinleştirilmediğini gösteren boole değeri.	bool (gerekli)
maksimum	İzin verilen en fazla örnek sayısı.	int (gerekli)
asgari	İzin verilen en düşük örnek sayısı.	int (gerekli)
Sürüm	Şablonun tanımlı sürümü, örneğin 1.	int (gerekli)

TrustedExternalTenant

Ad	Açıklama	Değer
değer	Dış kiracıyı temsil eden GUID.	dizgi

VirtualNetworkConfiguration

Ad	Açıklama	Değer
dataManagementPublicIpId	Veri yönetiminin hizmet genel IP adresi kaynak kimliği.	dize (gerekli)
enginePublicIpId	Altyapı hizmetinin genel IP adresi kaynak kimliği.	dize (gerekli)
subnetId	Alt ağ kaynak kimliği.	dize (gerekli)

AzureSku

Ad	Açıklama	Değer
kapasite	Kümenin örnek sayısı.	Int
ad	SKU adı.	'Geliştirme(SLA Yok)_Standard_D11_v2' 'Standard_D11_v2' 'Standard_D12_v2' 'Standard_D13_v2' 'Standard_D14_v2' 'Standard_DS13_v2+1TB_PS' 'Standard_DS13_v2+2TB_PS' 'Standard_DS14_v2+3TB_PS' 'Standard_DS14_v2+4TB_PS' 'Standard_L16s' 'Standard_L4s' 'Standard_L8s' (gerekli)
Katmanı	SKU katmanı.	'Temel' 'Standart' (gerekli)

Hızlı başlangıç şablonları

Aşağıdaki hızlı başlangıç şablonları bu kaynak türünü dağıtır.

Şablon	Açıklama
Veritabanı izleyicisi oluşturma 'a dağıtma	Bu örnek, Azure SQL için bir veritabanı izleyicisi oluşturur ve veri deposunu, SQL hedeflerini ve yönetilen özel uç noktalarını yapılandırmaktadır
Zaman Veri Geçmişi Bağlantısı ile Azure Digital Twins'i 'a dağıtma	Bu şablon, zaman serisi veri geçmişi bağlantısıyla yapılandırılmış bir Azure Digital Twins örneği oluşturur. Bağlantı oluşturmak için Event Hubs ad alanı, olay hub'ı, Azure Veri Gezgini kümesi ve veritabanı gibi diğer kaynakların oluşturulması gerekir. Veriler, sonunda verileri Azure Veri Gezgini kümesine ileden bir olay hub'ına gönderilir. Veriler kümedeki bir veritabanı tablosunda depolanır
Veritabanı küme oluşturma 'a dağıtma	Bu şablon bir küme ve veritabanı oluşturmanıza olanak tanır.
Cosmos DB bağlantı ile Azure Veri Gezgini DB dağıtma 'a dağıtma	Cosmos DB bağlantısı ile Azure Veri Gezgini DB'yi dağıtın.
Event Grid bağlantısıyla Azure Veri Gezgini veritabanı dağıtma 'a dağıtma	Event Grid bağlantısıyla Azure Veri Gezgini veritabanı dağıtma.
Olay Hub'ı bağlantı ile Azure Veri Gezgini veritabanı dağıtma 'a dağıtma	Olay Hub'ı bağlantısıyla Azure Veri Gezgini veritabanı dağıtma.
Azure Veri Gezgini kümesini sanal ağınıza dağıtma 'a dağıtma	Bu şablon, sanal ağınıza bir küme dağıtmanıza olanak tanır.

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Kümeler kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.Kusto/clusters kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Kusto/clusters@2019-11-09"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type =  "SystemAssigned"
    identity_ids = []
  }
  body = jsonencode({
    properties = {
      enableDiskEncryption = bool
      enableStreamingIngest = bool
      keyVaultProperties = {
        keyName = "string"
        keyVaultUri = "string"
        keyVersion = "string"
      }
      optimizedAutoscale = {
        isEnabled = bool
        maximum = int
        minimum = int
        version = int
      }
      trustedExternalTenants = [
        {
          value = "string"
        }
      ]
      virtualNetworkConfiguration = {
        dataManagementPublicIpId = "string"
        enginePublicIpId = "string"
        subnetId = "string"
      }
    }
    zones = [
      "string"
    ]
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Özellik değerleri

Küme

Ad	Açıklama	Değer
tür	Kaynak türü	"Microsoft.Kusto/clusters@2019-11-09"
ad	Kaynak adı	dize (gerekli) Karakter sınırı: 4-22 Geçerli karakterler: Küçük harfler ve sayılar. Harfle başlayın. Kaynak adı Azure genelinde benzersiz olmalıdır.
yer	Kaynağın bulunduğu coğrafi konum	dize (gerekli)
parent_id	Bir kaynak grubuna dağıtmak için bu kaynak grubunun kimliğini kullanın.	dize (gerekli)
Etiketler	Kaynak etiketleri.	Etiket adları ve değerleri sözlüğü.
Sku	Kümenin SKU'su.	AzureSku (gerekli)
kimlik	Yapılandırıldıysa kümenin kimliği.	kimlik
Özellikler	Küme özellikleri.	ClusterProperties
Bölge	Kümenin kullanılabilirlik alanları.	string[]

Kimlik

Ad	Açıklama	Değer
tür	Kimlik türü.	"SystemAssigned" (gerekli)
identity_ids	Kusto kümesiyle ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlük anahtarı başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.	Kullanıcı kimliği kimlikleri dizisi.

IdentityUserAssignedIdentities

Ad	Açıklama	Değer
{özelleştirilmiş özellik}		ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

Bu nesne dağıtım sırasında ayarlanacağı herhangi bir özellik içermiyor. Tüm özellikler ReadOnly'dir.

ClusterProperties

Ad	Açıklama	Değer
enableDiskEncryption	Küme disklerinin şifrelenip şifrelenmediğini gösteren boole değeri.	Bool
enableStreamingIngest	Akış alma işleminin etkinleştirilip etkinleştirilmediğini gösteren boole değeri.	Bool
keyVaultProperties	Küme şifrelemesi için KeyVault özellikleri.	KeyVaultProperties
optimizedAutoscale	İyileştirilmiş otomatik ölçeklendirme tanımı.	OptimizedAutoscale
trustedExternalTenants	Kümenin dış kiracıları.	TrustedExternalTenant[]
virtualNetworkConfiguration	Sanal ağ tanımı.	VirtualNetworkConfiguration

KeyVaultProperties

Ad	Açıklama	Değer
keyName	Anahtar kasası anahtarının adı.	dize (gerekli)
keyVaultUri	Anahtar kasasının Uri'sini.	dize (gerekli)
keyVersion	Anahtar kasası anahtarının sürümü.	dize (gerekli)

OptimizedAutoscale

Ad	Açıklama	Değer
isEnabled	İyileştirilmiş otomatik ölçeklendirme özelliğinin etkinleştirilip etkinleştirilmediğini gösteren boole değeri.	bool (gerekli)
maksimum	İzin verilen en fazla örnek sayısı.	int (gerekli)
asgari	İzin verilen en düşük örnek sayısı.	int (gerekli)
Sürüm	Şablonun tanımlı sürümü, örneğin 1.	int (gerekli)

TrustedExternalTenant

Ad	Açıklama	Değer
değer	Dış kiracıyı temsil eden GUID.	dizgi

VirtualNetworkConfiguration

Ad	Açıklama	Değer
dataManagementPublicIpId	Veri yönetiminin hizmet genel IP adresi kaynak kimliği.	dize (gerekli)
enginePublicIpId	Altyapı hizmetinin genel IP adresi kaynak kimliği.	dize (gerekli)
subnetId	Alt ağ kaynak kimliği.	dize (gerekli)

AzureSku

Ad	Açıklama	Değer
kapasite	Kümenin örnek sayısı.	Int
ad	SKU adı.	"Geliştirme (SLA Yok)_Standard_D11_v2" "Standard_D11_v2" "Standard_D12_v2" "Standard_D13_v2" "Standard_D14_v2" "Standard_DS13_v2+1TB_PS" "Standard_DS13_v2+2TB_PS" "Standard_DS14_v2+3TB_PS" "Standard_DS14_v2+4TB_PS" "Standard_L16s" "Standard_L4s" "Standard_L8s" (gerekli)
Katmanı	SKU katmanı.	"Temel" "Standart" (gerekli)

Aracılığıyla paylaş

Microsoft.Kusto kümeleri 2019-11-09

Bicep kaynak tanımı

Kaynak biçimi

Özellik değerleri

Küme

Kimlik

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Hızlı başlangıç şablonları

ARM şablonu kaynak tanımı

Kaynak biçimi

Özellik değerleri

Küme

Kimlik

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Hızlı başlangıç şablonları

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Kaynak biçimi

Özellik değerleri

Küme

Kimlik

IdentityUserAssignedIdentities

ComponentsSgqdofSchemasIdentityPropertiesUserassigne...

ClusterProperties

KeyVaultProperties

OptimizedAutoscale

TrustedExternalTenant

VirtualNetworkConfiguration

AzureSku

Geri Bildirim

Ek kaynaklar