Workspaces - Get

Service:: Log Analytics

Version d'API:: 2025-07-01

Obtient une instance d’espace de travail.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string minLength: 1	ID de l’abonnement cible.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nom de l’espace de travail.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	Workspace	Définition de la réponse OK.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

WorkspaceGet

Exemple de requête

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


/**
 * Samples for Workspaces GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-
     * 07-01/examples/WorkspacesGet.json
     */
    /**
     * Sample code: WorkspaceGet.
     * 
     * @param manager Entry point to LogAnalyticsManager.
     */
    public static void workspaceGet(com.azure.resourcemanager.loganalytics.LogAnalyticsManager manager) {
        manager.workspaces().getByResourceGroupWithResponse("oiautorest6685", "oiautorest6685",
            com.azure.core.util.Context.NONE);
    }
}

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

from azure.identity import DefaultAzureCredential

from azure.mgmt.loganalytics import LogAnalyticsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-loganalytics
# USAGE
    python workspaces_get.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.get(
        resource_group_name="oiautorest6685",
        workspace_name="oiautorest6685",
    )
    print(response)


# x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesGet.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

package armoperationalinsights_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/operationalinsights/armoperationalinsights/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/53d56e4ec74156c450d1e51745a971d3f2031dd7/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesGet.json
func ExampleWorkspacesClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armoperationalinsights.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewWorkspacesClient().Get(ctx, "oiautorest6685", "oiautorest6685", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Workspace = armoperationalinsights.Workspace{
	// 	Name: to.Ptr("oiautorest6685"),
	// 	Type: to.Ptr("Microsoft.OperationalInsights/workspaces"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/oiautorest6685"),
	// 	Location: to.Ptr("eastus"),
	// 	Properties: &armoperationalinsights.WorkspaceProperties{
	// 		CustomerID: to.Ptr("5b02755b-5bf4-430c-9487-45502a2a7e62"),
	// 		Failover: &armoperationalinsights.WorkspaceFailoverProperties{
	// 			LastModifiedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-07-05T07:35:51.000Z"); return t}()),
	// 			State: to.Ptr(armoperationalinsights.WorkspaceFailoverStateActive),
	// 		},
	// 		ProvisioningState: to.Ptr(armoperationalinsights.WorkspaceEntityStatusSucceeded),
	// 		PublicNetworkAccessForIngestion: to.Ptr(armoperationalinsights.PublicNetworkAccessTypeEnabled),
	// 		PublicNetworkAccessForQuery: to.Ptr(armoperationalinsights.PublicNetworkAccessTypeEnabled),
	// 		Replication: &armoperationalinsights.WorkspaceReplicationProperties{
	// 			CreatedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-07-04T07:35:51.000Z"); return t}()),
	// 			Enabled: to.Ptr(true),
	// 			LastModifiedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-07-04T07:35:51.000Z"); return t}()),
	// 			Location: to.Ptr("westus3"),
	// 			ProvisioningState: to.Ptr(armoperationalinsights.WorkspaceReplicationStateSucceeded),
	// 		},
	// 		RetentionInDays: to.Ptr[int32](30),
	// 		SKU: &armoperationalinsights.WorkspaceSKU{
	// 			Name: to.Ptr(armoperationalinsights.WorkspaceSKUNameEnumPerGB2018),
	// 		},
	// 	},
	// }
}

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

const { OperationalInsightsManagementClient } = require("@azure/arm-operationalinsights");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets a workspace instance.
 *
 * @summary Gets a workspace instance.
 * x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesGet.json
 */
async function workspaceGet() {
  const subscriptionId =
    process.env["OPERATIONALINSIGHTS_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-00000000000";
  const resourceGroupName = process.env["OPERATIONALINSIGHTS_RESOURCE_GROUP"] || "oiautorest6685";
  const workspaceName = "oiautorest6685";
  const credential = new DefaultAzureCredential();
  const client = new OperationalInsightsManagementClient(credential, subscriptionId);
  const result = await client.workspaces.get(resourceGroupName, workspaceName);
  console.log(result);
}

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

Exemple de réponse

Code d’état:: 200

{
  "properties": {
    "customerId": "5b02755b-5bf4-430c-9487-45502a2a7e62",
    "provisioningState": "Succeeded",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled",
    "replication": {
      "location": "westus3",
      "enabled": true,
      "provisioningState": "Succeeded",
      "createdDate": "2020-07-04T07:35:51Z",
      "lastModifiedDate": "2020-07-04T07:35:51Z"
    },
    "failover": {
      "state": "Active",
      "lastModifiedDate": "2020-07-05T07:35:51Z"
    }
  },
  "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/oiautorest6685",
  "name": "oiautorest6685",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "eastus"
}

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
DataIngestionStatus	L’état de l’ingestion des données pour cet espace de travail.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
Identity	Identité de la ressource.
PrivateLinkScopedResource	Liste des ressources de portée de lien privé lié.
PublicNetworkAccessType	Type d’accès réseau pour accéder à l’ingestion Log Analytics.
ResourceIdentityType	Type d’identité.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
Workspace	Conteneur de ressources Workspace de niveau supérieur.
WorkspaceCapping	Limite de volume quotidienne pour l’ingestion.
WorkspaceEntityStatus	État d’approvisionnement de l’espace de travail.
WorkspaceFailoverProperties	propriétés de basculement de l’espace de travail.
WorkspaceFailoverState	État de basculement de la réplication.
WorkspaceFeatures	Fonctionnalités de l’espace de travail.
WorkspaceReplicationProperties	propriétés de réplication d’espace de travail.
WorkspaceReplicationState	État de provisionnement de la réplication.
WorkspaceSku	Référence SKU de l’espace de travail.
WorkspaceSkuNameEnum	Nom de la référence SKU.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DataIngestionStatus

Énumération

L’état de l’ingestion des données pour cet espace de travail.

Valeur	Description
RespectQuota	Ingestion activée après la réinitialisation du quota de plafond quotidien ou l’activation de l’abonnement.
ForceOn	L’ingestion a démarré suite à la modification des paramètres du service.
ForceOff	L’ingestion s’est arrêtée suite à la modification des paramètres du service.
OverQuota	Atteint le quota quotidien, l’ingestion a cessé.
SubscriptionSuspended	L’ingestion a cessé suite à la suspension de l’abonnement.
ApproachingQuota	80% de quota quotidien atteint.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

Identity

Objet

Identité de la ressource.

Nom	Type	Description
principalId	string (uuid)	ID principal de l’identité de ressource. La valeur doit être un UUID.
tenantId	string (uuid)	ID de locataire de la ressource. La valeur doit être un UUID.
type	ResourceIdentityType	Type d’identité.

PrivateLinkScopedResource

Objet

Liste des ressources de portée de lien privé lié.

Nom	Type	Description
resourceId	string	ID de ressource complet de la ressource d’étendue de lien privé.
scopeId	string	L’identificateur unique de portée du lien privé.

PublicNetworkAccessType

Énumération

Type d’accès réseau pour accéder à l’ingestion Log Analytics.

Valeur	Description
Enabled	Permet la connectivité à Log Analytics via un DNS public.
Disabled	Désactive la connectivité publique à Log Analytics via le DNS public.
SecuredByPerimeter	La ressource n’est accessible qu’à partir de réseaux privés et l’accès approuvé par le périmètre de sécurité du réseau associé à cette ressource.

ResourceIdentityType

Énumération

Type d’identité.

Valeur	Description
SystemAssigned

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Workspace

Objet

Conteneur de ressources Workspace de niveau supérieur.

Nom	Type	Valeur par défaut	Description
etag	string		Etag de l’espace de travail.
id	string		ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identité de la ressource.
location	string		Emplacement géographique où réside la ressource
name	string		Nom de la ressource
properties.createdDate	string (date-time)		Date de création de l’espace de travail.
properties.customerId	string		Il s’agit d’une propriété en lecture seule. Représente l’ID associé à l’espace de travail.
properties.defaultDataCollectionRuleResourceId	string		ID de ressource de la règle de collecte de données par défaut à utiliser pour cet espace de travail. Le format attendu est : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		propriétés de basculement de l’espace de travail.
properties.features	WorkspaceFeatures		Fonctionnalités de l’espace de travail.
properties.forceCmkForQuery	boolean		Indique si le stockage géré par le client est obligatoire pour la gestion des requêtes.
properties.modifiedDate	string (date-time)		Date de modification de l’espace de travail.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Liste des ressources de portée de lien privé lié.
properties.provisioningState	WorkspaceEntityStatus		État d’approvisionnement de l’espace de travail.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Type d’accès réseau pour accéder à l’ingestion Log Analytics.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Type d’accès réseau pour accéder à la requête Log Analytics.
properties.replication	WorkspaceReplicationProperties		propriétés de réplication d’espace de travail.
properties.retentionInDays	integer (int32)		Conservation des données de l’espace de travail en jours. Les valeurs autorisées varient selon le plan tarifaire. Pour plus d’informations, consultez la documentation sur les niveaux tarifaires.
properties.sku	WorkspaceSku		Référence SKU de l’espace de travail.
properties.workspaceCapping	WorkspaceCapping		Limite de volume quotidienne pour l’ingestion.
systemData	systemData		Métadonnées relatives à la création et à la dernière modification de la ressource.
tags	object		Balises de ressource.
type	string		Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

WorkspaceCapping

Objet

Limite de volume quotidienne pour l’ingestion.

Nom	Type	Description
dailyQuotaGb	number (double)	Quota quotidien de l’espace de travail pour l’ingestion.
dataIngestionStatus	DataIngestionStatus	L’état de l’ingestion des données pour cet espace de travail.
quotaNextResetTime	string	Le moment où le quota sera au repos.

WorkspaceEntityStatus

Énumération

État d’approvisionnement de l’espace de travail.

Valeur	Description
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Objet

propriétés de basculement de l’espace de travail.

Nom	Type	Description
lastModifiedDate	string (date-time)	La dernière fois que l’état de basculement a été mis à jour.
state	WorkspaceFailoverState	État de basculement de la réplication.

WorkspaceFailoverState

Énumération

État de basculement de la réplication.

Valeur	Description
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Objet

Fonctionnalités de l’espace de travail.

Nom	Type	Description
associations	string[]	Liste des associations pour l’espace de travail. Indique si l’espace de travail est associé à l’une des expériences suivantes : MDC, Sentinel, SentinelGraph, etc.
clusterResourceId	string	ResourceId de cluster LA dédié lié aux espaces de travail.
disableLocalAuth	boolean	Désactivez l’authentification non basée sur AAD.
enableDataExport	boolean	Indicateur indiquant si les données doivent être exportées.
enableLogAccessUsingOnlyResourcePermissions	boolean	Indicateur qui indique l’autorisation d’utiliser - ressource ou espace de travail ou les deux.
immediatePurgeDataOn30Days	boolean	Indicateur qui décrit si nous voulons supprimer les données après 30 jours.
unifiedSentinelBillingOnly	boolean	Une indication si l’espace de travail spécifié est limité au modèle de facturation unifié de sentinelle uniquement.

WorkspaceReplicationProperties

Objet

propriétés de réplication d’espace de travail.

Nom	Type	Description
createdDate	string (date-time)	La dernière fois que la réplication a été activée.
enabled	boolean	Spécifie si la réplication est activée ou non. Lorsque la valeur est true, la configuration et les données de l’espace de travail sont répliquées à l’emplacement spécifié. Si la réplication est activée, l’emplacement doit être fourni.
lastModifiedDate	string (date-time)	La dernière fois que la réplication a été mise à jour.
location	string	Emplacement de la réplication.
provisioningState	WorkspaceReplicationState	État de provisionnement de la réplication.

WorkspaceReplicationState

Énumération

État de provisionnement de la réplication.

Valeur	Description
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Objet

Référence SKU de l’espace de travail.

Nom	Type	Description
capacityReservationLevel	integer (int32)	Niveau de réservation de capacité en Go pour cet espace de travail, lorsque la référence SKU CapacityReservation est sélectionnée.
lastSkuUpdate	string (date-time)	La dernière fois que le SKU a été mis à jour.
name	WorkspaceSkuNameEnum	Nom de la référence SKU.

WorkspaceSkuNameEnum

Énumération

Nom de la référence SKU.

Valeur	Description
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

Partager via

Workspaces - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

WorkspaceGet

Exemple de requête

Exemple de réponse

Définitions

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum