Workspaces - Create Or Update

Service:: Log Analytics

API-versie:: 2025-07-01

Maak of werk een werkruimte bij.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	De naam van de werkruimte.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
parameters	Workspace	De parameters die nodig zijn om een werkruimte te maken of bij te werken.

Antwoorden

Name	Type	Description
200 OK	Workspace	OK antwoord definitie.
201 Created	Workspace	Antwoorddefinitie gemaakt.
202 Accepted		Accepted
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

WorkspacesCreate

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Voorbeeldrespons

Statuscode:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

Statuscode:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

Statuscode:: 202

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
DataIngestionStatus	De status van gegevensopname voor deze werkruimte.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
Identity	Identiteit voor de resource.
PrivateLinkScopedResource	Lijst met bronnen voor het bereik van gekoppelde privékoppelingen.
PublicNetworkAccessType	Het netwerktoegangstype voor toegang tot Log Analytics-opname.
ResourceIdentityType	Het identiteitstype.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Workspace	De resourcecontainer voor werkruimten op het hoogste niveau.
WorkspaceCapping	De dagelijkse volumelimiet voor opname.
WorkspaceEntityStatus	De inrichtingsstatus van de werkruimte.
WorkspaceFailoverProperties	eigenschappen van werkruimtefailover.
WorkspaceFailoverState	De failover-status van de replicatie.
WorkspaceFeatures	Werkruimtefuncties.
WorkspaceReplicationProperties	eigenschappen van werkruimtereplicatie.
WorkspaceReplicationState	De inrichtingsstatus van de replicatie.
WorkspaceSku	De SKU van de werkruimte.
WorkspaceSkuNameEnum	De naam van de SKU.

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DataIngestionStatus

Inventarisatie

De status van gegevensopname voor deze werkruimte.

Waarde	Description
RespectQuota	Opname ingeschakeld na het opnieuw instellen van het quotum voor de dagelijkse limiet of het inschakelen van abonnementen.
ForceOn	De opname is gestart na wijziging van de service-instelling.
ForceOff	De opname is gestopt na wijziging van de service-instelling.
OverQuota	Bereikt dagelijkse limietquotum, inname gestopt.
SubscriptionSuspended	De opname is gestopt na een opgeschort abonnement.
ApproachingQuota	80% van het dagelijkse GLB-quotum bereikt.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

Identity

Object

Identiteit voor de resource.

Name	Type	Description
principalId	string (uuid)	De principal-id van de resource-id. De waarde moet een UUID zijn.
tenantId	string (uuid)	De tenant-id van de resource. De waarde moet een UUID zijn.
type	ResourceIdentityType	Het identiteitstype.

PrivateLinkScopedResource

Object

Lijst met bronnen voor het bereik van gekoppelde privékoppelingen.

Name	Type	Description
resourceId	string	De volledige resource-id van de resource voor het bereik van de privélink.
scopeId	string	De unieke ID van het bereik van de privélink.

PublicNetworkAccessType

Inventarisatie

Het netwerktoegangstype voor toegang tot Log Analytics-opname.

Waarde	Description
Enabled	Maakt connectiviteit met Log Analytics mogelijk via openbare DNS.
Disabled	Hiermee schakelt u de openbare verbinding met Log Analytics uit via openbare DNS.
SecuredByPerimeter	Resource is alleen toegankelijk vanaf particuliere netwerken en de toegang is goedgekeurd door de netwerkbeveiligingsperimeter die aan deze resource is gekoppeld.

ResourceIdentityType

Inventarisatie

Het identiteitstype.

Waarde	Description
SystemAssigned

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Workspace

Object

De resourcecontainer voor werkruimten op het hoogste niveau.

