Clusters - Create Or Update

Serviço:: Azure Kusto

Versão da API:: 2024-04-13

Crie ou atualize um cluster Kusto.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
clusterName	path	True	string pattern: ^.*$	O nome do cluster Kusto.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
If-Match		string	A ETag do cluster. Omita esse valor para sempre substituir o cluster atual. Especifique o valor de ETag visto pela última vez para impedir a substituição acidental de alterações simultâneas.
If-None-Match		string	Defina como '*' para permitir que um novo cluster seja criado, mas para impedir a atualização de um cluster existente. Outros valores resultarão em uma resposta com falha de pré-condição 412.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
location	True	string	A localização geográfica onde o recurso reside
sku	True	AzureSku	A SKU do cluster.
identity		Identity	A identidade do cluster, se configurada.
properties.acceptedAudiences		AcceptedAudiences[]	As audiências aceitas do cluster.
properties.allowedFqdnList		string[]	Lista de FQDNs permitidos (Nome de Domínio Totalmente Qualificado) para saída do Cluster.
properties.allowedIpRangeList		string[]	A lista de ips no formato cidr permitido para se conectar ao cluster.
properties.calloutPolicies		CalloutPolicy[]	Lista de políticas de texto explicativo para saída do Cluster.
properties.enableAutoStop		boolean	Um valor booliano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou nenhuma atividade por muitos dias).
properties.enableDiskEncryption		boolean	Um valor booliano que indica se os discos do cluster são criptografados.
properties.enableDoubleEncryption		boolean	Um valor booliano que indica se a criptografia dupla está habilitada.
properties.enablePurge		boolean	Um valor booliano que indica se as operações de limpeza estão habilitadas.
properties.enableStreamingIngest		boolean	Um valor booliano que indica se a ingestão de streaming está habilitada.
properties.engineType		EngineType	O tipo de mecanismo
properties.keyVaultProperties		KeyVaultProperties	Propriedades KeyVault para a criptografia de cluster.
properties.languageExtensions		LanguageExtensionsList	Lista de extensões de idioma do cluster.
properties.optimizedAutoscale		OptimizedAutoscale	Definição de dimensionamento automático otimizada.
properties.publicIPType		publicIPType	Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6)
properties.publicNetworkAccess		PublicNetworkAccess	O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida
properties.restrictOutboundNetworkAccess		ClusterNetworkAccessFlag	Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.trustedExternalTenants		TrustedExternalTenant[]	Os locatários externos do cluster.
properties.virtualClusterGraduationProperties		string	Propriedades de graduação do Cluster Virtual
properties.virtualNetworkConfiguration		VirtualNetworkConfiguration	Definição de rede virtual.
tags		object	Marcas de recurso.
zones		string[]	As zonas de disponibilidade do cluster.

Respostas

Nome	Tipo	Description
200 OK	Cluster	Atualizou com êxito o Cluster.
201 Created	Cluster	O cluster foi criado com êxito.
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Exemplos

KustoClustersCreateOrUpdate

Solicitação de exemplo

HTTP

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

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

Resposta de exemplo

Código de status:: 200

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

Código de status:: 201

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

Definições

Nome	Description
AcceptedAudiences	Representa um público-alvo aceito confiável pelo cluster.
AzureSku	Definição de SKU do Azure.
AzureSkuName	Nome do SKU.
AzureSkuTier	Camada de SKU.
CalloutPolicy	Configuração para políticas de texto explicativo externo, incluindo padrões de URI, tipos de acesso e tipos de serviço.
calloutType	Tipo do serviço de texto explicativo, especificando o tipo de recurso ou serviço externo que está sendo acessado.
Cluster	Classe que representa um cluster Kusto.
ClusterNetworkAccessFlag	Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
createdByType	O tipo de identidade que criou o recurso.
EngineType	O tipo de mecanismo
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Identity	Identidade do recurso.
IdentityType	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades.
KeyVaultProperties	Propriedades do cofre de chaves.
LanguageExtension	O objeto de extensão de linguagem.
languageExtensionImageName	O nome da imagem da extensão de idioma.
languageExtensionName	O nome da extensão de idioma.
LanguageExtensionsList	A lista de objetos de extensão de linguagem.
MigrationClusterProperties	Representa uma propriedade de um cluster que faz parte de uma migração.
MigrationClusterRole	A função do cluster no processo de migração.
OptimizedAutoscale	Uma classe que contém a definição de escala automática otimizada.
outboundAccess	Indica se o acesso de saída é permitido para o padrão de URI especificado.
PrivateEndpointConnection	Uma conexão de ponto de extremidade privado
PrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
PrivateLinkServiceConnectionStateProperty	Estado de conexão da conexão de ponto de extremidade privado.
ProvisioningState	O estado provisionado do recurso.
publicIPType	Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6)
PublicNetworkAccess	O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida
State	O estado do recurso.
systemData	Metadados relativos à criação e última modificação do recurso.
TrustedExternalTenant	Representa uma ID de locatário confiável pelo cluster.
UserAssignedIdentities	A lista de identidades de usuário associadas ao cluster Kusto. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
VirtualNetworkConfiguration	Uma classe que contém a definição de rede virtual.
VnetState	Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado, ele será removido da sub-rede.
ZoneStatus	Indica se o cluster é zonal ou não zonal.

