Clusters - Update

Servizio:: Log Analytics

Versione API:: 2026-03-01

Aggiorna un cluster Log Analytics.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2026-03-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
clusterName	path	True	string	Nome del cluster Log Analytics.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità della risorsa.
properties.billingType	BillingType	Tipo di fatturazione del cluster.
properties.keyVaultProperties	keyVaultProperties	Proprietà della chiave associate.
sku	ClusterSku	Proprietà sku.
tags	object	Tag delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	Cluster	L'operazione di Azure è stata completata correttamente.
202 Accepted		Richiesta di aggiornamento delle risorse accettata. Intestazioni Azure-AsyncOperation: string Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

Cluster

L'operazione di Azure è stata completata correttamente.

202 Accepted

Richiesta di aggiornamento delle risorse accettata.

Intestazioni

Azure-AsyncOperation: string
Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

ClustersPatch

Esempio di richiesta

HTTP

PATCH https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2026-03-01

{
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {}
    }
  },
  "properties": {
    "keyVaultProperties": {
      "keyName": "aztest2170cert",
      "keyRsaSize": 1024,
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyVersion": ""
    }
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "tags": {
    "tag1": "val1"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/clusters",
  "id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685",
  "identity": {
    "type": "UserAssigned",
    "tenantId": "72f999bf-acf1-41af-91ab-2d7cd011db47",
    "userAssignedIdentities": {
      "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {
        "clientId": "eb3a943d-6b12-48a6-b585-ac2316e15ab2",
        "principalId": "b31776d4-ee80-4860-9433-ec0101be1891"
      }
    }
  },
  "location": "australiasoutheast",
  "properties": {
    "associatedWorkspaces": [
      {
        "associateDate": "2020-07-05T07:35:51Z",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs1",
        "workspaceId": "942bdefd-e6c9-411c-ac69-70ffad564363",
        "workspaceName": "testWs1"
      },
      {
        "associateDate": "2020-07-05T07:35:51Z",
        "resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs2",
        "workspaceId": "c7edb8f8-67f7-41f2-bddb-aecf22507e3f",
        "workspaceName": "testWs2"
      }
    ],
    "billingType": "Cluster",
    "capacityReservationProperties": {
      "lastSkuUpdate": "2020-07-04T07:35:51Z",
      "minCapacity": 100
    },
    "clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1",
    "createdDate": "2020-07-04T07:35:51Z",
    "keyVaultProperties": {
      "keyName": "aztest2170cert",
      "keyVaultUri": "https://aztest2170.vault.azure.net",
      "keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
    },
    "lastModifiedDate": "2020-07-04T07:35:51Z",
    "provisioningState": "Succeeded"
  },
  "sku": {
    "name": "CapacityReservation",
    "capacity": 1000
  },
  "tags": {
    "tag1": "val1"
  }
}

Codice di stato:: 202

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=2026-03-01
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=2026-03-01

Definizioni

Nome	Descrizione
AssociatedWorkspace	Elenco delle aree di lavoro Log Analytics associate al cluster.
BillingType	Configura se la fatturazione sarà solo sul cluster o se ogni spazio di lavoro sarà fatturato in base al suo uso proporzionale. Questo non cambia la fatturazione complessiva, ma solo il modo in cui verrà distribuita. Il valore predefinito è 'Cluster'
CapacityReservationProperties	Proprietà della prenotazione della capacità.
Cluster	Contenitore di risorse cluster di Log Analytics di primo livello.
ClusterEntityStatus	Stato di provisioning del cluster.
ClusterPatch	Contenitore di risorse cluster di Log Analytics di primo livello.
ClusterReplicationProperties	Proprietà di replica cluster.
ClusterReplicationState	Stato di provisioning della replica del cluster.
ClusterSku	Definizione dello SKU del cluster.
ClusterSkuNameEnum	SKU (livello) di un cluster.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
keyVaultProperties	Proprietà dell'insieme di credenziali delle chiavi.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

AssociatedWorkspace

Oggetto

Elenco delle aree di lavoro Log Analytics associate al cluster.

Nome	Tipo	Descrizione
associateDate	string (date-time)	Ora dell'associazione dell'area di lavoro.
resourceId	string (arm-id)	ID risorsa braccio dell'area di lavoro associato, nel formato '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string (uuid)	ID immutabile dell'area di lavoro associata.
workspaceName	string	Nome della risorsa dell'area di lavoro associata.

BillingType

Enumerazione

Configura se la fatturazione sarà solo sul cluster o se ogni spazio di lavoro sarà fatturato in base al suo uso proporzionale. Questo non cambia la fatturazione complessiva, ma solo il modo in cui verrà distribuita. Il valore predefinito è 'Cluster'

Valore	Descrizione
Cluster	Cluster
Workspaces	Aree di lavoro

CapacityReservationProperties

Oggetto

Proprietà della prenotazione della capacità.

