Workspaces - Update

Dienst:

Log Analytics

API-Version:

2026-03-01

Aktualisiert einen Arbeitsbereich.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
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 (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Der Name des Arbeitsbereichs.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
identity	Identity	Die Identität der Ressource.
properties.defaultDataCollectionRuleResourceId	string	Die Ressourcen-ID der Standarddatensammlungsregel, die für diesen Arbeitsbereich verwendet werden soll. Das erwartete Format lautet : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties	Arbeitsbereichfailovereigenschaften.
properties.features	WorkspaceFeatures	Arbeitsbereichsfeatures.
properties.forceCmkForQuery	boolean	Gibt an, ob der vom Kunden verwaltete Speicher für die Abfrageverwaltung obligatorisch ist.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Erfassung.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Abfrage.
properties.replication	WorkspaceReplicationProperties	Arbeitsbereichreplikationseigenschaften.
properties.retentionInDays	integer (int32)	Die Aufbewahrung von Arbeitsbereichsdaten in Tagen. Zulässige Werte sind pro Preisplan. Ausführliche Informationen finden Sie in der Dokumentation zu Preisniveaus.
properties.sku	WorkspaceSku	Die SKU des Arbeitsbereichs.
properties.workspaceCapping	WorkspaceCapping	Die tägliche Volumengrenze für die Aufnahme.
tags	object	Ressourcenkennzeichnungen. Dies ist optional.

Antworten

Name	Typ	Beschreibung
200 OK	Workspace	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

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

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

WorkspacesPatch

Beispielanforderung

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2026-03-01

{
  "properties": {
    "retentionInDays": 30,
    "sku": {
      "name": "PerGB2018"
    },
    "workspaceCapping": {
      "dailyQuotaGb": -1
    }
  }
}

Beispiel für eine Antwort

Statuscode:

200

{
  "location": "australiasoutheast",
  "properties": {
    "publicNetworkAccessForIngestion": "Enabled",
    "publicNetworkAccessForQuery": "Enabled",
    "retentionInDays": 30,
    "sku": {
      "name": "PerGB2018"
    },
    "workspaceCapping": {
      "dailyQuotaGb": -1,
      "dataIngestionStatus": "RespectQuota",
      "quotaNextResetTime": "Mon, 16 Nov 2020 15:00:00 GMT"
    }
  },
  "tags": {
    "tag1": "val1"
  }
}

Definitionen

Name	Beschreibung
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DataIngestionStatus	Der Status der Datenerfassung für diesen Arbeitsbereich.
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
Identity	Identität für die Ressource.
IdentityType	Typ der verwalteten Dienstidentität.
PrivateLinkScopedResource	Der Ressourcenverweis für den privaten Linkbereich.
PublicNetworkAccessType	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Erfassung.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
UserIdentityProperties	Vom Benutzer zugewiesene Identitätseigenschaften.
Workspace	Der Ressourcencontainer der obersten Ebene des Arbeitsbereichs.
WorkspaceCapping	Die tägliche Volumengrenze für die Aufnahme.
WorkspaceEntityStatus	Der Bereitstellungsstatus des Arbeitsbereichs.
WorkspaceFailoverProperties	Der Failoverstatus der Replikation.
WorkspaceFailoverState	Der Failoverstatus der Replikation.
WorkspaceFeatures	Arbeitsbereichsfeatures.
WorkspacePatch	Der Ressourcencontainer der obersten Ebene des Arbeitsbereichs.
WorkspaceReplicationProperties	Eigenschaften der Arbeitsbereichsreplikation.
WorkspaceReplicationState	Der Bereitstellungsstatus der Replizierung.
WorkspaceSku	Die SKU (Ebene) eines Arbeitsbereichs.
WorkspaceSkuNameEnum	Der Name der SKU.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DataIngestionStatus

Enumeration

Der Status der Datenerfassung für diesen Arbeitsbereich.

Wert	Beschreibung
RespectQuota	Die Aufnahme wurde nach dem Zurücksetzen des Tageskontingents oder der Abonnementaktivierung aktiviert.
ForceOn	Die Aufnahme hat mit der Änderung der Diensteinstellung begonnen.
ForceOff	Die Aufnahme wurde nach der Änderung der Diensteinstellung beendet.
OverQuota	Das tageshöchste Kontingent wurde erreicht, die Aufnahme wurde beendet.
SubscriptionSuspended	Die Aufnahme wurde nach dem angehaltenen Abonnement beendet.
ApproachingQuota	80% des tageshöchsten Kontingents erreicht.

ErrorAdditionalInfo

Objekt

Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der Zusatzinformationen.

ErrorDetail

Objekt

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die Zusatzinformationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Der Fehlerzielwert.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

Identity

Objekt

Identität für die Ressource.

Name	Typ	Beschreibung
principalId	string	Die Prinzipal-ID der Ressourcenidentität.
tenantId	string	Die Mandanten-ID der Ressource.
type	IdentityType	Typ der verwalteten Dienstidentität.
userAssignedIdentities	<string,  UserIdentityProperties>	Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

IdentityType

Enumeration

Typ der verwalteten Dienstidentität.

Wert	Beschreibung
SystemAssigned	SystemAssigned
UserAssigned	UserAssigned
None	Nichts

PrivateLinkScopedResource

Objekt

Der Ressourcenverweis für den privaten Linkbereich.

Name	Typ	Beschreibung
resourceId	string	Die vollständige Ressourcen-ID der Private Link-Bereichsressource.
scopeId	string	Der eindeutige Bezeichner des Private Link-Bereichs.

PublicNetworkAccessType

Enumeration

Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Erfassung.

Wert	Beschreibung
Enabled	Ermöglicht die Konnektivität mit Log Analytics über öffentliches DNS.
Disabled	Deaktiviert die öffentliche Konnektivität mit Log Analytics über öffentliches DNS.
SecuredByPerimeter	Der Zugriff auf die Ressource ist nur über private Netzwerke und der Zugriff vom Netzwerksicherheitsbereich genehmigt, der dieser Ressource zugeordnet ist.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserIdentityProperties

Objekt

Vom Benutzer zugewiesene Identitätseigenschaften.

Name	Typ	Beschreibung
clientId	string	Die Client-ID der vom Benutzer zugewiesenen Identität.
principalId	string	Die Prinzipal-ID der vom Benutzer zugewiesenen Identität.

Workspace

Objekt

Der Ressourcencontainer der obersten Ebene des Arbeitsbereichs.

Name	Typ	Standardwert	Beschreibung
etag	string		Das Etag des Arbeitsbereichs.
id	string (arm-id)		Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	Identity		Die Identität der Ressource.
location	string		Der geografische Standort, an dem sich die Ressource befindet
name	string		Der Name der Ressource
properties.createdDate	string (date-time)		Erstellungsdatum des Arbeitsbereichs.
properties.customerId	string		Dies ist eine schreibgeschützte Eigenschaft. Stellt die id dar, die dem Arbeitsbereich zugeordnet ist.
properties.defaultDataCollectionRuleResourceId	string		Die Ressourcen-ID der Standarddatensammlungsregel, die für diesen Arbeitsbereich verwendet werden soll. Das erwartete Format lautet : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		Arbeitsbereichfailovereigenschaften.
properties.features	WorkspaceFeatures		Arbeitsbereichsfeatures.
properties.forceCmkForQuery	boolean		Gibt an, ob der vom Kunden verwaltete Speicher für die Abfrageverwaltung obligatorisch ist.
properties.modifiedDate	string (date-time)		Änderungsdatum des Arbeitsbereichs.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Liste der verknüpften Ressourcen für den Privaten Linkbereich.
properties.provisioningState	WorkspaceEntityStatus		Der Bereitstellungsstatus des Arbeitsbereichs.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Erfassung.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Abfrage.
properties.replication	WorkspaceReplicationProperties		Arbeitsbereichreplikationseigenschaften.
properties.retentionInDays	integer (int32)		Die Aufbewahrung von Arbeitsbereichsdaten in Tagen. Zulässige Werte sind pro Preisplan. Ausführliche Informationen finden Sie in der Dokumentation zu Preisniveaus.
properties.sku	WorkspaceSku		Die SKU des Arbeitsbereichs.
properties.workspaceCapping	WorkspaceCapping		Die tägliche Volumengrenze für die Aufnahme.
systemData	systemData		Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object		Ressourcenkennzeichnungen.
type	string		Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Objekt

Die tägliche Volumengrenze für die Aufnahme.

Name	Typ	Beschreibung
dailyQuotaGb	number (double)	Das tägliche Arbeitsbereichskontingent für die Aufnahme.
dataIngestionStatus	DataIngestionStatus	Der Status der Datenerfassung für diesen Arbeitsbereich.
quotaNextResetTime	string	Der Zeitpunkt, zu dem das Kontingent ruhet.

WorkspaceEntityStatus

Enumeration

Der Bereitstellungsstatus des Arbeitsbereichs.

Wert	Beschreibung
Creating	Erstellen
Succeeded	Erfolgt
Failed	Failed
Canceled	Abgesagt
Deleting	Löschen
ProvisioningAccount	ProvisioningAccount
Updating	Aktualisierung

WorkspaceFailoverProperties

Objekt

Der Failoverstatus der Replikation.

Name	Typ	Beschreibung
lastModifiedDate	string (date-time)	Das letzte Mal, als der Failoverstatus aktualisiert wurde.
state	WorkspaceFailoverState	Der Failoverstatus der Replikation.

WorkspaceFailoverState

Enumeration

Der Failoverstatus der Replikation.

Wert	Beschreibung
Inactive	Inaktiv
Activating	Aktivierend
Active	Aktiv
Deactivating	Deaktivieren
Failed	Failed

WorkspaceFeatures

Objekt

Arbeitsbereichsfeatures.

Name	Typ	Beschreibung
associations	string[]	Liste der Zuordnungen für den Arbeitsbereich. Gibt an, ob der Arbeitsbereich mit einer der folgenden Erfahrungen verknüpft ist: MDC, Sentinel, SentinelGraph usw.
clusterResourceId	string	Dedizierte LA-Clusterressourcen-ID, die mit den Arbeitsbereichen verknüpft ist.
dataAuthorizationMode	boolean	Aktivieren Sie den Datenautorisierungsmodus für den Arbeitsbereich.
disableLocalAuth	boolean	Deaktivieren Sie nicht AAD-basierte Authentifizierung.
enableDataExport	boolean	Flag, das angibt, ob Daten exportiert werden sollen.
enableLogAccessUsingOnlyResourcePermissions	boolean	Flag, das angibt, welche Berechtigung verwendet werden soll – Ressource oder Arbeitsbereich oder beides.
immediatePurgeDataOn30Days	boolean	Kennzeichnen, das beschreibt, ob die Daten nach 30 Tagen entfernt werden sollen.
unifiedSentinelBillingOnly	boolean	Ein Angabe, ob der angegebene Arbeitsbereich nur auf das einheitliche Abrechnungsmodell von Sentinel beschränkt ist.

WorkspacePatch

Objekt

Der Ressourcencontainer der obersten Ebene des Arbeitsbereichs.

Name	Typ	Standardwert	Beschreibung
etag	string		Ressourcen-Etag.
id	string (arm-id)		Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	Identity		Die Identität der Ressource.
name	string		Der Name der Ressource
properties.createdDate	string (date-time)		Erstellungsdatum des Arbeitsbereichs.
properties.customerId	string		Dies ist eine schreibgeschützte Eigenschaft. Stellt die id dar, die dem Arbeitsbereich zugeordnet ist.
properties.defaultDataCollectionRuleResourceId	string		Die Ressourcen-ID der Standarddatensammlungsregel, die für diesen Arbeitsbereich verwendet werden soll. Das erwartete Format lautet : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		Arbeitsbereichfailovereigenschaften.
properties.features	WorkspaceFeatures		Arbeitsbereichsfeatures.
properties.forceCmkForQuery	boolean		Gibt an, ob der vom Kunden verwaltete Speicher für die Abfrageverwaltung obligatorisch ist.
properties.modifiedDate	string (date-time)		Änderungsdatum des Arbeitsbereichs.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Liste der verknüpften Ressourcen für den Privaten Linkbereich.
properties.provisioningState	WorkspaceEntityStatus		Der Bereitstellungsstatus des Arbeitsbereichs.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Erfassung.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Der Netzwerkzugriffstyp für den Zugriff auf log Analytics-Abfrage.
properties.replication	WorkspaceReplicationProperties		Arbeitsbereichreplikationseigenschaften.
properties.retentionInDays	integer (int32)		Die Aufbewahrung von Arbeitsbereichsdaten in Tagen. Zulässige Werte sind pro Preisplan. Ausführliche Informationen finden Sie in der Dokumentation zu Preisniveaus.
properties.sku	WorkspaceSku		Die SKU des Arbeitsbereichs.
properties.workspaceCapping	WorkspaceCapping		Die tägliche Volumengrenze für die Aufnahme.
systemData	systemData		Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object		Ressourcenkennzeichnungen. Dies ist optional.
type	string		Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

WorkspaceReplicationProperties

Objekt

Eigenschaften der Arbeitsbereichsreplikation.

Name	Typ	Beschreibung
createdDate	string (date-time)	Der Zeitpunkt, zu dem die Replizierung das letzte Mal aktiviert wurde.
enabled	boolean	Gibt an, ob die Replikation aktiviert ist oder nicht. Wenn "true", wird die Arbeitsbereichskonfiguration und -daten an den angegebenen Speicherort repliziert. Wenn die Replikation aktiviert ist, muss der Standort angegeben werden.
lastModifiedDate	string (date-time)	Der Zeitpunkt, zu dem die Replizierung das letzte Mal aktualisiert wurde.
location	string	Der Speicherort der Replikation.
provisioningState	WorkspaceReplicationState	Der Bereitstellungsstatus der Replizierung.

WorkspaceReplicationState

Enumeration

Der Bereitstellungsstatus der Replizierung.

Wert	Beschreibung
Succeeded	Erfolgt
EnableRequested	AktivierenAngefragt
Enabling	Aktivierung
DisableRequested	DeaktivierenAngefragt
Disabling	Deaktivieren
RollbackRequested	RollbackAngefragt
RollingBack	RollingBack
Failed	Failed
Canceled	Abgesagt

WorkspaceSku

Objekt

Die SKU (Ebene) eines Arbeitsbereichs.

Name	Typ	Beschreibung
capacityReservationLevel	integer (int32)	Die Kapazitätsreservierungsebene in GB für diesen Arbeitsbereich, wenn capacityReservation sku ausgewählt ist.
lastSkuUpdate	string (date-time)	Das letzte Mal, zu dem die SKU aktualisiert wurde.
name	WorkspaceSkuNameEnum	Der Name der SKU.

WorkspaceSkuNameEnum

Enumeration

Der Name der SKU.

Wert	Beschreibung
Free	Kostenlos
Standard	Standard
Premium	Premium
PerNode	PerNode
PerGB2018	PerGB2018
Standalone	Eigenständig
CapacityReservation	CapacityReservation
LACluster	LACluster