AcceptedAudiences

Objeto

Representa um público-alvo aceito confiável pelo cluster.

Nome	Tipo	Description
value	string	GUID ou URL válida que representa um público-alvo aceito.

AzureSku

Objeto

Definição de SKU do Azure.

Nome	Tipo	Description
capacity	integer (int32)	O número de instâncias do cluster.
name	AzureSkuName	Nome do SKU.
tier	AzureSkuTier	Camada de SKU.

AzureSkuName

Enumeração

Nome do SKU.

Valor	Description
Dev(No SLA)_Standard_D11_v2
Dev(No SLA)_Standard_E2a_v4
Standard_D11_v2
Standard_D12_v2
Standard_D13_v2
Standard_D14_v2
Standard_D32d_v4
Standard_D16d_v5
Standard_D32d_v5
Standard_DS13_v2+1TB_PS
Standard_DS13_v2+2TB_PS
Standard_DS14_v2+3TB_PS
Standard_DS14_v2+4TB_PS
Standard_L4s
Standard_L8s
Standard_L16s
Standard_L8s_v2
Standard_L16s_v2
Standard_L8s_v3
Standard_L16s_v3
Standard_L32s_v3
Standard_L8as_v3
Standard_L16as_v3
Standard_L32as_v3
Standard_E64i_v3
Standard_E80ids_v4
Standard_E2a_v4
Standard_E4a_v4
Standard_E8a_v4
Standard_E16a_v4
Standard_E8as_v4+1TB_PS
Standard_E8as_v4+2TB_PS
Standard_E16as_v4+3TB_PS
Standard_E16as_v4+4TB_PS
Standard_E8as_v5+1TB_PS
Standard_E8as_v5+2TB_PS
Standard_E16as_v5+3TB_PS
Standard_E16as_v5+4TB_PS
Standard_E2ads_v5
Standard_E4ads_v5
Standard_E8ads_v5
Standard_E16ads_v5
Standard_EC8as_v5+1TB_PS
Standard_EC8as_v5+2TB_PS
Standard_EC16as_v5+3TB_PS
Standard_EC16as_v5+4TB_PS
Standard_EC8ads_v5
Standard_EC16ads_v5
Standard_E8s_v4+1TB_PS
Standard_E8s_v4+2TB_PS
Standard_E16s_v4+3TB_PS
Standard_E16s_v4+4TB_PS
Standard_E8s_v5+1TB_PS
Standard_E8s_v5+2TB_PS
Standard_E16s_v5+3TB_PS
Standard_E16s_v5+4TB_PS
Standard_E2d_v4
Standard_E4d_v4
Standard_E8d_v4
Standard_E16d_v4
Standard_E2d_v5
Standard_E4d_v5
Standard_E8d_v5
Standard_E16d_v5

AzureSkuTier

Enumeração

Camada de SKU.

Valor	Description
Basic
Standard

CalloutPolicy

Objeto

Configuração para políticas de texto explicativo externo, incluindo padrões de URI, tipos de acesso e tipos de serviço.

Nome	Tipo	Description
calloutId	string	Identificador exclusivo para a configuração de texto explicativo.
calloutType	calloutType	Tipo do serviço de texto explicativo, especificando o tipo de recurso ou serviço externo que está sendo acessado.
calloutUriRegex	string	Expressão regular ou padrão FQDN para o URI de texto explicativo.
outboundAccess	outboundAccess	Indica se o acesso de saída é permitido para o padrão de URI especificado.

calloutType

Enumeração

Tipo do serviço de texto explicativo, especificando o tipo de recurso ou serviço externo que está sendo acessado.

Valor	Description
kusto
sql
cosmosdb
external_data
azure_digital_twins
sandbox_artifacts
webapi
mysql
postgresql
genevametrics
azure_openai

Cluster

Objeto

Classe que representa um cluster Kusto.

