Workspaces - Create Or Update

Servizio:: Log Analytics

Versione API:: 2025-07-01

Creare o aggiornare un'area di lavoro.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nome dell'area di lavoro.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
parameters	Workspace	Parametri necessari per creare o aggiornare un'area di lavoro.

Risposte

Nome	Tipo	Descrizione
200 OK	Workspace	Definizione della risposta OK.
201 Created	Workspace	Definizione di risposta creata.
202 Accepted		Accettato
Other Status Codes	ErrorResponse	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

WorkspacesCreate

Esempio di richiesta

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

Risposta di esempio

Codice di stato:: 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"
  }
}

Codice di stato:: 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"
  }
}

Codice di stato:: 202

Definizioni

Nome	Descrizione
createdByType	Tipo di identità che ha creato la risorsa.
DataIngestionStatus	Stato dell'inserimento dei dati per questa area di lavoro.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
Identity	Identità per la risorsa.
PrivateLinkScopedResource	Elenco delle risorse dell'ambito dei collegamenti privati collegati.
PublicNetworkAccessType	Tipo di accesso alla rete per l'accesso all'inserimento di Log Analytics.
ResourceIdentityType	Tipo di identità.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
Workspace	Contenitore di risorse Workspace di livello superiore.
WorkspaceCapping	Limite di volume giornaliero per l'inserimento.
WorkspaceEntityStatus	Stato di provisioning dell'area di lavoro.
WorkspaceFailoverProperties	proprietà di failover dell'area di lavoro.
WorkspaceFailoverState	Stato di failover della replica.
WorkspaceFeatures	Funzionalità dell'area di lavoro.
WorkspaceReplicationProperties	proprietà di replica dell'area di lavoro.
WorkspaceReplicationState	Stato di provisioning della replica.
WorkspaceSku	SKU dell'area di lavoro.
WorkspaceSkuNameEnum	Nome dello SKU.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DataIngestionStatus

Enumerazione

Stato dell'inserimento dei dati per questa area di lavoro.

Valore	Descrizione
RespectQuota	Inserimento abilitato dopo la reimpostazione della quota limite giornaliera o l'abilitazione della sottoscrizione.
ForceOn	L'inserimento è iniziato dopo la modifica delle impostazioni del servizio.
ForceOff	L'inserimento è stato interrotto in seguito alla modifica delle impostazioni del servizio.
OverQuota	Raggiunta la quota massima giornaliera, l'ingestione è stata interrotta.
SubscriptionSuspended	L'inserimento è stato interrotto dopo la sospensione dell'abbonamento.
ApproachingQuota	Raggiunto l'80% della quota massima giornaliera.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

Identity

Object

Identità per la risorsa.

Nome	Tipo	Descrizione
principalId	string (uuid)	ID principale dell'identità della risorsa. Il valore deve essere un UUID.
tenantId	string (uuid)	ID tenant della risorsa. Il valore deve essere un UUID.
type	ResourceIdentityType	Tipo di identità.

PrivateLinkScopedResource

Object

Elenco delle risorse dell'ambito dei collegamenti privati collegati.

Nome	Tipo	Descrizione
resourceId	string	ID completo della risorsa dell'ambito del collegamento privato.
scopeId	string	L'identificatore univoco dell'ambito del collegamento privato.

PublicNetworkAccessType

Enumerazione

Tipo di accesso alla rete per l'accesso all'inserimento di Log Analytics.

Valore	Descrizione
Enabled	Abilita la connettività a Log Analytics tramite DNS pubblico.
Disabled	Disabilita la connettività pubblica a Log Analytics tramite DNS pubblico.
SecuredByPerimeter	La risorsa è accessibile solo da reti private e l'accesso è approvato dal perimetro di sicurezza della rete associato a questa risorsa.

ResourceIdentityType

Enumerazione

Tipo di identità.

Valore	Descrizione
SystemAssigned

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Workspace

Object

Contenitore di risorse Workspace di livello superiore.

Nome	Tipo	Valore predefinito	Descrizione
etag	string		Etag dell'area di lavoro.
id	string		ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identità della risorsa.
location	string		Posizione geografica in cui risiede la risorsa
name	string		Nome della risorsa
properties.createdDate	string (date-time)		Data di creazione dell'area di lavoro.
properties.customerId	string		Si tratta di una proprietà di sola lettura. Rappresenta l'ID associato all'area di lavoro.
properties.defaultDataCollectionRuleResourceId	string		ID risorsa della regola di raccolta dati predefinita da usare per questa area di lavoro. Il formato previsto è : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		proprietà di failover dell'area di lavoro.
properties.features	WorkspaceFeatures		Funzionalità dell'area di lavoro.
properties.forceCmkForQuery	boolean		Indica se l'archiviazione gestita dal cliente è obbligatoria per la gestione delle query.
properties.modifiedDate	string (date-time)		Data di modifica dell'area di lavoro.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Elenco delle risorse dell'ambito dei collegamenti privati collegati.
properties.provisioningState	WorkspaceEntityStatus		Stato di provisioning dell'area di lavoro.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Tipo di accesso alla rete per l'accesso all'inserimento di Log Analytics.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Tipo di accesso alla rete per l'accesso alla query di Log Analytics.
properties.replication	WorkspaceReplicationProperties		proprietà di replica dell'area di lavoro.
properties.retentionInDays	integer (int32)		Conservazione dei dati dell'area di lavoro indicata in giorni. I valori consentiti dipendono dal piano tariffario. Per informazioni dettagliate, vedere la documentazione sui piani tariffari.
properties.sku	WorkspaceSku		SKU dell'area di lavoro.
properties.workspaceCapping	WorkspaceCapping		Limite di volume giornaliero per l'inserimento.
systemData	systemData		Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags	object		Tag di risorsa.
type	string		Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Object

Limite di volume giornaliero per l'inserimento.

Nome	Tipo	Descrizione
dailyQuotaGb	number (double)	Quota giornaliera dell'area di lavoro per l'inserimento.
dataIngestionStatus	DataIngestionStatus	Stato dell'inserimento dei dati per questa area di lavoro.
quotaNextResetTime	string	Il momento in cui la quota sarà di riposo.

WorkspaceEntityStatus

Enumerazione

Stato di provisioning dell'area di lavoro.

Valore	Descrizione
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Object

proprietà di failover dell'area di lavoro.

Nome	Tipo	Descrizione
lastModifiedDate	string (date-time)	L'ultima volta che lo stato di failover è stato aggiornato.
state	WorkspaceFailoverState	Stato di failover della replica.

WorkspaceFailoverState

Enumerazione

Stato di failover della replica.

Valore	Descrizione
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Object

Funzionalità dell'area di lavoro.

Nome	Tipo	Descrizione
associations	string[]	Elenco delle associazioni per l'area di lavoro. Indica se l'area di lavoro è associata a una delle esperienze seguenti: MDC, Sentinel, SentinelGraph e così via.
clusterResourceId	string	ResourceId cluster LA dedicato collegato alle aree di lavoro.
disableLocalAuth	boolean	Disabilitare l'autenticazione non basata su AAD.
enableDataExport	boolean	Flag che indica se i dati devono essere esportati.
enableLogAccessUsingOnlyResourcePermissions	boolean	Flag che indica l'autorizzazione da usare, ovvero la risorsa o l'area di lavoro o entrambi.
immediatePurgeDataOn30Days	boolean	Flag che descrive se si vogliono rimuovere i dati dopo 30 giorni.
unifiedSentinelBillingOnly	boolean	Indicazione se l'area di lavoro specificata è limitata solo al modello di fatturazione unificato di Sentinel.

WorkspaceReplicationProperties

Object

proprietà di replica dell'area di lavoro.

Nome	Tipo	Descrizione
createdDate	string (date-time)	L'ultima volta in cui la replica è stata abilitata.
enabled	boolean	Specifica se la replica è abilitata o meno. Se true, la configurazione e i dati dell'area di lavoro vengono replicati nel percorso specificato. Se la replica è stata abilitata, è necessario specificare il percorso.
lastModifiedDate	string (date-time)	L'ultima volta in cui la replica è stata aggiornata.
location	string	Posizione della replica.
provisioningState	WorkspaceReplicationState	Stato di provisioning della replica.

WorkspaceReplicationState

Enumerazione

Stato di provisioning della replica.

Valore	Descrizione
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Object

SKU dell'area di lavoro.

Nome	Tipo	Descrizione
capacityReservationLevel	integer (int32)	Livello di prenotazione della capacità in GB per questa area di lavoro, quando è selezionato lo SKU CapacityReservation.
lastSkuUpdate	string (date-time)	L'ultima volta che lo SKU è stato aggiornato.
name	WorkspaceSkuNameEnum	Nome dello SKU.

WorkspaceSkuNameEnum

Enumerazione

Nome dello SKU.

Valore	Descrizione
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

Condividi tramite

Workspaces - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

WorkspacesCreate

Esempio di richiesta

Risposta di esempio

Definizioni

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum