Tables - Create Or Update

Başvuru

Hizmet:: Log Analytics

API Sürümü:: 2025-02-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-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.
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	4 ile 730 arasında gün cinsinden tablo saklama. Bu özelliğin -1 olarak ayarlanması varsayılan olarak çalışma alanı saklama alanına ayarlanır.
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 tablo saklama olarak ayarlanır.

Yanıtlar

Name	Tür	Description
200 OK	Table	Tamam yanıt tanımı.
202 Accepted		Kabul edilen yanıt tanımı (Uzun süre çalışan işlem).
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

TablesUpsert

Örnek isteği

HTTP

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

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

Örnek yanıt

Durum kodu:: 200

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "Microsoft",
      "columns": [
        {
          "isHidden": false,
          "name": "MyNewColumn",
          "type": "guid",
          "isDefaultDisplay": false
        }
      ],
      "standardColumns": [
        {
          "isHidden": true,
          "name": "TenantId",
          "type": "guid",
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "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
        }
      ],
      "solutions": [
        "LogManagement"
      ]
    },
    "provisioningState": "Succeeded",
    "retentionInDays": 45,
    "totalRetentionInDays": 70,
    "archiveRetentionInDays": 25,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDaysAsDefault": false,
    "plan": "Analytics"
  },
  "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow",
  "name": "AzureNetworkFlow"
}

Durum kodu:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/providers/Microsoft.OperaitonalInsights/locations/eastus/operationstatuses/62e4d893-d233-4005-988e-a428d9f77076?api-version=2025-02-01
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperaitonalInsights/workspaces/oiautorest6685/tables/table1_CL/operationresults/62e4d893-d233-4005-988e-a428d9f77076?api-version=2025-02-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ı
ProvisioningStateEnum	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 oluşturucusu.
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şime geçmek için hangi API'lerin kullanılabileceğini ve buna karşı hangi özelliklerin kullanılabilir olduğunu açıklar.
TableTypeEnum	Tablonun oluşturucusu.

Column

Object

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

Listeleme

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

Değer	Description
armPath	Azure Kaynak Modeli (ARM) yolu: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	Standart şekli izleyen standart bir 128 bit GUID, xxxxxxxx-xxxx-xxxx-xxxx-xxxxx
ip	X.x.x.x/y:y standart şeklini izleyen standart bir V4/V6 ip adresi
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&

ColumnTypeEnum

Listeleme

Sütun veri türü.

Değer	Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Listeleme

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

Değer	Description
Application
Key
ManagedIdentity
User

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.

ProvisioningStateEnum

Listeleme

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
Deleting	Tablo durumu siliniyor.
InProgress	Tablo şeması kararlı ve değişiklik yapılmadan tablo verileri güncelleştiriliyor.
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.
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.

RestoredLogs

Object

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

Object

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 multipleOf: 0.01	arama işi tamamlanma yüzdesi.
scannedGb	number multipleOf: 0.01	Arama işi: Taranan veri miktarı.

Schema

Object

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 oluşturucusu.
standardColumns	Column[]	Tablo standart sütunlarının listesi.
tableSubType	TableSubTypeEnum	Alt tür, tabloyla etkileşime geçmek için hangi API'lerin kullanılabileceğini ve buna karşı hangi özelliklerin kullanılabilir olduğunu açıklar.
tableType	TableTypeEnum	Tablonun oluşturucusu.

SearchResults

Object

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

Listeleme

Tablonun oluşturucusu.

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

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

Table

Object

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

Name	Tür	Description
id	string	Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Kaynağın adı
properties.archiveRetentionInDays	integer (int32)	Tablo verilerinin gün olarak arşiv tutulması. Olarak hesaplanır (totalRetentionInDays-retentionInDays)
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.provisioningState	ProvisioningStateEnum	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	4 ile 730 arasında gün cinsinden tablo saklama. Bu özelliğin -1 olarak ayarlanması varsayılan olarak çalışma alanı saklama alanına ayarlanır.
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 tablo saklama olarak ayarlanır.
properties.totalRetentionInDaysAsDefault	boolean	True - Değer gün içindeki saklamadan kaynaklanır, False - Müşteriye özel.
systemData	systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

TablePlanEnum

Listeleme

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

Değer	Description
Analytics	İzlemeye ve analize izin veren günlükler.
Basic	Yüksek hacimli düşük değerli ayrıntılı günlükleri destekleyecek şekilde ayarlanmış günlükler.

TableSubTypeEnum

Listeleme

Alt tür, tabloyla etkileşime geçmek için hangi API'lerin kullanılabileceğini ve buna 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

Listeleme

Tablonun oluşturucusu.

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

Aracılığıyla paylaş

Tables - Create Or Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

TablesUpsert

Örnek isteği

Örnek yanıt

Tanımlar

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

Ek kaynaklar