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

Namn	I	Krävs	Typ	Beskrivning
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.

Brödtext för begäran

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

Svaren

Namn	Typ	Beskrivning
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
Rinna: implicit
URL för auktorisering: https://login.microsoftonline.com/common/oauth2/authorize

Scope

Namn	Beskrivning
user_impersonation	personifiera ditt användarkonto

Exempel

WorkspacesCreate

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.loganalytics import LogAnalyticsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-loganalytics
# USAGE
    python workspaces_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = LogAnalyticsManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-00000000000",
    )

    response = client.workspaces.begin_create_or_update(
        resource_group_name="oiautorest6685",
        workspace_name="oiautorest6685",
        parameters={
            "location": "australiasoutheast",
            "properties": {"retentionInDays": 30, "sku": {"name": "PerGB2018"}},
            "tags": {"tag1": "val1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesCreate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Exempel på svar

Status kod:: 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"
  }
}

Status kod:: 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"
  }
}

Status kod:: 202

Definitioner

Namn	Beskrivning
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	Beskrivning
User
Application
ManagedIdentity
Key

DataIngestionStatus

Uppräkning

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

Värde	Beskrivning
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.

Namn	Typ	Beskrivning
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

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

ErrorResponse

Objekt

Felsvar

Namn	Typ	Beskrivning
error	ErrorDetail	Felobjektet.

Identity

Objekt

Identitet för resursen.

Namn	Typ	Beskrivning
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.

Namn	Typ	Beskrivning
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	Beskrivning
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	Beskrivning
SystemAssigned

systemData

Objekt

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

Namn	Typ	Beskrivning
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.

Namn	Typ	Standardvärde	Beskrivning
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.

Namn	Typ	Beskrivning
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	Beskrivning
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Objekt

redundansegenskaper för arbetsytan.

Namn	Typ	Beskrivning
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	Beskrivning
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Objekt

Arbetsytefunktioner.

Namn	Typ	Beskrivning
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.

Namn	Typ	Beskrivning
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	Beskrivning
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Objekt

Arbetsytans SKU.

Namn	Typ	Beskrivning
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	Beskrivning
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

Dela via

Workspaces - Create Or Update

URI-parametrar

Brödtext för begäran

Svaren

Säkerhet

azure_auth

Scope

Exempel

WorkspacesCreate

Exempel på begäran

Exempel på svar

Definitioner

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum