Udostępnij przez


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

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

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

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

  • Location: string
  • azure-asyncoperation: string
Other Status Codes

ErrorResponse

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
AssociatedWorkspace

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

BillingType

Typ rozliczeń klastra.

CapacityReservationProperties

Właściwości Rezerwacja zdolności produkcyjnych.

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.

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).

UserAssignedIdentity

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

ManagedServiceIdentity

Tożsamość 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)

Ostatnia aktualizacja klastra.

properties.provisioningState

ClusterEntityStatus

Stan aprowizacji klastra.

properties.replication

ClusterReplicationProperties

Właściwości replikacji klastra.

sku

ClusterSku

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

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

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

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

ClusterSkuNameEnum

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

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

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

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

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

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.