Workspaces - Update

Başvuru

Hizmet:: Log Analytics

API Sürümü:: 2025-02-01

Çalışma alanını güncelleştirir.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-02-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 minLength: 1	Hedef aboneliğin kimliği.
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ü.

İstek Gövdesi

Name	Tür	Description
identity	Identity	Kaynağın kimliği.
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.publicNetworkAccessForIngestion	PublicNetworkAccessType	Log Analytics alımına erişmek için ağ erişim türü.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	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ı.
tags	object	Kaynak etiketleri. Opsiyonel.

Yanıtlar

Name	Tür	Description
200 OK	Workspace	Mevcut çalışma alanı başarıyla güncelleştirildi. Ayrıntılı durumu görmek için provisioningStatus'ı denetleyin.
Other Status Codes	ErrorResponse	İşlemin neden başarısız olduğunu açıklayan 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

WorkspacesPatch

Örnek isteği

HTTP

PATCH 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,
    "workspaceCapping": {
      "dailyQuotaGb": -1
    }
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled",
    "workspaceCapping": {
      "dailyQuotaGb": -1,
      "quotaNextResetTime": "Mon, 16 Nov 2020 15:00:00 GMT",
      "dataIngestionStatus": "RespectQuota"
    }
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Tanımlar

Name	Description
CapacityReservationLevel	CapacityReservation sku'su seçildiğinde bu çalışma alanının GB kapasite rezervasyon düzeyi.
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ışma Alanı'nda çalışmaya yönelik ağ erişim türü. Varsayılan olarak Etkindir
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
UserIdentityProperties	Kullanıcı tarafından atanan kimlik özellikleri.
Workspace	Ü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.
WorkspacePatch	Üst düzey Çalışma Alanı kaynak kapsayıcısı.
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ı.

CapacityReservationLevel

Listeleme

CapacityReservation sku'su seçildiğinde bu çalışma alanının GB kapasite rezervasyon düzeyi.

Değer	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Listeleme

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

Değer	Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Listeleme

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

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

ErrorAdditionalInfo

Object

Kaynak yönetimi hatası ek bilgileri.

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

ErrorDetail

Object

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

Object

Hata yanıtı

Name	Tür	Description
error	ErrorDetail	Hata nesnesi.

Identity

Object

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

Listeleme

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

Değer	Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Object

Ö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

Listeleme

Log Analytics Çalışma Alanı'nda çalışmaya yönelik ağ erişim türü. Varsayılan olarak Etkindir

Değer	Description
Disabled	Genel DNS aracılığıyla Log Analytics'e genel bağlantıyı devre dışı bırakır.
Enabled	Genel DNS aracılığıyla Log Analytics'e bağlantı sağlar.

systemData

Object

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

Object

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

Object

Ü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		Kaynağın tam kaynak kimliği. Ex - /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ştirme tarihi.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Bağ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		Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
tags	object		Kaynak etiketleri.
type	string		Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Object

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	Kotanın geri alınacağı zaman.

WorkspaceEntityStatus

Listeleme

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

Değer	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Object

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

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

WorkspaceFailoverState

Listeleme

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

Değer	Description
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Object

Çalışma alanı özellikleri.

Name	Tür	Description
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österen bir gösterge.

WorkspacePatch

Object

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

Name	Tür	Default value	Description
etag	string		Kaynak Etag'i.
id	string		Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Kaynağın kimliği.
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ştirme tarihi.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Bağ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ı.
tags	object		Kaynak etiketleri. Opsiyonel.
type	string		Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

WorkspaceReplicationProperties

Object

Ç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ştirilişi.
location	string	Çoğaltmanın konumu.
provisioningState	WorkspaceReplicationState	Çoğaltmanın sağlama durumu.

WorkspaceReplicationState

Listeleme

Çoğaltmanın sağlama durumu.

Değer	Description
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Object

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

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

WorkspaceSkuNameEnum

Listeleme

SKU'nun adı.

Değer	Description
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

Aracılığıyla paylaş

Workspaces - Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

WorkspacesPatch

Örnek isteği

Örnek yanıt

Tanımlar

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspacePatch

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Ek kaynaklar