Clusters - Update
Aktualizuje klaster usługi Log Analytics.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2025-07-01
Parametry URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
Nazwa klastra usługi Log Analytics. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Ciało żądania
| Nazwa | Typ | Opis |
|---|---|---|
| identity |
Tożsamość zasobu. |
|
| properties.billingType |
Typ rozliczeń klastra. |
|
| properties.keyVaultProperties |
Skojarzone właściwości klucza. |
|
| sku |
Właściwości jednostki SKU. |
|
| tags |
object |
Tagi zasobów. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Istniejący klaster został pomyślnie zaktualizowany. Sprawdź provisioningStatus , aby wyświetlić szczegółowy stan. |
|
| 202 Accepted |
Definicja zaakceptowanej odpowiedzi (operacja długotrwała). Nagłówki
|
|
| Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ protokołu OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresów
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
ClustersPatch
Przykładowa prośba
PATCH https://management.azure.com/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/clusters/oiautorest6685?api-version=2025-07-01
{
"identity": {
"type": "UserAssigned",
"userAssignedIdentities": {
"/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myidentity": {}
}
},
"properties": {
"keyVaultProperties": {
"keyVaultUri": "https://aztest2170.vault.azure.net",
"keyName": "aztest2170cert",
"keyVersion": "",
"keyRsaSize": 1024
}
},
"sku": {
"name": "CapacityReservation",
"capacity": 1000
},
"tags": {
"tag1": "val1"
}
}
Przykładowa odpowiedź
{
"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"
}
}
},
"properties": {
"keyVaultProperties": {
"keyVaultUri": "https://aztest2170.vault.azure.net",
"keyName": "aztest2170cert",
"keyVersion": "654ft6c4e63845cbb50fd6fg51540429"
},
"provisioningState": "Succeeded",
"clusterId": "1c3f2afc-9ec1-4e74-bfe8-022b83bcd7b1",
"billingType": "Cluster",
"lastModifiedDate": "2020-07-04T07:35:51Z",
"createdDate": "2020-07-04T07:35:51Z",
"associatedWorkspaces": [
{
"workspaceId": "942bdefd-e6c9-411c-ac69-70ffad564363",
"workspaceName": "testWs1",
"resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs1",
"associateDate": "2020-07-05T07:35:51Z"
},
{
"workspaceId": "c7edb8f8-67f7-41f2-bddb-aecf22507e3f",
"workspaceName": "testWs2",
"resourceId": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/testRG/providers/microsoft.operationalinsights/workspaces/testWs2",
"associateDate": "2020-07-05T07:35:51Z"
}
],
"capacityReservationProperties": {
"lastSkuUpdate": "2020-07-04T07:35:51Z",
"minCapacity": 100
}
},
"sku": {
"name": "CapacityReservation",
"capacity": 1000
},
"location": "australiasoutheast",
"tags": {
"tag1": "val1"
},
"name": "oiautorest6685",
"type": "Microsoft.OperationalInsights/clusters",
"id": "/subscriptions/53bc36c5-91e1-4d09-92c9-63b89e571926/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/clusters/oiautorest6685"
}
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
Definicje
| Nazwa | Opis |
|---|---|
|
Associated |
Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem. |
|
Billing |
Typ rozliczeń klastra. |
|
Capacity |
Właściwości Rezerwacja zdolności produkcyjnych. |
| Cluster |
Kontener zasobów klastra usługi Log Analytics najwyższego poziomu. |
|
Cluster |
Stan aprowizacji klastra. |
|
Cluster |
Kontener zasobów klastra usługi Log Analytics najwyższego poziomu. |
|
Cluster |
Właściwości replikacji klastra. |
|
Cluster |
Stan aprowizacji replikacji klastra. |
|
Cluster |
Definicja jednostki SKU klastra. |
|
Cluster |
Jednostka SKU (warstwa) klastra. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
key |
Właściwości magazynu kluczy. |
|
Managed |
Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika) |
|
Managed |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
|
User |
Właściwości tożsamości przypisanej przez użytkownika |
AssociatedWorkspace
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
Typ rozliczeń klastra.
| Wartość | Opis |
|---|---|
| Cluster | |
| Workspaces |
CapacityReservationProperties
Właściwości Rezerwacja zdolności produkcyjnych.
| Nazwa | Typ | Opis |
|---|---|---|
| lastSkuUpdate |
string (date-time) |
Ostatnia aktualizacja jednostki SKU. |
| minCapacity |
integer (int64) |
Minimalna wartość CapacityReservation w gigabajtach. |
Cluster
Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.
| Nazwa | Typ | Opis |
|---|---|---|
| id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| identity |
Tożsamość zasobu. |
|
| location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| name |
string |
Nazwa zasobu |
| properties.associatedWorkspaces |
Lista obszarów roboczych usługi Log Analytics skojarzonych z klastrem |
|
| properties.billingType |
Typ rozliczeń klastra. |
|
| properties.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 |
Skojarzone właściwości klucza. |
|
| properties.lastModifiedDate |
string (date-time) |
Ostatnia aktualizacja klastra. |
| properties.provisioningState |
Stan aprowizacji klastra. |
|
| properties.replication |
Właściwości replikacji klastra. |
|
| sku |
Właściwości jednostki SKU. |
|
| tags |
object |
Tagi zasobów. |
| type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
ClusterEntityStatus
Stan aprowizacji klastra.
| Wartość | Opis |
|---|---|
| Creating | |
| Succeeded | |
| Failed | |
| Canceled | |
| Deleting | |
| ProvisioningAccount | |
| Updating |
ClusterPatch
Kontener zasobów klastra usługi Log Analytics najwyższego poziomu.
| Nazwa | Typ | Opis |
|---|---|---|
| identity |
Tożsamość zasobu. |
|
| properties.billingType |
Typ rozliczeń klastra. |
|
| properties.keyVaultProperties |
Skojarzone właściwości klucza. |
|
| sku |
Właściwości jednostki SKU. |
|
| tags |
object |
Tagi zasobów. |
ClusterReplicationProperties
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 |
Stan aprowizacji replikacji klastra. |
ClusterReplicationState
Stan aprowizacji replikacji klastra.
| Wartość | Opis |
|---|---|
| Succeeded | |
| EnableRequested | |
| Enabling | |
| DisableRequested | |
| Disabling | |
| RollbackRequested | |
| RollingBack | |
| Failed | |
| Canceled |
ClusterSku
Definicja jednostki SKU klastra.
| Nazwa | Typ | Opis |
|---|---|---|
| capacity |
integer (int64) |
Poziom rezerwacji pojemności w gigabajtach dla tego klastra. |
| name |
Jednostka SKU (warstwa) klastra. |
ClusterSkuNameEnum
Jednostka SKU (warstwa) klastra.
| Wartość | Opis |
|---|---|
| CapacityReservation |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
keyVaultProperties
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
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 |
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). |
|
| userAssignedIdentities |
<string,
User |
tożsamości User-Assigned |
ManagedServiceIdentityType
Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
| Wartość | Opis |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
UserAssignedIdentity
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. |