Tables - Create Or Update

Hizmet:

Log Analytics

API Sürümü:

2026-03-01

Log Analytics çalışma alanı tablosunu güncelleştirin veya oluşturun.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2026-03-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Tablonun adı.
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
properties.plan	TablePlanEnum	Sisteme bu tabloya alınan günlüklerin nasıl işleneceğini ve ücretlendirileceklerini anlatın.
properties.protectionLevel	TableProtectionLevelEnum	Masanın koruma seviyesi. Varsayılan veri erişimi izolasyon davranışını belirler.
properties.restoredLogs	RestoredLogs	Bu tabloyu başlatan geri yükleme işleminin parametreleri.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Analytics tablosunda: 4 ile 730 arasında gün cinsinden analiz saklama tabloları. Bu özelliğin -1 olarak ayarlanması varsayılan olarak çalışma alanı saklama alanına ayarlanır. Temel ve Yardımcı tabloda: salt okunur özelliği.
properties.schema	Schema	Tablo şeması.
properties.searchResults	SearchResults	Bu tabloyu başlatan arama işinin parametreleri.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	4 ile 4383 arasında gün cinsinden tablo toplam saklama. Bu özelliğin -1 olarak ayarlanması varsayılan olarak retentionInDays olur.

Yanıtlar

Name	Tür	Description
200 OK	Table	Kaynak 'Tablo' güncelleme işlemi başarılı oldu
202 Accepted		Kaynak işlemi kabul edildi. Üst Bilgiler Azure-AsyncOperation: string Retry-After: integer
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ı taklit etme

Örnekler

TablesUpsert

Örnek isteği

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow?api-version=2026-03-01

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid"
        }
      ]
    },
    "retentionInDays": 45,
    "totalRetentionInDays": 70
  }
}

Örnek yanıt

Durum kodu:

200

{
  "name": "AzureNetworkFlow",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow",
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid",
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "solutions": [
        "LogManagement"
      ],
      "standardColumns": [
        {
          "name": "TenantId",
          "type": "guid",
          "isDefaultDisplay": false,
          "isHidden": true
        },
        {
          "name": "SourceSystem",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TimeGenerated",
          "type": "dateTime",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "AgentID",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourceIP",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Protocol",
          "type": "string",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "SourcePort",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "DestinationPort",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "TcpFlags",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Packets",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "Bytes",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "BytesOut",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "DurationInMs",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "RstCount",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        },
        {
          "name": "MaxSampleRtt",
          "type": "int",
          "isDefaultDisplay": false,
          "isHidden": false
        }
      ],
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "Microsoft"
    },
    "archiveRetentionInDays": 25,
    "plan": "Analytics",
    "provisioningState": "Succeeded",
    "retentionInDays": 45,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDays": 70,
    "totalRetentionInDaysAsDefault": false
  }
}

Durum kodu:

202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperaitonalInsights/workspaces/oiautorest6685/tables/table1_CL/operationresults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01
azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.OperaitonalInsights/locations/eastus/operationstatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2026-03-01

Tanımlar

Name	Description
Column	Tablo sütunu.
ColumnDataTypeHintEnum	Sütun veri türü mantıksal ipucu.
ColumnTypeEnum	Sütun veri türü.
createdByType	Kaynağı oluşturan kimliğin türü.
ErrorAdditionalInfo	Kaynak yönetimi hatasına ilişkin ek bilgiler.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
OperationalInsightsTableProvisioningState	Tablonun geçerli sağlama durumu. 'Güncelleştirme' olarak ayarlanırsa, devam eden işlem nedeniyle kaynak kilidini gösterir ve devam eden işlem sonlandırılana kadar tablodaki herhangi bir güncelleştirmeyi yasaklar.
RestoredLogs	Parametreleri geri yükleme.
ResultStatistics	arama işi yürütme istatistikleri.
Schema	Tablonun şeması.
SearchResults	Bu tabloyu başlatan arama işinin parametreleri.
SourceEnum	Tablonun yaratıcısı.
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
Table	Çalışma alanı veri tablosu tanımı.
TablePlanEnum	Sisteme bu tabloya alınan günlüklerin nasıl işleneceğini ve ücretlendirileceklerini anlatın.
TableProtectionLevelEnum	Masanın koruma seviyesi. Varsayılan veri erişimi izolasyon davranışını belirler.
TableSubTypeEnum	Alt tür, tabloyla etkileşim kurmak için hangi API'lerin kullanılabileceğini ve tabloya karşı hangi özelliklerin kullanılabilir olduğunu açıklar.
TableTypeEnum	Tablonun yaratıcısı.

Column

Nesne

Tablo sütunu.

Name	Tür	Description
dataTypeHint	ColumnDataTypeHintEnum	Sütun veri türü mantıksal ipucu.
description	string	Sütun açıklaması.
displayName	string	Sütun görünen adı. Oluşturulma zamanında ayarlanabilir; Oluşturulduktan sonra, güncellemeler ya sütun adıyla eşleşmeli ya da null/empty olarak ayarlanmalıdır. Sağlanmadıysa, varsayılan olarak sütun adı kullanılır.
isDefaultDisplay	boolean	Varsayılan olarak görüntülenir.
isHidden	boolean	Sütun gizlidir.
name	string	Sütun adı.
type	ColumnTypeEnum	Sütun veri türü.

ColumnDataTypeHintEnum

Numaralandırma

Sütun veri türü mantıksal ipucu.

Değer	Description
uri	URI deseni ile eşleşen bir dize, örneğin, k2=v2#fragment scheme://username:password@host:1234/this/is/a/path?k1=v1&
guid	Standart şekli izleyen standart bir 128 bit GUID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxx
armPath	Azure Kaynak Modeli (ARM) yolu: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
ip	X.x.x.x/y:y standart şeklini izleyen standart bir V4/V6 ip adresi
vector16	Anlamsal / benzerlik araması için kullanılan tek hassasiyetli kayan nokta değerleri vektörüdür.

ColumnTypeEnum

Numaralandırma

Sütun veri türü.

Değer	Description
string	Dize
int	Int
long	long
real	real
boolean	Boolean
dateTime	tarih ve saat
guid	guid
dynamic	dynamic

createdByType

Numaralandırma

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

Değer	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Nesne

Kaynak yönetimi hatasına ilişkin ek bilgiler.

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 bilgisi.
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.

OperationalInsightsTableProvisioningState

Numaralandırma

Tablonun geçerli sağlama durumu. 'Güncelleştirme' olarak ayarlanırsa, devam eden işlem nedeniyle kaynak kilidini gösterir ve devam eden işlem sonlandırılana kadar tablodaki herhangi bir güncelleştirmeyi yasaklar.

Değer	Description
Updating	Tablo şeması hala oluşturuluyor ve güncelleştiriliyor, yordam yapılana kadar tablo şu anda tüm değişikliklere karşı kilitlenmiş durumda.
InProgress	Tablo şeması kararlıdır ve değişiklik yapılmadan tablo verileri güncelleştirilir.
Succeeded	Tablo durumu kararlıdır ve değişiklik yapılmaz, tablonun kilidi açılır ve yeni güncelleştirmeler için açılır.
Deleting	Tablo durumu siliniyor.

RestoredLogs

Nesne

Parametreleri geri yükleme.

Name	Tür	Description
azureAsyncOperationId	string	Arama sonuçları tablosu zaman uyumsuz işlem kimliği.
endRestoreTime	string (date-time)	Geri yüklemeyi (UTC) sona erdirmek için zaman damgası.
sourceTable	string	Verileri geri yükleneceği tablo.
startRestoreTime	string (date-time)	(UTC) itibarıyla geri yüklemeyi başlatmak için zaman damgası.

ResultStatistics

Nesne

arama işi yürütme istatistikleri.

Name	Tür	Description
ingestedRecords	integer (int32)	Arama işi tarafından döndürülen satır sayısı.
progress	number (float)	arama işi tamamlanma yüzdesi.
scannedGb	number (float)	Arama işi: Taranan veri miktarı.

Schema

Nesne

Tablonun şeması.

Name	Tür	Description
categories	string[]	Tablo kategorisi.
columns	Column[]	Tablo özel sütunlarının listesi.
description	string	Tablo açıklaması.
displayName	string	Tablo görünen adı.
labels	string[]	Tablo etiketleri.
name	string	Tablo adı.
solutions	string[]	Tablonun bağlı olduğu çözümlerin listesi
source	SourceEnum	Tablonun yaratıcısı.
standardColumns	Column[]	Tablo standart sütunlarının listesi.
tableSubType	TableSubTypeEnum	Alt tür, tabloyla etkileşim kurmak için hangi API'lerin kullanılabileceğini ve tabloya karşı hangi özelliklerin kullanılabilir olduğunu açıklar.
tableType	TableTypeEnum	Tablonun yaratıcısı.

SearchResults

Nesne

Bu tabloyu başlatan arama işinin parametreleri.

Name	Tür	Description
azureAsyncOperationId	string	Arama sonuçları tablosu zaman uyumsuz işlem kimliği.
description	string	Arama işi Açıklaması.
endSearchTime	string (date-time)	Aramayı (UTC) sona erdirmek için zaman damgası
limit	integer (int32)	Arama işini belirtilen sayıda satır döndürecek şekilde sınırlayın.
query	string	arama işi sorgusu.
sourceTable	string	Arama işinde kullanılan tablo.
startSearchTime	string (date-time)	Aramayı başlatma zaman damgası (UTC)

SourceEnum

Numaralandırma

Tablonun yaratıcısı.

Değer	Description
microsoft	Tanılama Ayarları, Aracılar veya diğer standart veri toplama araçları aracılığıyla toplanan sistem tarafından sağlanan tablolar.
customer	Çalışma Alanının sahibi tarafından oluşturulan ve yalnızca bu Çalışma Alanında bulunan tablolar.

systemData

Nesne

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

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturmanın zaman damgası (UTC).
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ü.

Table

Nesne

Çalışma alanı veri tablosu tanımı.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam nitelikli kaynak kimliği. Örneğin "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties.archiveRetentionInDays	integer (int32)	Tablolar gün cinsinden uzun süreli saklama. (totalRetentionInDays-retentionInDays) olarak hesaplanır.
properties.lastPlanModifiedDate	string	Tablo planının son değiştirildiği zaman damgası (UTC).
properties.plan	TablePlanEnum	Sisteme bu tabloya alınan günlüklerin nasıl işleneceğini ve ücretlendirileceklerini anlatın.
properties.protectionLevel	TableProtectionLevelEnum	Masanın koruma seviyesi. Varsayılan veri erişimi izolasyon davranışını belirler.
properties.provisioningState	OperationalInsightsTableProvisioningState	Tablonun geçerli sağlama durumu. 'Güncelleştirme' olarak ayarlanırsa, devam eden işlem nedeniyle kaynak kilidini gösterir ve devam eden işlem sonlandırılana kadar tablodaki herhangi bir güncelleştirmeyi yasaklar.
properties.restoredLogs	RestoredLogs	Bu tabloyu başlatan geri yükleme işleminin parametreleri.
properties.resultStatistics	ResultStatistics	arama işi yürütme istatistikleri.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Analytics tablosunda: 4 ile 730 arasında gün cinsinden analiz saklama tabloları. Bu özelliğin -1 olarak ayarlanması varsayılan olarak çalışma alanı saklama alanına ayarlanır. Temel ve Yardımcı tabloda: salt okunur özelliği.
properties.retentionInDaysAsDefault	boolean	True - Değer, çalışma alanı saklama süresinden gün olarak kaynaklanır, False - Müşteriye özgü.
properties.schema	Schema	Tablo şeması.
properties.searchResults	SearchResults	Bu tabloyu başlatan arama işinin parametreleri.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	4 ile 4383 arasında gün cinsinden tablo toplam saklama. Bu özelliğin -1 olarak ayarlanması varsayılan olarak retentionInDays olur.
properties.totalRetentionInDaysAsDefault	boolean	True - Değer gün içindeki saklamadan kaynaklanır, False - Müşteriye özel.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

TablePlanEnum

Numaralandırma

Sisteme bu tabloya alınan günlüklerin nasıl işleneceğini ve ücretlendirileceklerini anlatın.

Değer	Description
Basic	Sorun giderme ve olay müdahalesi için orta düzeyde dokunma günlükleri gereklidir.
Analytics	Sürekli izleme, gerçek zamanlı algılama ve performans analizi için kullanılan yüksek değerli günlükler.
Auxiliary	Ayrıntılı günlükler gibi az dokunulan günlükler ve denetim ve uyumluluk için gereken veriler.

TableProtectionLevelEnum

Numaralandırma

Masanın koruma seviyesi. Varsayılan veri erişimi izolasyon davranışını belirler.

Değer	Description
General	Varsayılan koruma seviyesi. Tablo verilerine standart izinler aracılığıyla erişilebilir.
Protected	Tablo verileri varsayılan olarak izole edilmiştir. Verilere erişmek veya dışa aktarmak için açık, kapsamlı yetkilendirme gereklidir.

TableSubTypeEnum

Numaralandırma

Alt tür, tabloyla etkileşim kurmak için hangi API'lerin kullanılabileceğini ve tabloya karşı hangi özelliklerin kullanılabilir olduğunu açıklar.

Değer	Description
Any	Yerleşik tabloların oluşturulduğu varsayılan alt tür.
Classic	Veri Toplayıcı API'si aracılığıyla veya MMA aracısının özel günlükler özelliğiyle veya Özel Alanlar'ın oluşturulduğu herhangi bir tabloyla oluşturulan tabloyu gösterir.
DataCollectionRuleBased	Veri Toplama Kuralları tarafından desteklenen araçlardan herhangi biri aracılığıyla veri göndermeye uygun bir tablo: Veri Toplama Uç Noktası API'si, alma zamanı dönüştürmeleri veya Veri Toplama Kuralları tarafından sağlanan diğer mekanizmalar

TableTypeEnum

Numaralandırma

Tablonun yaratıcısı.

Değer	Description
Microsoft	Azure İzleyici tarafından toplanan standart veriler.
CustomLog	Özel günlük tablosu.
RestoredLogs	Geri yüklenen veriler.
SearchResults	Bir arama işi tarafından toplanan veriler.