Name	Type	Default value	Description
etag	string		De etag van de werkruimte.
id	string		Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		De identiteit van de resource.
location	string		De geografische locatie waar de resource zich bevindt
name	string		De naam van de resource
properties.createdDate	string (date-time)		Aanmaakdatum werkruimte.
properties.customerId	string		Dit is een alleen-lezen eigenschap. Vertegenwoordigt de id die aan de werkruimte is gekoppeld.
properties.defaultDataCollectionRuleResourceId	string		De resource-id van de standaardregel voor gegevensverzameling die voor deze werkruimte moet worden gebruikt. Verwachte indeling is - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		eigenschappen van werkruimtefailover.
properties.features	WorkspaceFeatures		Werkruimtefuncties.
properties.forceCmkForQuery	boolean		Geeft aan of door de klant beheerde opslag verplicht is voor querybeheer.
properties.modifiedDate	string (date-time)		Wijzigingsdatum werkruimte.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Lijst met bronnen voor het bereik van gekoppelde privékoppelingen.
properties.provisioningState	WorkspaceEntityStatus		De inrichtingsstatus van de werkruimte.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Het netwerktoegangstype voor toegang tot Log Analytics-opname.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Het netwerktoegangstype voor toegang tot Log Analytics-query.
properties.replication	WorkspaceReplicationProperties		eigenschappen van werkruimtereplicatie.
properties.retentionInDays	integer (int32)		De gegevensretentie van de werkruimte in dagen. Toegestane waarden zijn per prijsplan. Raadpleeg de documentatie over prijscategorieën voor meer informatie.
properties.sku	WorkspaceSku		De SKU van de werkruimte.
properties.workspaceCapping	WorkspaceCapping		De dagelijkse volumelimiet voor opname.
systemData	systemData		Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
tags	object		Resourcetags.
type	string		Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

WorkspaceCapping

Object

De dagelijkse volumelimiet voor opname.

Name	Type	Description
dailyQuotaGb	number (double)	Het dagelijkse quotum voor de werkruimte voor opname.
dataIngestionStatus	DataIngestionStatus	De status van gegevensopname voor deze werkruimte.
quotaNextResetTime	string	De tijd waarin het quotum rust zal zijn.

WorkspaceEntityStatus

Inventarisatie

De inrichtingsstatus van de werkruimte.

Waarde	Description
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Object

eigenschappen van werkruimtefailover.

Name	Type	Description
lastModifiedDate	string (date-time)	De laatste keer dat de failover-status is bijgewerkt.
state	WorkspaceFailoverState	De failover-status van de replicatie.

WorkspaceFailoverState

Inventarisatie

De failover-status van de replicatie.

Waarde	Description
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Object

Werkruimtefuncties.

Name	Type	Description
associations	string[]	Lijst van associaties voor de werkruimte. Geeft aan of de werkruimte is gekoppeld aan een van de volgende ervaringen: MDC, Sentinel, SentinelGraph, enzovoort.
clusterResourceId	string	Toegewezen LA-clusterresourceId die is gekoppeld aan de werkruimten.
disableLocalAuth	boolean	Schakel verificatie op basis van niet-AAD uit.
enableDataExport	boolean	Vlag die aangeeft of gegevens moeten worden geëxporteerd.
enableLogAccessUsingOnlyResourcePermissions	boolean	Vlag die aangeeft welke machtiging moet worden gebruikt: resource of werkruimte of beide.
immediatePurgeDataOn30Days	boolean	Vlag die beschrijft of we de gegevens na 30 dagen willen verwijderen.
unifiedSentinelBillingOnly	boolean	Een indicatie of de opgegeven werkruimte is beperkt tot alleen het uniforme factureringsmodel van Sentinel.

WorkspaceReplicationProperties

Object

eigenschappen van werkruimtereplicatie.

Name	Type	Description
createdDate	string (date-time)	De laatste keer dat de replicatie was ingeschakeld.
enabled	boolean	Hiermee geeft u op of de replicatie is ingeschakeld of niet. Wanneer waar worden werkruimteconfiguratie en -gegevens gerepliceerd naar de opgegeven locatie. Als replicatie is ingeschakeld, moet de locatie worden opgegeven.
lastModifiedDate	string (date-time)	De laatste keer dat de replicatie is bijgewerkt.
location	string	De locatie van de replicatie.
provisioningState	WorkspaceReplicationState	De inrichtingsstatus van de replicatie.

WorkspaceReplicationState

Inventarisatie

De inrichtingsstatus van de replicatie.

Waarde	Description
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Object

De SKU van de werkruimte.

Name	Type	Description
capacityReservationLevel	integer (int32)	Het capaciteitsreserveringsniveau in GB voor deze werkruimte wanneer CapacityReservation-sku is geselecteerd.
lastSkuUpdate	string (date-time)	De laatste keer dat de sku is bijgewerkt.
name	WorkspaceSkuNameEnum	De naam van de SKU.

WorkspaceSkuNameEnum

Inventarisatie

De naam van de SKU.

Waarde	Description
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

Delen via

Workspaces - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

WorkspacesCreate

Voorbeeldaanvraag

Voorbeeldrespons

Definities

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum