Workspaces - List

Servizio:: Log Analytics

Versione API:: 2025-07-01

Ottiene le aree di lavoro in una sottoscrizione.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	WorkspaceListResult	L'operazione di Azure è stata completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

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

WorkspacesSubscriptionList

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.OperationalInsights/workspaces?api-version=2025-07-01

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "name": "AzTest2170",
      "type": "Microsoft.OperationalInsights/workspaces",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
      "location": "australiasoutheast",
      "properties": {
        "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
        "provisioningState": "Succeeded",
        "publicNetworkAccessForIngestion": "Enabled",
        "publicNetworkAccessForQuery": "Enabled",
        "retentionInDays": 30,
        "sku": {
          "name": "PerGB2018"
        }
      },
      "tags": {
        "tag1": "val1"
      }
    }
  ]
}

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.
IdentityType	Tipo di identità del servizio gestito.
PrivateLinkScopedResource	Riferimento alla risorsa dell'ambito del collegamento privato.
PublicNetworkAccessType	Tipo di accesso alla rete per l'accesso all'inserimento di Log Analytics.
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.
WorkspaceListResult	La risposta dell'operazione list workspaces.
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.

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

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

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

ErrorDetail

Oggetto

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

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

Identity

Oggetto

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
SystemAssigned	Assegnato dal sistema
UserAssigned	UserAssigned
None	None

PrivateLinkScopedResource

Oggetto

Riferimento alla risorsa dell'ambito del collegamento privato.

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.

systemData

Oggetto

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

Oggetto

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

Oggetto

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

Nome	Tipo	Valore predefinito	Descrizione
etag	string		Etag dell'area di lavoro.
id	string (arm-id)		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 di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object		Tag di risorsa.
type	string		Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Oggetto

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	Creazione
Succeeded	Succeeded
Failed	Non riuscito
Canceled	Annullato
Deleting	Deleting
ProvisioningAccount	ProvisioningAccount
Updating	Aggiornamento

WorkspaceFailoverProperties

Oggetto

Stato di failover della replica.

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	Non attiva
Activating	Attivatore
Active	Attivo
Deactivating	In fase di disattivazione
Failed	Non riuscito

WorkspaceFeatures

Oggetto

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.

WorkspaceListResult

Oggetto

La risposta dell'operazione list workspaces.

Nome	Tipo	Descrizione
nextLink	string	L'URL per ottenere il set di risultati successivo.
value	Workspace[]	Elenco di aree di lavoro.

WorkspaceReplicationProperties

Oggetto

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	Succeeded
EnableRequested	EnableRequested
Enabling	Abilitazione
DisableRequested	DisabilitaRichiesto
Disabling	Disattivazione
RollbackRequested	Ripetizione Riposta
RollingBack	RollingBack
Failed	Non riuscito
Canceled	Annullato

WorkspaceSku

Oggetto

SKU (livello) di un'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	Free
Standard	Standard
Premium	Premium
PerNode	PerNode
PerGB2018	PerGB2018
Standalone	Autonomo
CapacityReservation	CapacityReservation
LACluster	LACluster