Workspaces - Create Or Update

Tjänst:: Log Analytics

API-version:: 2025-07-01

Skapa eller uppdatera en arbetsyta.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Namnet på arbetsytan.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
parameters	Workspace	De parametrar som krävs för att skapa eller uppdatera en arbetsyta.

Svar

Name	Typ	Description
200 OK	Workspace	Definition av OK-svar.
201 Created	Workspace	Skapad svarsdefinition.
202 Accepted		Accepted
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

WorkspacesCreate

Exempelbegäran

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

Exempelsvar

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

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

Statuskod:: 202

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
DataIngestionStatus	Status för datainmatning för den här arbetsytan.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
Identity	Identitet för resursen.
PrivateLinkScopedResource	Lista över resurser för länkat omfång för privata länkar.
PublicNetworkAccessType	Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning.
ResourceIdentityType	Identitetstypen.
systemData	Metadata som rör skapande och senaste ändring av resursen.
Workspace	Resurscontainern för arbetsytan på den översta nivån.
WorkspaceCapping	Det dagliga volymtaket för inmatning.
WorkspaceEntityStatus	Etableringstillståndet för arbetsytan.
WorkspaceFailoverProperties	redundansegenskaper för arbetsytan.
WorkspaceFailoverState	Redundanstillståndet för replikeringen.
WorkspaceFeatures	Arbetsytefunktioner.
WorkspaceReplicationProperties	replikeringsegenskaper för arbetsytan.
WorkspaceReplicationState	Etableringstillståndet för replikeringen.
WorkspaceSku	Arbetsytans SKU.
WorkspaceSkuNameEnum	Namnet på SKU:n.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DataIngestionStatus

Uppräkning

Status för datainmatning för den här arbetsytan.

Värde	Description
RespectQuota	Inmatning aktiverad efter återställning av daglig takkvot eller prenumerationsaktivering.
ForceOn	Inmatningen startade efter att tjänstinställningarna ändrades.
ForceOff	Inmatningen stoppades efter ändring av tjänstinställningen.
OverQuota	Kvoten för dagligt tak har nåtts, inmatningen stoppades.
SubscriptionSuspended	Inmatningen stoppades efter den inaktiverade prenumerationen.
ApproachingQuota	80% av den dagliga takkvoten har uppnåtts.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

Identity

Objekt

Identitet för resursen.

Name	Typ	Description
principalId	string (uuid)	Huvud-ID för resursidentitet. Värdet måste vara ett UUID.
tenantId	string (uuid)	Resursens klientorganisations-ID. Värdet måste vara ett UUID.
type	ResourceIdentityType	Identitetstypen.

PrivateLinkScopedResource

Objekt

Lista över resurser för länkat omfång för privata länkar.

Name	Typ	Description
resourceId	string	Det fullständiga resurs-ID:t för resursen för den privata länkomfånget.
scopeId	string	Den unika identifieraren för omfånget för den privata länken.

PublicNetworkAccessType

Uppräkning

Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning.

Värde	Description
Enabled	Möjliggör anslutning till Log Analytics via offentlig DNS.
Disabled	Inaktiverar offentlig anslutning till Log Analytics via offentlig DNS.
SecuredByPerimeter	Resursen är endast tillgänglig från privata nätverk och åtkomst som godkänts av nätverkssäkerhetsperimetern som är associerad med den här resursen.

ResourceIdentityType

Uppräkning

Identitetstypen.

Värde	Description
SystemAssigned

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Workspace

Objekt

Resurscontainern för arbetsytan på den översta nivån.

