Tables - Create Or Update

Hizmet:

Log Analytics

API Sürümü:

2025-07-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=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.
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.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ın kimliğine bürünme

Ö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=2025-07-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=2025-07-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=2025-07-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ı ek bilgileri.
ErrorDetail	Hata ayrıntısı.
ErrorResponse	Hata yanıtı
OperationalInsightsTableProvisioningState	Tablonun geçerli sağlama durumu. 'Güncelleniyor' olarak ayarlanırsa, devam eden işlem nedeniyle bir kaynak kilidi olduğunu gösterir ve devam eden işlem tamamlanana kadar tabloda herhangi bir güncelleştirme yapılmasını yasaklar.
RestoredLogs	Parametreleri geri yükleyin.
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.
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ı.
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'nin deseniyle eşleşen bir dize, örneğin, scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment
guid	Standart şekli izleyen standart bir 128 bit GUID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath	Azure Kaynak Modeli (ARM) yolu: /subscriptions/{...}/kaynakGrupları/{...}/providers/Microsoft olarak ayarlayın. {...}/{...}/{...}/{...}...
ip	Standart şekli izleyen standart bir V4/V6 IP adresi, x.x.x.x/y:y:y:y:y:y:y

ColumnTypeEnum

Numaralandırma

Sütun veri türü.

Değer	Description
string	string
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ı 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.

OperationalInsightsTableProvisioningState

Numaralandırma

Tablonun geçerli sağlama durumu. 'Güncelleniyor' olarak ayarlanırsa, devam eden işlem nedeniyle bir kaynak kilidi olduğunu gösterir ve devam eden işlem tamamlanana kadar tabloda herhangi bir güncelleştirme yapılmasını yasaklar.

Değer	Description
Updating	Tablo şeması hala oluşturulmakta ve güncellenmektedir, tablo şu anda prosedür tamamlanana kadar herhangi bir değişiklik için kilitlidir.
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ılmadan tablonun kilidi açılır ve yeni güncellemelere açıktır.
Deleting	Tablo durumu siliniyor.

RestoredLogs

Nesne

Parametreleri geri yükleyin.

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)	İş tamamlama yüzdesini arayın.
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ş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ü.

Table

Nesne

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

Name	Tür	Description
id	string (arm-id)	Kaynağın tam 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 en 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.provisioningState	OperationalInsightsTableProvisioningState	Tablonun geçerli sağlama durumu. 'Güncelleniyor' olarak ayarlanırsa, devam eden işlem nedeniyle bir kaynak kilidi olduğunu gösterir ve devam eden işlem tamamlanana kadar tabloda herhangi bir güncelleştirme yapılmasını 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, gün cinsinden çalışma alanı bekletme işleminden kaynaklanır, False - Müşteriye özel.
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	Doğru - Değer gün cinsinden bekletmeden kaynaklanır, Yanlış - 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.

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 oluşturulan bir tabloyu veya Özel Alanların oluşturulduğu herhangi bir tabloyu belirtir.
DataCollectionRuleBased	Veri Toplama Kuralları tarafından desteklenen araçlardan herhangi biri aracılığıyla veri gönderilmesine uygun bir tablo: Veri Toplama Uç Noktası API'si, alım 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.