Compartilhar 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 de URI

Nome Em Obrigatório Tipo Description
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 ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

A localização geográfica onde o recurso reside

identity

ManagedServiceIdentity

Identidade do recurso.

properties.associatedWorkspaces

AssociatedWorkspace[]

A lista de workspaces do Log Analytics associados ao cluster

properties.billingType

BillingType

O tipo de cobrança 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 true somente em regiões em que o Azure Data Explorer dá suporte a Zonas de Disponibilidade. Essa propriedade não pode ser modificada após a criação do cluster. O valor padrão será 'true' se a região der suporte a Zonas de Disponibilidade.

properties.isDoubleEncryptionEnabled

boolean

Configura se o cluster usará criptografia dupla. Essa 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 de sku.

tags

object

Tags de recursos.

Respostas

Nome Tipo Description
200 OK

Cluster

Definição de resposta OK.

202 Accepted

Definição de resposta aceita (operação de execução longa).

Cabeçalhos

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

ErrorResponse

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

ClustersCreate

Solicitação 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 Description
AssociatedWorkspace

A lista de workspaces do Log Analytics associados ao cluster.

BillingType

O tipo de cobrança 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 do cluster.

ClusterSku

A definição de SKU do cluster.

ClusterSkuNameEnum

A SKU (camada) de um cluster.

ErrorAdditionalInfo

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

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

keyVaultProperties

As propriedades do cofre de chaves.

ManagedServiceIdentity

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

ManagedServiceIdentityType

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

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

AssociatedWorkspace

A lista de workspaces do Log Analytics associados ao cluster.

Nome Tipo Description
associateDate

string (date-time)

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

resourceId

string (arm-id)

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

workspaceId

string (uuid)

ID imutável do workspace associado.

workspaceName

string

Nome do recurso do workspace associado.

BillingType

O tipo de cobrança do cluster.

Valor Description
Cluster
Workspaces

CapacityReservationProperties

As propriedades de Reserva de Capacidade.

Nome Tipo Description
lastSkuUpdate

string (date-time)

A última vez que Sku foi atualizado.

minCapacity

integer (int64)

Valor mínimo de CapacityReservation em Gigabytes.

Cluster

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

Nome Tipo Description
id

string

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

identity

ManagedServiceIdentity

Identidade do recurso.

location

string

A localização geográfica onde o recurso reside

name

string

O nome do recurso

properties.associatedWorkspaces

AssociatedWorkspace[]

A lista de workspaces do Log Analytics associados ao cluster

properties.billingType

BillingType

O tipo de cobrança 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 true somente em regiões em que o Azure Data Explorer dá suporte a Zonas de Disponibilidade. Essa propriedade não pode ser modificada após a criação do cluster. O valor padrão será 'true' se a região der suporte a Zonas de Disponibilidade.

properties.isDoubleEncryptionEnabled

boolean

Configura se o cluster usará criptografia dupla. Essa 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 de 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 Description
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

ClusterReplicationProperties

Propriedades de replicação de cluster.

Nome Tipo Description
createdDate

string (date-time)

O tempo de criação da replicação do cluster

enabled

boolean

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

isAvailabilityZonesEnabled

boolean

Deve habilitar AvailabilityZones para o cluster replicado especificado

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 do cluster.

ClusterReplicationState

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

Valor Description
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

ClusterSku

A definição de SKU do cluster.

Nome Tipo Description
capacity

integer (int64)

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

name

ClusterSkuNameEnum

A SKU (camada) de um cluster.

ClusterSkuNameEnum

A SKU (camada) de um cluster.

Valor Description
CapacityReservation

ErrorAdditionalInfo

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

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

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

keyVaultProperties

As propriedades do cofre de chaves.

Nome Tipo Description
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 Key Vault 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 de serviço gerenciada (identidades atribuídas pelo sistema e/ou pelo usuário)

Nome Tipo Description
principalId

string (uuid)

A ID da entidade de serviço da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.

tenantId

string (uuid)

A ID do locatário da identidade atribuída pelo sistema. Essa propriedade será fornecida apenas para uma identidade atribuída pelo sistema.

type

ManagedServiceIdentityType

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

userAssignedIdentities

<string,  UserAssignedIdentity>

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

ManagedServiceIdentityType

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

Valor Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

Nome Tipo Description
clientId

string (uuid)

A ID do cliente da identidade atribuída.

principalId

string (uuid)

A ID da entidade de segurança da identidade atribuída.