Nome	Tipo	Valor padrão	Description
etag	string		Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado.
id	string		ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		A identidade do cluster, se configurada.
location	string		A localização geográfica onde o recurso reside
name	string		O nome do recurso
properties.acceptedAudiences	AcceptedAudiences[]		As audiências aceitas do cluster.
properties.allowedFqdnList	string[]		Lista de FQDNs permitidos (Nome de Domínio Totalmente Qualificado) para saída do Cluster.
properties.allowedIpRangeList	string[]		A lista de ips no formato cidr permitido para se conectar ao cluster.
properties.calloutPolicies	CalloutPolicy[]		Lista de políticas de texto explicativo para saída do Cluster.
properties.dataIngestionUri	string		O URI de ingestão de dados do cluster.
properties.enableAutoStop	boolean	True	Um valor booliano que indica se o cluster pode ser interrompido automaticamente (devido à falta de dados ou nenhuma atividade por muitos dias).
properties.enableDiskEncryption	boolean	False	Um valor booliano que indica se os discos do cluster são criptografados.
properties.enableDoubleEncryption	boolean	False	Um valor booliano que indica se a criptografia dupla está habilitada.
properties.enablePurge	boolean	False	Um valor booliano que indica se as operações de limpeza estão habilitadas.
properties.enableStreamingIngest	boolean	False	Um valor booliano que indica se a ingestão de streaming está habilitada.
properties.engineType	EngineType	V3	O tipo de mecanismo
properties.keyVaultProperties	KeyVaultProperties		Propriedades KeyVault para a criptografia de cluster.
properties.languageExtensions	LanguageExtensionsList		Lista de extensões de idioma do cluster.
properties.migrationCluster	MigrationClusterProperties		Propriedades do cluster par envolvido em uma migração para/desse cluster.
properties.optimizedAutoscale	OptimizedAutoscale		Definição de dimensionamento automático otimizada.
properties.privateEndpointConnections	PrivateEndpointConnection[]		Uma lista de conexões de ponto de extremidade privado.
properties.provisioningState	ProvisioningState		O estado provisionado do recurso.
properties.publicIPType	publicIPType	IPv4	Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6)
properties.publicNetworkAccess	PublicNetworkAccess	Enabled	O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida
properties.restrictOutboundNetworkAccess	ClusterNetworkAccessFlag	Disabled	Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'
properties.state	State		O estado do recurso.
properties.stateReason	string		O motivo do estado atual do cluster.
properties.trustedExternalTenants	TrustedExternalTenant[]		Os locatários externos do cluster.
properties.uri	string		O URI do cluster.
properties.virtualClusterGraduationProperties	string		Propriedades de graduação do Cluster Virtual
properties.virtualNetworkConfiguration	VirtualNetworkConfiguration		Definição de rede virtual.
properties.zoneStatus	ZoneStatus		Indica se o cluster é zonal ou não zonal.
sku	AzureSku		A SKU do cluster.
systemData	systemData		Metadados relativos à criação e última modificação do recurso.
tags	object		Marcas de recurso.
type	string		O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"
zones	string[]		As zonas de disponibilidade do cluster.

ClusterNetworkAccessFlag

Enumeração

Se deseja ou não restringir o acesso à rede de saída. O valor é opcional, mas se passado, deve ser 'Habilitado' ou 'Desabilitado'

Valor	Description
Enabled
Disabled

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

EngineType

Enumeração

O tipo de mecanismo

Valor	Description
V2
V3

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

Identity

Objeto

Identidade do recurso.

Nome	Tipo	Description
principalId	string	A ID principal da identidade do recurso.
tenantId	string	A ID do locatário do recurso.
type	IdentityType	O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades.
userAssignedIdentities	UserAssignedIdentities	A lista de identidades de usuário associadas ao cluster Kusto. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumeração

O tipo de identidade gerenciada usada. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá todas as identidades.

Valor	Description
None
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned

KeyVaultProperties

Objeto

Propriedades do cofre de chaves.

Nome	Tipo	Description
keyName	string	O nome da chave do cofre de chaves.
keyVaultUri	string	O Uri do cofre de chaves.
keyVersion	string	A versão da chave do cofre de chaves.
userIdentity	string	A identidade atribuída pelo usuário (ID de recurso do ARM) que tem acesso à chave.

LanguageExtension

Objeto

O objeto de extensão de linguagem.

Nome	Tipo	Description
languageExtensionCustomImageName	string	O nome da imagem personalizada da extensão de idioma.
languageExtensionImageName	languageExtensionImageName	O nome da imagem da extensão de idioma.
languageExtensionName	languageExtensionName	O nome da extensão de idioma.

languageExtensionImageName

Enumeração

O nome da imagem da extensão de idioma.

Valor	Description
R
Python3_6_5
Python3_10_8
Python3_10_8_DL
PythonCustomImage
Python3_11_7
Python3_11_7_DL

languageExtensionName

Enumeração

O nome da extensão de idioma.

Valor	Description
PYTHON
R

LanguageExtensionsList

Objeto

A lista de objetos de extensão de linguagem.

Nome	Tipo	Description
value	LanguageExtension[]	A lista de extensões de idioma.

MigrationClusterProperties

Objeto

Representa uma propriedade de um cluster que faz parte de uma migração.

Nome	Tipo	Description
dataIngestionUri	string	A URL de ingestão de dados públicos do cluster.
id	string	A ID do recurso do cluster.
role	MigrationClusterRole	A função do cluster no processo de migração.
uri	string	A URL pública do cluster.

MigrationClusterRole

Enumeração

A função do cluster no processo de migração.

Valor	Description
Source
Destination

OptimizedAutoscale

Objeto

Uma classe que contém a definição de escala automática otimizada.

Nome	Tipo	Description
isEnabled	boolean	Um valor booliano que indica se o recurso de dimensionamento automático otimizado está habilitado ou não.
maximum	integer (int32)	Contagem máxima de instâncias permitidas.
minimum	integer (int32)	Contagem mínima de instâncias permitidas.
version	integer (int32)	A versão do modelo definido, por exemplo, 1.

outboundAccess

Enumeração

Indica se o acesso de saída é permitido para o padrão de URI especificado.

Valor	Description
Allow
Deny

PrivateEndpointConnection

Objeto

Uma conexão de ponto de extremidade privado

Nome	Tipo	Description
id	string	ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.groupId	string	ID do grupo do ponto de extremidade privado.
properties.privateEndpoint	PrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de conexão da conexão de ponto de extremidade privado.
properties.provisioningState	string	Estado de provisionamento do ponto de extremidade privado.
systemData	systemData	Metadados relativos à criação e última modificação do recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Objeto

Ponto de extremidade privado ao qual a conexão pertence.

Nome	Tipo	Description
id	string	ID do recurso do ponto de extremidade privado.

PrivateLinkServiceConnectionStateProperty

Objeto

Estado de conexão da conexão de ponto de extremidade privado.

Nome	Tipo	Description
actionsRequired	string	Qualquer ação necessária além do fluxo de trabalho básico (aprovar/rejeitar/desconectar)
description	string	A descrição da conexão do serviço de link privado.
status	string	O status da conexão do serviço de link privado.

ProvisioningState

Enumeração

O estado provisionado do recurso.

Valor	Description
Running
Creating
Deleting
Succeeded
Failed
Moving
Canceled

publicIPType

Enumeração

Indica qual tipo de IP público criar – IPv4 (padrão) ou DualStack (IPv4 e IPv6)

Valor	Description
IPv4
DualStack

PublicNetworkAccess

Enumeração

O acesso à rede pública para o cluster é habilitado por padrão. Quando desabilitado, somente a conexão de ponto de extremidade privado com o cluster é permitida

Valor	Description
Enabled
Disabled

State

Enumeração

O estado do recurso.

Valor	Description
Creating
Unavailable
Running
Deleting
Deleted
Stopping
Stopped
Starting
Updating
Migrated

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TrustedExternalTenant

Objeto

Representa uma ID de locatário confiável pelo cluster.

Nome	Tipo	Description
value	string	GUID que representa um locatário externo.

UserAssignedIdentities

Objeto

A lista de identidades de usuário associadas ao cluster Kusto. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

Nome	Tipo	Description

VirtualNetworkConfiguration

Objeto

Uma classe que contém a definição de rede virtual.

Nome	Tipo	Valor padrão	Description
dataManagementPublicIpId	string		ID do recurso de endereço IP público do serviço do gerenciamento de dados.
enginePublicIpId	string		ID do recurso de endereço IP público do serviço de mecanismo.
state	VnetState	Enabled	Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado, ele será removido da sub-rede.
subnetId	string		A ID do recurso de sub-rede.

VnetState

Enumeração

Quando habilitado, o cluster é implantado na sub-rede configurada, quando desabilitado, ele será removido da sub-rede.

Valor	Description
Enabled
Disabled

ZoneStatus

Enumeração

Indica se o cluster é zonal ou não zonal.

Valor	Description
NonZonal
ZonalInconsistency
Zonal

Compartilhar via

Clusters - Create Or Update

Parâmetros de URI

Cabeçalho da solicitação

Corpo da solicitação

Respostas

Exemplos

KustoClustersCreateOrUpdate

Solicitação de exemplo

Resposta de exemplo

Definições

AcceptedAudiences

AzureSku

AzureSkuName

AzureSkuTier

CalloutPolicy

calloutType

Cluster

ClusterNetworkAccessFlag

createdByType

EngineType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

KeyVaultProperties

LanguageExtension

languageExtensionImageName

languageExtensionName

LanguageExtensionsList

MigrationClusterProperties

MigrationClusterRole

OptimizedAutoscale

outboundAccess

PrivateEndpointConnection

PrivateEndpointProperty

PrivateLinkServiceConnectionStateProperty

ProvisioningState

publicIPType

PublicNetworkAccess

State

systemData

TrustedExternalTenant

UserAssignedIdentities

VirtualNetworkConfiguration

VnetState

ZoneStatus