Freigeben über


Clusters - Create Or Update

Erstellen oder aktualisieren Sie einen Log Analytics-Cluster.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/clusters/{clusterName}?api-version=2025-07-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
clusterName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Der Name des Log Analytics-Clusters.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True

string

minLength: 1

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

minLength: 1

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der geografische Standort, an dem sich die Ressource befindet

identity

ManagedServiceIdentity

Die Identität der Ressource.

properties.associatedWorkspaces

AssociatedWorkspace[]

Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind

properties.billingType

BillingType

Der Abrechnungstyp des Clusters.

properties.capacityReservationProperties

CapacityReservationProperties

Zusätzliche Eigenschaften für die Kapazitätsreservierung

properties.isAvailabilityZonesEnabled

boolean

Legt fest, ob der Cluster Verfügbarkeitszonen unterstützt. Dies kann nur in Regionen festgelegt werden, in denen Azure Data Explorer Verfügbarkeitszonen unterstützt. Diese Eigenschaft kann nach der Clustererstellung nicht geändert werden. Der Standardwert ist "true", wenn die Region Verfügbarkeitszonen unterstützt.

properties.isDoubleEncryptionEnabled

boolean

Konfiguriert, ob der Cluster eine doppelte Verschlüsselung verwendet. Diese Eigenschaft kann nach der Clustererstellung nicht geändert werden. Standardwert ist 'true'.

properties.keyVaultProperties

keyVaultProperties

Die zugeordneten Schlüsseleigenschaften.

properties.replication

ClusterReplicationProperties

Replikationseigenschaften des Clusters.

sku

ClusterSku

Die Sku-Eigenschaften.

tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

Cluster

OK Antwortdefinition.

202 Accepted

Akzeptierte Antwortdefinition (Vorgang mit langer Ausführungszeit).

Header

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

ErrorResponse

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

ClustersCreate

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
AssociatedWorkspace

Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind.

BillingType

Der Abrechnungstyp des Clusters.

CapacityReservationProperties

Die Eigenschaften der Kapazitätsreservierung.

Cluster

Der Log Analytics-Clusterressourcencontainer auf oberster Ebene.

ClusterEntityStatus

Der Bereitstellungsstatus des Clusters.

ClusterReplicationProperties

Eigenschaften der Clusterreplikation.

ClusterReplicationState

Der Bereitstellungsstatus der Clusterreplikation.

ClusterSku

Die Definition der Cluster-SKU.

ClusterSkuNameEnum

Die SKU (Ebene) eines Clusters.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

keyVaultProperties

Die Key Vault-Eigenschaften.

ManagedServiceIdentity

Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

UserAssignedIdentity

Benutzer zugewiesene Identitätseigenschaften

AssociatedWorkspace

Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind.

Name Typ Beschreibung
associateDate

string (date-time)

Der Zeitpunkt der Workspace-Zuordnung.

resourceId

string (arm-id)

Zugeordnete Ressourcen-ID des Arbeitsbereichsarms in der folgenden Form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}.

workspaceId

string (uuid)

Zugeordnete unveränderliche ID des Arbeitsbereichs.

workspaceName

string

Name der zugeordneten Arbeitsbereichsressource.

BillingType

Der Abrechnungstyp des Clusters.

Wert Beschreibung
Cluster
Workspaces

CapacityReservationProperties

Die Eigenschaften der Kapazitätsreservierung.

Name Typ Beschreibung
lastSkuUpdate

string (date-time)

Das letzte Mal, als Sku aktualisiert wurde.

minCapacity

integer (int64)

Minimaler CapacityReservation-Wert in Gigabyte.

Cluster

Der Log Analytics-Clusterressourcencontainer auf oberster Ebene.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ManagedServiceIdentity

Die Identität der Ressource.

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.associatedWorkspaces

AssociatedWorkspace[]

Die Liste der Log Analytics-Arbeitsbereiche, die dem Cluster zugeordnet sind

properties.billingType

BillingType

Der Abrechnungstyp des Clusters.

properties.capacityReservationProperties

CapacityReservationProperties

Zusätzliche Eigenschaften für die Kapazitätsreservierung

properties.clusterId

string

Die ID, die dem Cluster zugeordnet ist.

properties.createdDate

string (date-time)

Die Erstellungszeit des Clusters

properties.isAvailabilityZonesEnabled

boolean

Legt fest, ob der Cluster Verfügbarkeitszonen unterstützt. Dies kann nur in Regionen festgelegt werden, in denen Azure Data Explorer Verfügbarkeitszonen unterstützt. Diese Eigenschaft kann nach der Clustererstellung nicht geändert werden. Der Standardwert ist "true", wenn die Region Verfügbarkeitszonen unterstützt.

properties.isDoubleEncryptionEnabled

boolean

Konfiguriert, ob der Cluster eine doppelte Verschlüsselung verwendet. Diese Eigenschaft kann nach der Clustererstellung nicht geändert werden. Standardwert ist 'true'.

properties.keyVaultProperties

keyVaultProperties

Die zugeordneten Schlüsseleigenschaften.

properties.lastModifiedDate

string (date-time)

Der Zeitpunkt, zu dem der Cluster das letzte Mal aktualisiert wurde.

properties.provisioningState

ClusterEntityStatus

Der Bereitstellungsstatus des Clusters.

properties.replication

ClusterReplicationProperties

Replikationseigenschaften des Clusters.

sku

ClusterSku

Die Sku-Eigenschaften.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ClusterEntityStatus

Der Bereitstellungsstatus des Clusters.

Wert Beschreibung
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

ClusterReplicationProperties

Eigenschaften der Clusterreplikation.

Name Typ Beschreibung
createdDate

string (date-time)

Die Erstellungszeit der Replizierung des Clusters

enabled

boolean

Gibt an, ob die Replikation aktiviert ist oder nicht. Wenn true, wird der Cluster an den angegebenen Speicherort repliziert.

isAvailabilityZonesEnabled

boolean

Sollte AvailabilityZones für den angegebenen replizierten Cluster aktivieren

lastModifiedDate

string (date-time)

Der Zeitpunkt, zu dem die Replizierung des Clusters das letzte Mal aktualisiert wurde.

location

string

Der sekundäre Speicherort der Replikation. Wenn die Replikation aktiviert ist, muss diese Option aktiviert sein.

provisioningState

ClusterReplicationState

Der Bereitstellungsstatus der Clusterreplikation.

ClusterReplicationState

Der Bereitstellungsstatus der Clusterreplikation.

Wert Beschreibung
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

ClusterSku

Die Definition der Cluster-SKU.

Name Typ Beschreibung
capacity

integer (int64)

Die Kapazitätsreservierungsstufe in Gigabyte für diesen Cluster.

name

ClusterSkuNameEnum

Die SKU (Ebene) eines Clusters.

ClusterSkuNameEnum

Die SKU (Ebene) eines Clusters.

Wert Beschreibung
CapacityReservation

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

keyVaultProperties

Die Key Vault-Eigenschaften.

Name Typ Beschreibung
keyName

string

Der Name des Schlüssels, der dem Log Analytics-Cluster zugeordnet ist.

keyRsaSize

integer (int32)

Die erforderliche Mindestgröße des ausgewählten Schlüssels.

keyVaultUri

string

Der Key Vault-URI, der den Schlüssel enthält, der dem Log Analytics-Cluster zugeordnet ist.

keyVersion

string

Die Version des Schlüssels, der dem Log Analytics-Cluster zugeordnet ist.

ManagedServiceIdentity

Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)

Name Typ Beschreibung
principalId

string (uuid)

Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

tenantId

string (uuid)

Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

type

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned Identitäten
Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

Wert Beschreibung
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

UserAssignedIdentity

Benutzer zugewiesene Identitätseigenschaften

Name Typ Beschreibung
clientId

string (uuid)

Die Client-ID der zugewiesenen Identität.

principalId

string (uuid)

Die Prinzipal-ID der zugewiesenen Identität.