Workspaces - Create Or Update

Referens

Tjänst:: Log Analytics

API-version:: 2025-02-01

Skapa eller uppdatera en arbetsyta.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-02-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	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
etag		string	Etag för arbetsytan.
identity		Identity	Resursens identitet.
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.publicNetworkAccessForIngestion		PublicNetworkAccessType	Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning.
properties.publicNetworkAccessForQuery		PublicNetworkAccessType	Nätverksåtkomsttypen för åtkomst till Log Analytics-frågan.
properties.replication		WorkspaceReplicationProperties	replikeringsegenskaper för arbetsytan.
properties.retentionInDays		integer (int32)	Datakvarhållning för arbetsytan i dagar. 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.
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	Workspace	OK svarsdefinition.
201 Created	Workspace	Svarsdefinition har skapats.
202 Accepted		Accepterad
Other Status Codes	ErrorResponse	Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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-02-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
CapacityReservationLevel	Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs.
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.
IdentityType	Typ av hanterad tjänstidentitet.
PrivateLinkScopedResource	Resursreferensen för private link-omfånget.
PublicNetworkAccessType	Nätverksåtkomsttypen för att fungera på Log Analytics-arbetsytan. Som standard är den aktiverad
systemData	Metadata som rör skapande och senaste ändring av resursen.
UserIdentityProperties	Användartilldelade identitetsegenskaper.
Workspace	Resurscontainern för arbetsytan på den översta nivån.
WorkspaceCapping	Det dagliga volymtaket för inmatning.
WorkspaceEntityStatus	Etableringstillståndet för arbetsytan.
WorkspaceFailoverProperties	Replikeringens redundanstillstånd.
WorkspaceFailoverState	Replikeringens redundanstillstånd.
WorkspaceFeatures	Arbetsytefunktioner.
WorkspaceReplicationProperties	Replikeringsegenskaper för arbetsyta.
WorkspaceReplicationState	Replikeringens etableringstillstånd.
WorkspaceSku	SKU:n (nivån) för en arbetsyta.
WorkspaceSkuNameEnum	Namnet på SKU:n.

CapacityReservationLevel

Uppräkning

Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs.

Värde	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Uppräkning

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

Värde	Description
ApproachingQuota	80% av den dagliga kvot som uppnåtts.
ForceOff	Inmatningen stoppades efter ändring av tjänstinställningen.
ForceOn	Inmatningen började efter ändring av tjänstinställningen.
OverQuota	Den dagliga gränskvoten har nåtts och inmatningen har stoppats.
RespectQuota	Inmatning aktiverad efter daglig cap-kvotåterställning eller prenumerationsaktivering.
SubscriptionSuspended	Inmatningen stoppades efter en pausad prenumeration.

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	Huvud-ID för resursidentitet.
tenantId	string	Resursens klientorganisations-ID.
type	IdentityType	Typ av hanterad tjänstidentitet.
userAssignedIdentities	<string, UserIdentityProperties>	Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Uppräkning

Typ av hanterad tjänstidentitet.

Värde	Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Objekt

Resursreferensen för private link-omfånget.

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

PublicNetworkAccessType

Uppräkning

Nätverksåtkomsttypen för att fungera på Log Analytics-arbetsytan. Som standard är den aktiverad

Värde	Description
Disabled	Inaktiverar offentlig anslutning till Log Analytics via offentlig DNS.
Enabled	Aktiverar anslutning till Log Analytics via offentlig DNS.

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.

UserIdentityProperties

Objekt

Användartilldelade identitetsegenskaper.

Name	Typ	Description
clientId	string	Klient-ID för användartilldelad identitet.
principalId	string	Huvud-ID för användartilldelad identitet.

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)		Skapandedatum för arbetsyta.
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 privat länkomfång.
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)		Datakvarhållning för arbetsytan i dagar. 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		Resurstaggar.
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	Tiden då kvoten kommer att vila.

WorkspaceEntityStatus

Uppräkning

Etableringstillståndet för arbetsytan.

Värde	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Objekt

Replikeringens redundanstillstånd.

Name	Typ	Description
lastModifiedDate	string (date-time)	Senaste gången redundanstillståndet uppdaterades.
state	WorkspaceFailoverState	Replikeringens redundanstillstånd.

WorkspaceFailoverState

Uppräkning

Replikeringens redundanstillstånd.

Värde	Description
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Objekt

Arbetsytefunktioner.

Name	Typ	Description
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 angiven arbetsytan endast är begränsad till sentinels enhetliga faktureringsmodell.

WorkspaceReplicationProperties

Objekt

Replikeringsegenskaper för arbetsyta.

Name	Typ	Description
createdDate	string (date-time)	Senaste gången 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)	Senaste gången replikeringen uppdaterades.
location	string	Platsen för replikeringen.
provisioningState	WorkspaceReplicationState	Replikeringens etableringstillstånd.

WorkspaceReplicationState

Uppräkning

Replikeringens etableringstillstånd.

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

WorkspaceSku

Objekt

SKU:n (nivån) för en arbetsyta.

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

WorkspaceSkuNameEnum

Uppräkning

Namnet på SKU:n.

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

Dela via

Workspaces - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

WorkspacesCreate

Exempelbegäran

Exempelsvar

Definitioner

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Ytterligare resurser