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 |
|---|---|---|---|---|
|
cluster
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
O nome do cluster do Log Analytics. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
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 |
Identidade do recurso. |
||
| properties.associatedWorkspaces |
A lista de espaços de trabalho do Log Analytics associados ao cluster |
||
| properties.billingType |
O tipo de faturamento do cluster. |
||
| properties.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 |
As propriedades de chave associadas. |
||
| properties.replication |
Propriedades de replicação do cluster. |
||
| sku |
As propriedades do sku. |
||
| tags |
object |
Tags de recursos. |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK |
Definição de resposta OK. |
|
| 202 Accepted |
Definição de resposta aceite (operação de longa duração). Cabeçalhos
|
|
| Other Status Codes |
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 |
|---|---|
|
Associated |
A lista de espaços de trabalho do Log Analytics associados ao cluster. |
|
Billing |
O tipo de faturamento do cluster. |
|
Capacity |
As propriedades de Reserva de Capacidade. |
| Cluster |
O contêiner de recursos de cluster do Log Analytics de nível superior. |
|
Cluster |
O estado de provisionamento do cluster. |
|
Cluster |
Propriedades de replicação de cluster. |
|
Cluster |
O estado de provisionamento da replicação de cluster. |
|
Cluster |
A definição de sku de cluster. |
|
Cluster |
A SKU (camada) de um cluster. |
|
Error |
O erro de gerenciamento de recursos informações adicionais. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
key |
As propriedades do cofre de chaves. |
|
Managed |
Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário) |
|
Managed |
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). |
|
User |
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 |
Identidade do recurso. |
|
| location |
string |
A geolocalização onde o recurso vive |
| name |
string |
O nome do recurso |
| properties.associatedWorkspaces |
A lista de espaços de trabalho do Log Analytics associados ao cluster |
|
| properties.billingType |
O tipo de faturamento do cluster. |
|
| properties.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 |
As propriedades de chave associadas. |
|
| properties.lastModifiedDate |
string (date-time) |
A última vez que o cluster foi atualizado. |
| properties.provisioningState |
O estado de provisionamento do cluster. |
|
| properties.replication |
Propriedades de replicação do cluster. |
|
| sku |
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 |
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 |
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 |
O erro informações adicionais. |
|
| code |
string |
O código de erro. |
| details |
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 |
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 |
Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned Identidades |
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. |