Name	Typ	Standardvärde	Description
etag	string		Etag för arbetsytan.
id	string		Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Resursens identitet.
location	string		Den geo-plats där resursen finns
name	string		Namnet på resursen
properties.createdDate	string (date-time)		Datum då arbetsytan skapades.
properties.customerId	string		Det här är en skrivskyddad egenskap. Representerar det ID som är associerat med arbetsytan.
properties.defaultDataCollectionRuleResourceId	string		Resurs-ID för standardregeln för datainsamling som ska användas för den här arbetsytan. Förväntat format är – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		redundansegenskaper för arbetsytan.
properties.features	WorkspaceFeatures		Arbetsytefunktioner.
properties.forceCmkForQuery	boolean		Anger om kundhanterad lagring är obligatorisk för frågehantering.
properties.modifiedDate	string (date-time)		Ändringsdatum för arbetsyta.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Lista över resurser för länkat omfång för privata länkar.
properties.provisioningState	WorkspaceEntityStatus		Etableringstillståndet för arbetsytan.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Nätverksåtkomsttypen för åtkomst till Log Analytics-frågan.
properties.replication	WorkspaceReplicationProperties		replikeringsegenskaper för arbetsytan.
properties.retentionInDays	integer (int32)		Antal dagar för lagring av data på arbetsytan. Tillåtna värden är per prisplan. Mer information finns i dokumentationen om prisnivåer.
properties.sku	WorkspaceSku		Arbetsytans SKU.
properties.workspaceCapping	WorkspaceCapping		Det dagliga volymtaket för inmatning.
systemData	systemData		Metadata som rör skapande och senaste ändring av resursen.
tags	object		Resursetiketter.
type	string		Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Objekt

Det dagliga volymtaket för inmatning.

Name	Typ	Description
dailyQuotaGb	number (double)	Den dagliga arbetsytans kvot för inmatning.
dataIngestionStatus	DataIngestionStatus	Status för datainmatning för den här arbetsytan.
quotaNextResetTime	string	Den tid då kvoten ska vara vila.

WorkspaceEntityStatus

Uppräkning

Etableringstillståndet för arbetsytan.

Värde	Description
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Objekt

redundansegenskaper för arbetsytan.

Name	Typ	Description
lastModifiedDate	string (date-time)	Den senaste gången som redundanstillståndet uppdaterades.
state	WorkspaceFailoverState	Redundanstillståndet för replikeringen.

WorkspaceFailoverState

Uppräkning

Redundanstillståndet för replikeringen.

Värde	Description
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Objekt

Arbetsytefunktioner.

Name	Typ	Description
associations	string[]	Lista över associationer för arbetsytan. Anger om arbetsytan är associerad med någon av följande upplevelser: MDC, Sentinel, SentinelGraph osv.
clusterResourceId	string	Dedikerad LA-klusterresursId som är länkat till arbetsytorna.
disableLocalAuth	boolean	Inaktivera icke-AAD-baserad autentisering.
enableDataExport	boolean	Flagga som anger om data ska exporteras.
enableLogAccessUsingOnlyResourcePermissions	boolean	Flagga som anger vilken behörighet som ska användas – resurs eller arbetsyta eller både och.
immediatePurgeDataOn30Days	boolean	Flagga som beskriver om vi vill ta bort data efter 30 dagar.
unifiedSentinelBillingOnly	boolean	En indikation om den angivna arbetsytan endast är begränsad till sentinels enhetliga faktureringsmodell.

WorkspaceReplicationProperties

Objekt

replikeringsegenskaper för arbetsytan.

Name	Typ	Description
createdDate	string (date-time)	Senaste gången som replikeringen aktiverades.
enabled	boolean	Anger om replikeringen är aktiverad eller inte. När det är sant replikeras konfiguration och data för arbetsytan till den angivna platsen. Om replikering har aktiverats måste platsen anges.
lastModifiedDate	string (date-time)	Den senaste gången replikeringen uppdaterades.
location	string	Platsen för replikeringen.
provisioningState	WorkspaceReplicationState	Etableringstillståndet för replikeringen.

WorkspaceReplicationState

Uppräkning

Etableringstillståndet för replikeringen.

Värde	Description
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Objekt

Arbetsytans SKU.

Name	Typ	Description
capacityReservationLevel	integer (int32)	Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs.
lastSkuUpdate	string (date-time)	Senaste gången SKU:n uppdaterades.
name	WorkspaceSkuNameEnum	Namnet på SKU:n.

WorkspaceSkuNameEnum

Uppräkning

Namnet på SKU:n.

Värde	Description
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

Dela via

Workspaces - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

WorkspacesCreate

Exempelbegäran

Exempelsvar

Definitioner

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum