Clusters - Create Or Update
Tworzenie lub aktualizowanie klastra usługi Log Analytics.
PUT 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 minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
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 | Wymagane | Typ | Opis |
|---|---|---|---|
| location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| identity |
Tożsamość 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.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.replication |
Właściwości replikacji klastra. |
||
| sku |
Właściwości jednostki SKU. |
||
| tags |
object |
Tagi zasobów. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Definicja odpowiedzi OK. |
|
| 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
ClustersCreate
Przykładowa prośba
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"
}
}
Przykładowa odpowiedź
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"
}
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 |
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 |
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. |