Clusters - Update

Usługa:

Log Analytics

Wersja interfejsu API:

2026-03-01

Aktualizuje klaster usługi Log Analytics.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
clusterName	path	True	string	Nazwa klastra usługi Log Analytics.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
identity	ManagedServiceIdentity	Tożsamość zasobu.
properties.billingType	BillingType	Typ rozliczeń klastra.
properties.keyVaultProperties	keyVaultProperties	Skojarzone właściwości klucza.
sku	ClusterSku	Właściwości jednostki SKU.
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Cluster	Operacja platformy Azure została zakończona pomyślnie.
202 Accepted		Żądanie aktualizacji zasobu zostało zaakceptowane. Nagłówki Azure-AsyncOperation: string Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

ClustersPatch

Przykładowe żądanie

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"
  }
}

Przykładowa odpowiedź

Kod stanu:

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"
  }
}

Kod stanu:

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

Definicje

Nazwa	Opis
AssociatedWorkspace	Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem.
BillingType	Konfiguruje, czy rozliczenia będą dostępne tylko na klastrze, czy każda przestrzeń robocza będzie rozliczana proporcjonalnie do swojego wykorzystania. To nie zmienia ogólnej faktury, jedynie sposób dystrybucji. Domyślna wartość to 'Cluster'
CapacityReservationProperties	Właściwości Rezerwacja pojemności.
Cluster	Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.
ClusterEntityStatus	Stan aprowizacji klastra.
ClusterPatch	Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.
ClusterReplicationProperties	Właściwości replikacji klastra.
ClusterReplicationState	Stan aprowizacji replikacji klastra.
ClusterSku	Definicja jednostki SKU klastra.
ClusterSkuNameEnum	Jednostka SKU (warstwa) klastra.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
keyVaultProperties	Właściwości magazynu kluczy.
ManagedServiceIdentity	Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)
ManagedServiceIdentityType	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
UserAssignedIdentity	Właściwości tożsamości przypisanej przez użytkownika

AssociatedWorkspace

Objekt

Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem.

Nazwa	Typ	Opis
associateDate	string (date-time)	Czas skojarzenia obszaru roboczego.
resourceId	string (arm-id)	Skojarzony identyfikator zasobu ramienia obszaru roboczego w postaci: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.
workspaceId	string (uuid)	Skojarzony niezmienny identyfikator obszaru roboczego.
workspaceName	string	Skojarzona nazwa zasobu obszaru roboczego.

BillingType

Wyliczenie

Konfiguruje, czy rozliczenia będą dostępne tylko na klastrze, czy każda przestrzeń robocza będzie rozliczana proporcjonalnie do swojego wykorzystania. To nie zmienia ogólnej faktury, jedynie sposób dystrybucji. Domyślna wartość to 'Cluster'

Wartość	Opis
Cluster	Cluster
Workspaces	Przestrzenie robocze

CapacityReservationProperties

Objekt

Właściwości Rezerwacja pojemności.

Nazwa	Typ	Opis
lastSkuUpdate	string (date-time)	Czas ostatniej aktualizacji jednostki SKU.
minCapacity	integer (int64)	Minimalna wartość CapacityReservation w gigabajtach.

Cluster

Objekt

Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni określony identyfikator zasobu dla tego zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Tożsamości usługi zarządzanej przypisane do tego zasobu.
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.associatedWorkspaces	AssociatedWorkspace[]	Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem
properties.billingType	BillingType	Typ rozliczeń klastra.
properties.capacityReservationProperties	CapacityReservationProperties	Dodatkowe właściwości rezerwacji pojemności
properties.clusterId	string	Identyfikator skojarzony z klastrem.
properties.createdDate	string (date-time)	Czas tworzenia klastra
properties.isAvailabilityZonesEnabled	boolean	Określa, czy klaster będzie obsługiwał strefy dostępności. Można to ustawić jako true tylko w regionach, w których usługa Azure Data Explorer obsługuje strefy dostępności. Tej właściwości nie można modyfikować po utworzeniu klastra. Wartość domyślna to "true", jeśli region obsługuje strefy dostępności.
properties.isDoubleEncryptionEnabled	boolean	Określa, czy klaster będzie używać podwójnego szyfrowania. Tej właściwości nie można modyfikować po utworzeniu klastra. Wartość domyślna to "true"
properties.keyVaultProperties	keyVaultProperties	Skojarzone właściwości klucza.
properties.lastModifiedDate	string (date-time)	Ostatni raz klaster został zaktualizowany.
properties.provisioningState	ClusterEntityStatus	Stan aprowizacji klastra.
properties.replication	ClusterReplicationProperties	Właściwości replikacji klastra.
sku	ClusterSku	Właściwości jednostki SKU.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Wyliczenie

Stan aprowizacji klastra.

Wartość	Opis
Creating	Tworzenie
Succeeded	Succeeded
Failed	Failed
Canceled	Anulowane
Deleting	Usuwanie
ProvisioningAccount	Aprowizowanie konta
Updating	Aktualizowanie

ClusterPatch

Objekt

Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.

Nazwa	Typ	Opis
identity	ManagedServiceIdentity	Tożsamość zasobu.
properties.billingType	BillingType	Typ rozliczeń klastra.
properties.keyVaultProperties	keyVaultProperties	Skojarzone właściwości klucza.
sku	ClusterSku	Właściwości jednostki SKU.
tags	object	Tagi zasobów.

ClusterReplicationProperties

Objekt

Właściwości replikacji klastra.

Nazwa	Typ	Opis
createdDate	string (date-time)	Czas tworzenia replikacji klastra
enabled	boolean	Określa, czy replikacja jest włączona, czy nie. W przypadku wartości true klaster jest replikowany do określonej lokalizacji.
isAvailabilityZonesEnabled	boolean	Powinna włączyć strefy dostępności dla danego zreplikowanego klastra
lastModifiedDate	string (date-time)	Ostatnia aktualizacja replikacji klastra.
location	string	Lokalizacja pomocnicza replikacji. Jeśli replikacja jest włączona, należy podać włączone.
provisioningState	ClusterReplicationState	Stan aprowizacji replikacji klastra.

ClusterReplicationState

Wyliczenie

Stan aprowizacji replikacji klastra.

Wartość	Opis
Succeeded	Succeeded
EnableRequested	EnableRequested
Enabling	Włączanie
DisableRequested	DisableRequested
Disabling	Wyłączanie
RollbackRequested	RollbackRequests
RollingBack	RollingBack
Failed	Failed
Canceled	Anulowane

ClusterSku

Objekt

Definicja jednostki SKU klastra.

Nazwa	Typ	Opis
capacity	integer (int64)	Poziom rezerwacji pojemności w gigabajtach dla tego klastra.
name	ClusterSkuNameEnum	Jednostka SKU (warstwa) klastra.

ClusterSkuNameEnum

Wyliczenie

Jednostka SKU (warstwa) klastra.

Wartość	Opis
CapacityReservation	CapacityReservation

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Cel błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

keyVaultProperties

Objekt

Właściwości magazynu kluczy.

Nazwa	Typ	Opis
keyName	string	Nazwa klucza skojarzonego z klastrem usługi Log Analytics.
keyRsaSize	integer (int32)	Wybrany minimalny wymagany rozmiar klucza.
keyVaultUri	string	Identyfikator URI usługi Key Vault, który zawiera klucz skojarzony z klastrem usługi Log Analytics.
keyVersion	string	Wersja klucza skojarzonego z klastrem usługi Log Analytics.

ManagedServiceIdentity

Objekt

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)

Nazwa	Typ	Opis
principalId	string (uuid)	Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.
tenantId	string (uuid)	Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.
type	ManagedServiceIdentityType	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
userAssignedIdentities	<string,  UserAssignedIdentity>	tożsamości User-Assigned Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

ManagedServiceIdentityType

Wyliczenie

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

Wartość	Opis
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

UserAssignedIdentity

Objekt

Właściwości tożsamości przypisanej przez użytkownika

Nazwa	Typ	Opis
clientId	string (uuid)	Identyfikator klienta przypisanej tożsamości.
principalId	string (uuid)	Identyfikator podmiotu zabezpieczeń przypisanej tożsamości.