Workspaces - Get

Hizmet:

Log Analytics

API Sürümü:

2025-07-01

Bir çalışma alanı örneği alır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. Ad büyük/küçük harfe duyarsız.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Çalışma alanının adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name	Tür	Description
200 OK	Workspace	Azure işlemi başarıyla tamamlandı.
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

WorkspaceGet

Örnek isteği

HTTP

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

Java

/**
 * 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

Python

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

Go

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

JavaScript

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

Örnek yanıt

Durum kodu:

200

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

Tanımlar

Name	Description
createdByType	Kaynağı oluşturan kimliğin türü.
DataIngestionStatus	Bu çalışma alanı için veri alımının durumu.
ErrorAdditionalInfo	Kaynak yönetimi hatası ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
Identity	Kaynağın kimliği.
IdentityType	Yönetilen hizmet kimliği türü.
PrivateLinkScopedResource	Özel bağlantı kapsamı kaynak başvurusu.
PublicNetworkAccessType	Log Analytics alımına erişmek için ağ erişim türü.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UserIdentityProperties	Kullanıcı tarafından atanan kimlik özellikleri.
Workspace	En üst düzey Çalışma Alanı kaynak kapsayıcısı.
WorkspaceCapping	Alım için günlük hacim üst sınırı.
WorkspaceEntityStatus	Çalışma alanının sağlama durumu.
WorkspaceFailoverProperties	Çoğaltmanın yük devretme durumu.
WorkspaceFailoverState	Çoğaltmanın yük devretme durumu.
WorkspaceFeatures	Çalışma alanı özellikleri.
WorkspaceReplicationProperties	Çalışma alanı çoğaltma özellikleri.
WorkspaceReplicationState	Çoğaltmanın sağlama durumu.
WorkspaceSku	Çalışma alanının SKU'su (katman).
WorkspaceSkuNameEnum	SKU'nun adı.

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DataIngestionStatus

Numaralandırma

Bu çalışma alanı için veri alımının durumu.

Değer	Description
RespectQuota	Günlük üst sınır kotası sıfırlama veya abonelik etkinleştirme sonrasında alım etkinleştirilir.
ForceOn	Alım, hizmet ayarı değişikliğinin ardından başladı.
ForceOff	Hizmet ayarı değişikliğinin ardından alım durduruldu.
OverQuota	Günlük üst sınır kotasına ulaşıldı, alım durduruldu.
SubscriptionSuspended	Askıya alınan aboneliğin ardından alım durduruldu.
ApproachingQuota	Günlük üst sınır kotasının% 80'ine ulaşıldı.

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatası ek bilgileri.

Name	Tür	Description
info	object	Ek bilgiler.
type	string	Ek bilgi türü.

ErrorDetail

Nesne

Hata ayrıntısı.

Name	Tür	Description
additionalInfo	ErrorAdditionalInfo[]	Hata ek bilgileri.
code	string	Hata kodu.
details	ErrorDetail[]	Hata ayrıntıları.
message	string	Hata iletisi.
target	string	Hata hedefi.

ErrorResponse

Nesne

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

Identity

Nesne

Kaynağın kimliği.

Name	Tür	Description
principalId	string	Kaynak kimliğinin asıl kimliği.
tenantId	string	Kaynağın kiracı kimliği.
type	IdentityType	Yönetilen hizmet kimliği türü.
userAssignedIdentities	<string,  UserIdentityProperties>	Kaynakla ilişkili kullanıcı kimliklerinin listesi. Kullanıcı kimliği sözlük anahtarı başvuruları şu biçimde ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Numaralandırma

Yönetilen hizmet kimliği türü.

Değer	Description
SystemAssigned	Sistem Ataması
UserAssigned	UserAssigned
None	Hiçbiri

PrivateLinkScopedResource

Nesne

Özel bağlantı kapsamı kaynak başvurusu.

Name	Tür	Description
resourceId	string	Özel bağlantı kapsamı kaynağının tam kaynak kimliği.
scopeId	string	Özel bağlantı kapsamı benzersiz Tanımlayıcısı.

PublicNetworkAccessType

Numaralandırma

Log Analytics alımına erişmek için ağ erişim türü.

Değer	Description
Enabled	Genel DNS aracılığıyla Log Analytics'e bağlantı sağlar.
Disabled	Genel DNS aracılığıyla Log Analytics'e genel bağlantıyı devre dışı bırakır.
SecuredByPerimeter	Kaynağa yalnızca özel ağlardan ve bu kaynakla ilişkili ağ güvenlik çevresi tarafından onaylanan erişimden erişilebilir.

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

UserIdentityProperties

Nesne

Kullanıcı tarafından atanan kimlik özellikleri.

Name	Tür	Description
clientId	string	Kullanıcı tarafından atanan kimliğin istemci kimliği.
principalId	string	Kullanıcı tarafından atanan kimliğin asıl kimliği.

Workspace

Nesne

En üst düzey Çalışma Alanı kaynak kapsayıcısı.

Name	Tür	Default value	Description
etag	string		Çalışma alanının etiketi.
id	string (arm-id)		Kaynağın tam kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	Identity		Kaynağın kimliği.
location	string		Kaynağın bulunduğu coğrafi konum
name	string		Kaynağın adı
properties.createdDate	string (date-time)		Çalışma alanı oluşturma tarihi.
properties.customerId	string		Bu salt okunur bir özelliktir. Çalışma alanıyla ilişkili kimliği temsil eder.
properties.defaultDataCollectionRuleResourceId	string		Bu çalışma alanı için kullanılacak varsayılan Veri Toplama Kuralı'nın kaynak kimliği. Beklenen biçim: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		çalışma alanı yük devretme özellikleri.
properties.features	WorkspaceFeatures		Çalışma alanı özellikleri.
properties.forceCmkForQuery	boolean		Müşteri tarafından yönetilen depolamanın sorgu yönetimi için zorunlu olup olmadığını gösterir.
properties.modifiedDate	string (date-time)		Çalışma alanı değişiklik tarihi.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Bağlantılı özel bağlantı kapsamı kaynaklarının listesi.
properties.provisioningState	WorkspaceEntityStatus		Çalışma alanının sağlama durumu.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Log Analytics alımına erişmek için ağ erişim türü.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Log Analytics sorgusuna erişmek için ağ erişim türü.
properties.replication	WorkspaceReplicationProperties		çalışma alanı çoğaltma özellikleri.
properties.retentionInDays	integer (int32)		Çalışma alanı verilerini gün olarak saklama. İzin verilen değerler fiyatlandırma planına göredir. Ayrıntılar için fiyatlandırma katmanları belgelerine bakın.
properties.sku	WorkspaceSku		Çalışma alanının SKU'su.
properties.workspaceCapping	WorkspaceCapping		Alım için günlük hacim üst sınırı.
systemData	systemData		createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object		Kaynak etiketleri.
type	string		Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Nesne

Alım için günlük hacim üst sınırı.

Name	Tür	Description
dailyQuotaGb	number (double)	Veri alımı için çalışma alanı günlük kotası.
dataIngestionStatus	DataIngestionStatus	Bu çalışma alanı için veri alımının durumu.
quotaNextResetTime	string	Kontenjanın dinlenme olacağı zaman.

WorkspaceEntityStatus

Numaralandırma

Çalışma alanının sağlama durumu.

Değer	Description
Creating	Oluşturma
Succeeded	Succeeded
Failed	Başarısız oldu
Canceled	İptal edildi
Deleting	Siliniyor
ProvisioningAccount	ProvisioningAccount
Updating	Güncelleştirme

WorkspaceFailoverProperties

Nesne

Çoğaltmanın yük devretme durumu.

Name	Tür	Description
lastModifiedDate	string (date-time)	Yük devretme durumunun en son güncelleştirildiği zaman.
state	WorkspaceFailoverState	Çoğaltmanın yük devretme durumu.

WorkspaceFailoverState

Numaralandırma

Çoğaltmanın yük devretme durumu.

Değer	Description
Inactive	Etkin olmayan
Activating	Etkinleştirme
Active	Aktif
Deactivating	Devre dışı bırakılıyor
Failed	Başarısız oldu

WorkspaceFeatures

Nesne

Çalışma alanı özellikleri.

Name	Tür	Description
associations	string[]	Çalışma alanı için ilişkilendirmelerin listesi. Çalışma alanının şu deneyimlerden herhangi biriyle ilişkili olup olmadığını gösterir: MDC, Sentinel, SentinelGraph vb.
clusterResourceId	string	Çalışma alanlarına bağlı ayrılmış LA kümesi resourceId.
disableLocalAuth	boolean	AAD tabanlı olmayan Kimlik Doğrulamasını devre dışı bırakın.
enableDataExport	boolean	Verilerin dışarı aktarılıp dışarı aktarılmaması gerektiğini gösteren bayrak.
enableLogAccessUsingOnlyResourcePermissions	boolean	Hangi iznin kullanılacağını belirten bayrak : kaynak veya çalışma alanı ya da her ikisi.
immediatePurgeDataOn30Days	boolean	Verileri 30 gün sonra kaldırmak isteyip istemediğinizi açıklayan bayrak.
unifiedSentinelBillingOnly	boolean	Belirtilen çalışma alanının yalnızca sentinel'in birleşik faturalama modeliyle sınırlı olup olmadığını gösterir.

WorkspaceReplicationProperties

Nesne

Çalışma alanı çoğaltma özellikleri.

Name	Tür	Description
createdDate	string (date-time)	Çoğaltmanın en son etkinleştirildiği zaman.
enabled	boolean	Çoğaltmanın etkinleştirilip etkinleştirilmediğini belirtir. True olduğunda, çalışma alanı yapılandırması ve veriler belirtilen konuma çoğaltılır. Çoğaltma etkinleştirildiyse, konum sağlanmalıdır.
lastModifiedDate	string (date-time)	Çoğaltmanın en son güncelleştirildiği zaman.
location	string	Çoğaltmanın konumu.
provisioningState	WorkspaceReplicationState	Çoğaltmanın sağlama durumu.

WorkspaceReplicationState

Numaralandırma

Çoğaltmanın sağlama durumu.

Değer	Description
Succeeded	Succeeded
EnableRequested	EnableRequested'i
Enabling	Etkinleştiriliyor
DisableRequested	DisableRequestedRequest
Disabling	Devre dışı bırakma
RollbackRequested	Geri Geri Alma İsteniyor
RollingBack	RollingBack
Failed	Başarısız oldu
Canceled	İptal edildi

WorkspaceSku

Nesne

Çalışma alanının SKU'su (katman).

Name	Tür	Description
capacityReservationLevel	integer (int32)	CapacityReservation sku'su seçildiğinde bu çalışma alanının GB kapasite rezervasyon düzeyi.
lastSkuUpdate	string (date-time)	Sku'nun en son güncellendiği zaman.
name	WorkspaceSkuNameEnum	SKU'nun adı.

WorkspaceSkuNameEnum

Numaralandırma

SKU'nun adı.

Değer	Description
Free	Free
Standard	Standart
Premium	Premium
PerNode	PerNode
PerGB2018	PerGB2018
Standalone	Bağımsız
CapacityReservation	Kapasite Rezervasyonu
LACluster	LACluster