Partilhar via


Clusters - Create Or Update

Crie ou atualize um cluster do Log Analytics.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2025-07-01

Parâmetros URI

Nome Em Necessário Tipo Descrição
clusterName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

O nome do cluster do Log Analytics.

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 utilizar para esta operação.

Órgão do Pedido

Nome Necessário Tipo Descrição
location True

string

A geolocalização onde o recurso vive

identity

ManagedServiceIdentity

Identidade do recurso.

properties.associatedWorkspaces

AssociatedWorkspace[]

A lista de espaços de trabalho do Log Analytics associados ao cluster

properties.billingType

BillingType

O tipo de faturamento do cluster.

properties.capacityReservationProperties

CapacityReservationProperties

Propriedades adicionais para reserva de capacidade

properties.isAvailabilityZonesEnabled

boolean

Define se o cluster dará suporte a zonas de disponibilidade. Isso pode ser definido como verdadeiro somente em regiões onde o Azure Data Explorer oferece suporte a Zonas de Disponibilidade. Esta propriedade não pode ser modificada após a criação do cluster. O valor padrão é 'true' se a região suportar Zonas de Disponibilidade.

properties.isDoubleEncryptionEnabled

boolean

Configura se o cluster usará criptografia dupla. Esta propriedade não pode ser modificada após a criação do cluster. O valor padrão é 'true'

properties.keyVaultProperties

keyVaultProperties

As propriedades de chave associadas.

properties.replication

ClusterReplicationProperties

Propriedades de replicação do cluster.

sku

ClusterSku

As propriedades do sku.

tags

object

Tags de recursos.

Respostas

Nome Tipo Descrição
200 OK

Cluster

Definição de resposta OK.

202 Accepted

Definição de resposta aceite (operação de longa duração).

Cabeçalhos

  • Location: string
  • azure-asyncoperation: string
Other Status Codes

ErrorResponse

Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

ClustersCreate

Pedido de exemplo

PUT https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2025-07-01

{
  "sku": {
    "name": "CapacityReservation",
    "capacity": 100
  },
  "location": "eastus",
  "tags": {
    "tag1": "val1"
  }
}

Resposta de exemplo

Location: https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685/operationresults/c0f02ffd-0d4e-491e-a10c-fb82a1543a77?api-version=2025-07-01
Azure-AsyncOperation: https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/providers/Microsoft.OperationalInsights/locations/eastus/operationstatuses/c0f02ffd-0d4e-491e-a10c-fb82a1543a77?api-version=2025-07-01
{
  "properties": {
    "provisioningState": "Succeeded",
    "clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1",
    "billingType": "Cluster",
    "lastModifiedDate": "2020-01-13T17:40:33Z",
    "createdDate": "2020-01-13T17:40:33Z",
    "isDoubleEncryptionEnabled": true,
    "isAvailabilityZonesEnabled": true
  },
  "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "principalId": "356d057d-cba5-44dd-8a30-b2e547bc416b",
    "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47",
    "type": "SystemAssigned"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 100
  },
  "name": "TestResourceLock",
  "type": "Microsoft.OperationalInsights/clusters",
  "location": "eastus"
}

Definições

Nome Descrição
AssociatedWorkspace

A lista de espaços de trabalho do Log Analytics associados ao cluster.

BillingType

O tipo de faturamento do cluster.

CapacityReservationProperties

As propriedades de Reserva de Capacidade.

Cluster

O contêiner de recursos de cluster do Log Analytics de nível superior.

ClusterEntityStatus

O estado de provisionamento do cluster.

ClusterReplicationProperties

Propriedades de replicação de cluster.

ClusterReplicationState

O estado de provisionamento da replicação de cluster.

ClusterSku

A definição de sku de cluster.

ClusterSkuNameEnum

A SKU (camada) de um cluster.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

keyVaultProperties

As propriedades do cofre de chaves.

ManagedServiceIdentity

Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

AssociatedWorkspace

A lista de espaços de trabalho do Log Analytics associados ao cluster.

Nome Tipo Descrição
associateDate

string (date-time)

O tempo de associação do espaço de trabalho.

resourceId

string (arm-id)

ID do recurso do braço do espaço de trabalho associado, na forma de: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.

workspaceId

string (uuid)

ID imutável do espaço de trabalho associado.

workspaceName

string

Nome do recurso do espaço de trabalho associado.

BillingType

O tipo de faturamento do cluster.

Valor Descrição
Cluster
Workspaces

CapacityReservationProperties

As propriedades de Reserva de Capacidade.

Nome Tipo Descrição
lastSkuUpdate

string (date-time)

A última vez que o Sku foi atualizado.

minCapacity

integer (int64)

Valor mínimo CapacityReservation em Gigabytes.

Cluster

O contêiner de recursos de cluster do Log Analytics de nível superior.

Nome Tipo Descrição
id

string

ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

Identidade do recurso.

location

string

A geolocalização onde o recurso vive

name

string

O nome do recurso

properties.associatedWorkspaces

AssociatedWorkspace[]

A lista de espaços de trabalho do Log Analytics associados ao cluster

properties.billingType

BillingType

O tipo de faturamento do cluster.

properties.capacityReservationProperties

CapacityReservationProperties

Propriedades adicionais para reserva de capacidade

properties.clusterId

string

A ID associada ao cluster.

properties.createdDate

string (date-time)

O tempo de criação do cluster

properties.isAvailabilityZonesEnabled

boolean

Define se o cluster dará suporte a zonas de disponibilidade. Isso pode ser definido como verdadeiro somente em regiões onde o Azure Data Explorer oferece suporte a Zonas de Disponibilidade. Esta propriedade não pode ser modificada após a criação do cluster. O valor padrão é 'true' se a região suportar Zonas de Disponibilidade.

properties.isDoubleEncryptionEnabled

boolean

Configura se o cluster usará criptografia dupla. Esta propriedade não pode ser modificada após a criação do cluster. O valor padrão é 'true'

properties.keyVaultProperties

keyVaultProperties

As propriedades de chave associadas.

properties.lastModifiedDate

string (date-time)

A última vez que o cluster foi atualizado.

properties.provisioningState

ClusterEntityStatus

O estado de provisionamento do cluster.

properties.replication

ClusterReplicationProperties

Propriedades de replicação do cluster.

sku

ClusterSku

As propriedades do sku.

tags

object

Tags de recursos.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

O estado de provisionamento do cluster.

Valor Descrição
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

ClusterReplicationProperties

Propriedades de replicação de cluster.

Nome Tipo Descrição
createdDate

string (date-time)

Tempo de criação da replicação do cluster

enabled

boolean

Especifica se a replicação está habilitada ou não. Quando verdadeiro, o cluster é replicado para o local especificado.

isAvailabilityZonesEnabled

boolean

Deve habilitar AvailabilityZones para determinado cluster replicado

lastModifiedDate

string (date-time)

A última vez que a replicação do cluster foi atualizada.

location

string

O local secundário da replicação. Se a replicação estiver sendo habilitada, a habilitação deverá ser fornecida.

provisioningState

ClusterReplicationState

O estado de provisionamento da replicação de cluster.

ClusterReplicationState

O estado de provisionamento da replicação de cluster.

Valor Descrição
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

ClusterSku

A definição de sku de cluster.

Nome Tipo Descrição
capacity

integer (int64)

O nível de reserva de capacidade em Gigabytes para este cluster.

name

ClusterSkuNameEnum

A SKU (camada) de um cluster.

ClusterSkuNameEnum

A SKU (camada) de um cluster.

Valor Descrição
CapacityReservation

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Nome Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

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

Resposta de erro

Nome Tipo Descrição
error

ErrorDetail

O objeto de erro.

keyVaultProperties

As propriedades do cofre de chaves.

Nome Tipo Descrição
keyName

string

O nome da chave associada ao cluster do Log Analytics.

keyRsaSize

integer (int32)

Tamanho mínimo necessário da chave selecionada.

keyVaultUri

string

O uri do Cofre da Chave que contém a chave associada ao cluster do Log Analytics.

keyVersion

string

A versão da chave associada ao cluster do Log Analytics.

ManagedServiceIdentity

Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)

Nome Tipo Descrição
principalId

string (uuid)

O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.

tenantId

string (uuid)

O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.

type

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned Identidades
O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

Valor Descrição
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

Nome Tipo Descrição
clientId

string (uuid)

O ID do cliente da identidade atribuída.

principalId

string (uuid)

O ID principal da identidade atribuída.