Nome	Tipo	Descrizione
lastSkuUpdate	string (date-time)	Ultima volta che lo SKU è stato aggiornato.
minCapacity	integer (int64)	Valore minimo di CapacityReservation in gigabyte.

Cluster

Oggetto

Contenitore di risorse cluster di Log Analytics di primo livello.

Nome	Tipo	Descrizione
id	string (arm-id)	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
location	string	Posizione geografica in cui risiede la risorsa
name	string	nome della risorsa.
properties.associatedWorkspaces	AssociatedWorkspace[]	Elenco delle aree di lavoro Log Analytics associate al cluster
properties.billingType	BillingType	Tipo di fatturazione del cluster.
properties.capacityReservationProperties	CapacityReservationProperties	Proprietà aggiuntive per la prenotazione della capacità
properties.clusterId	string	ID associato al cluster.
properties.createdDate	string (date-time)	L'ora di creazione del cluster
properties.isAvailabilityZonesEnabled	boolean	Imposta un valore che indica se il cluster supporterà le zone di disponibilità. Questo valore può essere impostato come true solo nelle aree in cui Esplora dati di Azure supporta le zone di disponibilità. Questa proprietà non può essere modificata dopo la creazione del cluster. Il valore predefinito è "true" se l'area supporta le zone di disponibilità.
properties.isDoubleEncryptionEnabled	boolean	Configura se il cluster userà la doppia crittografia. Questa proprietà non può essere modificata dopo la creazione del cluster. Il valore predefinito è 'true'
properties.keyVaultProperties	keyVaultProperties	Proprietà della chiave associate.
properties.lastModifiedDate	string (date-time)	Ultima volta che il cluster è stato aggiornato.
properties.provisioningState	ClusterEntityStatus	Stato di provisioning del cluster.
properties.replication	ClusterReplicationProperties	Proprietà di replica del cluster.
sku	ClusterSku	Proprietà sku.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag delle risorse.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Enumerazione

Stato di provisioning del cluster.

Valore	Descrizione
Creating	Creazione
Succeeded	Succeeded
Failed	Non riuscito
Canceled	Annullato
Deleting	Eliminazione
ProvisioningAccount	ProvisioningAccount
Updating	Updating

ClusterPatch

Oggetto

Contenitore di risorse cluster di Log Analytics di primo livello.

Nome	Tipo	Descrizione
identity	ManagedServiceIdentity	Identità della risorsa.
properties.billingType	BillingType	Tipo di fatturazione del cluster.
properties.keyVaultProperties	keyVaultProperties	Proprietà della chiave associate.
sku	ClusterSku	Proprietà sku.
tags	object	Tag delle risorse.

ClusterReplicationProperties

Oggetto

Proprietà di replica cluster.

Nome	Tipo	Descrizione
createdDate	string (date-time)	Ora di creazione della replica del cluster
enabled	boolean	Specifica se la replica è abilitata o meno. Se true, il cluster viene replicato nella posizione specificata.
isAvailabilityZonesEnabled	boolean	Deve abilitare AvailabilityZones per il cluster replicato specificato
lastModifiedDate	string (date-time)	L'ultima volta che la replica del cluster è stata aggiornata.
location	string	Posizione secondaria della replica. Se la replica è abilitata, è necessario specificare abilitato.
provisioningState	ClusterReplicationState	Stato di provisioning della replica del cluster.

ClusterReplicationState

Enumerazione

Stato di provisioning della replica del cluster.

Valore	Descrizione
Succeeded	Succeeded
EnableRequested	EnableRequested
Enabling	Abilitazione
DisableRequested	DisabilitaRichiesto
Disabling	Disattivazione
RollbackRequested	Ripetizione Riposta
RollingBack	RollingBack
Failed	Non riuscito
Canceled	Annullato

ClusterSku

Oggetto

Definizione dello SKU del cluster.

Nome	Tipo	Descrizione
capacity	integer (int64)	Livello di prenotazione della capacità in Gigabyte per questo cluster.
name	ClusterSkuNameEnum	SKU (livello) di un cluster.

ClusterSkuNameEnum

Enumerazione

SKU (livello) di un cluster.

Valore	Descrizione
CapacityReservation	CapacityReservation

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	La destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

keyVaultProperties

Oggetto

Proprietà dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
keyName	string	Nome della chiave associata al cluster di Log Analytics.
keyRsaSize	integer (int32)	Dimensione minima richiesta della chiave selezionata.
keyVaultUri	string	URI di Key Vault che contiene la chiave associata al cluster di Log Analytics.
keyVersion	string	Versione della chiave associata al cluster di Log Analytics.

ManagedServiceIdentity

Oggetto

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string (uuid)	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string (uuid)	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore	Descrizione
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Oggetto

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client dell'identità assegnata.
principalId	string (uuid)	ID entità dell'identità assegnata.