Workspaces - Create Or Update

Riferimento

Servizio:: Log Analytics

Versione API:: 2025-02-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-02-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome non fa distinzione tra 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	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
etag		string	Etag dell'area di lavoro.
identity		Identity	Identità della risorsa.
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.publicNetworkAccessForIngestion		PublicNetworkAccessType	Tipo di accesso alla rete per l'accesso all'inserimento di Log Analytics.
properties.publicNetworkAccessForQuery		PublicNetworkAccessType	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 in giorni. I valori consentiti sono per 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.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	Workspace	Definizione di risposta OK.
201 Created	Workspace	Definizione della 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-02-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
CapacityReservationLevel	Livello di prenotazione della capacità in GB per questa area di lavoro, quando è selezionato lo SKU CapacityReservation.
createdByType	Tipo di identità che ha creato la risorsa.
DataIngestionStatus	Stato dell'inserimento 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.
IdentityType	Tipo di identità del servizio gestito.
PrivateLinkScopedResource	Riferimento alla risorsa dell'ambito del collegamento privato.
PublicNetworkAccessType	Tipo di accesso alla rete per il funzionamento nell'area di lavoro Log Analytics. Per impostazione predefinita, è Abilitato
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserIdentityProperties	Proprietà di identità assegnate dall'utente.
Workspace	Contenitore di risorse dell'area di lavoro di primo livello.
WorkspaceCapping	Limite di volume giornaliero per l'inserimento.
WorkspaceEntityStatus	Stato di provisioning dell'area di lavoro.
WorkspaceFailoverProperties	Stato di failover della replica.
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 (livello) di un'area di lavoro.
WorkspaceSkuNameEnum	Nome dello SKU.

CapacityReservationLevel

Enumerazione

Livello di prenotazione della capacità in GB per questa area di lavoro, quando è selezionato lo SKU CapacityReservation.

Valore	Descrizione
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

DataIngestionStatus

Enumerazione

Stato dell'inserimento dati per questa area di lavoro.

Valore	Descrizione
ApproachingQuota	80% di quota limite giornaliera raggiunta.
ForceOff	L'inserimento è stato arrestato dopo la modifica dell'impostazione del servizio.
ForceOn	Inserimento avviato dopo la modifica dell'impostazione del servizio.
OverQuota	È stata raggiunta la quota limite giornaliera, l'inserimento è stato arrestato.
RespectQuota	Inserimento abilitato dopo la reimpostazione giornaliera della quota limite o l'abilitazione della sottoscrizione.
SubscriptionSuspended	L'inserimento è stato arrestato dopo la sottoscrizione sospesa.

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	ID principale dell'identità della risorsa.
tenantId	string	ID tenant della risorsa.
type	IdentityType	Tipo di identità del servizio gestito.
userAssignedIdentities	<string, UserIdentityProperties>	Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel formato :'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumerazione

Tipo di identità del servizio gestito.

Valore	Descrizione
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Object

Riferimento alla risorsa dell'ambito del collegamento privato.

Nome	Tipo	Descrizione
resourceId	string	ID della risorsa completa dell'ambito del collegamento privato.
scopeId	string	Identificatore univoco dell'ambito del collegamento privato.

PublicNetworkAccessType

Enumerazione

Tipo di accesso alla rete per il funzionamento nell'area di lavoro Log Analytics. Per impostazione predefinita, è Abilitato

Valore	Descrizione
Disabled	Disabilita la connettività pubblica a Log Analytics tramite DNS pubblico.
Enabled	Consente la connettività a Log Analytics tramite DNS pubblico.

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.

UserIdentityProperties

Object

Proprietà di identità assegnate dall'utente.

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata dall'utente.
principalId	string	ID principale dell'identità assegnata dall'utente.

Workspace

Object

Contenitore di risorse dell'area di lavoro di primo livello.

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 del collegamento privato collegato.
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 in giorni. I valori consentiti sono per 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 della 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 dati per questa area di lavoro.
quotaNextResetTime	string	Ora di riposo della quota.

WorkspaceEntityStatus

Enumerazione

Stato di provisioning dell'area di lavoro.

Valore	Descrizione
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Object

Stato di failover della replica.

Nome	Tipo	Descrizione
lastModifiedDate	string (date-time)	Ora dell'ultimo aggiornamento dello stato di failover.
state	WorkspaceFailoverState	Stato di failover della replica.

WorkspaceFailoverState

Enumerazione

Stato di failover della replica.

Valore	Descrizione
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Object

Funzionalità dell'area di lavoro.

Nome	Tipo	Descrizione
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)	Ora dell'ultima abilitazione della replica.
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)	Ora dell'ultimo aggiornamento della replica.
location	string	Posizione della replica.
provisioningState	WorkspaceReplicationState	Stato di provisioning della replica.

WorkspaceReplicationState

Enumerazione

Stato di provisioning della replica.

Valore	Descrizione
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Object

SKU (livello) di un'area di lavoro.

Nome	Tipo	Descrizione
capacityReservationLevel	CapacityReservationLevel (int32)	Livello di prenotazione della capacità in GB per questa area di lavoro, quando è selezionato lo SKU CapacityReservation.
lastSkuUpdate	string (date-time)	Ora dell'ultimo aggiornamento dello SKU.
name	WorkspaceSkuNameEnum	Nome dello SKU.

WorkspaceSkuNameEnum

Enumerazione

Nome dello SKU.

Valore	Descrizione
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

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

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Risorse aggiuntive