Tables - Create Or Update

Referensi

Layanan:: Log Analytics

Versi API:: 2025-02-01

Memperbarui atau Membuat tabel ruang kerja Analitik Log.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama ini tidak peka huruf besar/kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Nama tabel.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nama ruang kerja.
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.plan	TablePlanEnum	Instruksikan sistem cara menangani dan mengisi daya log yang diserap ke tabel ini.
properties.restoredLogs	RestoredLogs	Parameter operasi pemulihan yang memulai tabel ini.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Retensi tabel dalam hari, antara 4 dan 730. Mengatur properti ini ke -1 akan default ke retensi ruang kerja.
properties.schema	Schema	Skema tabel.
properties.searchResults	SearchResults	Parameter pekerjaan pencarian yang memulai tabel ini.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Total retensi tabel dalam hari, antara 4 dan 4383. Mengatur properti ini ke -1 akan default ke retensi tabel.

Respons

Nama	Jenis	Deskripsi
200 OK	Table	Definisi respons OK.
202 Accepted		Definisi respons yang diterima (Operasi jangka panjang).
Other Status Codes	ErrorResponse	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

TablesUpsert

Permintaan sampel

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
  }
}

Respon sampel

Kode status:: 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"
}

Kode status:: 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

Definisi

Nama	Deskripsi
Column	Kolom tabel.
ColumnDataTypeHintEnum	Petunjuk logis jenis data kolom.
ColumnTypeEnum	Jenis data kolom.
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
ProvisioningStateEnum	Status provisi tabel saat ini. Jika diatur ke 'memperbarui', menunjukkan kunci sumber daya karena operasi yang sedang berlangsung, melarang pembaruan apa pun ke tabel hingga operasi yang sedang berlangsung disimpulkan.
RestoredLogs	Pulihkan parameter.
ResultStatistics	Cari statistik eksekusi pekerjaan.
Schema	Skema tabel.
SearchResults	Parameter pekerjaan pencarian yang memulai tabel ini.
SourceEnum	Pembuat tabel.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
Table	Definisi tabel data ruang kerja.
TablePlanEnum	Instruksikan sistem cara menangani dan mengisi daya log yang diserap ke tabel ini.
TableSubTypeEnum	Subjenis menjelaskan API apa yang dapat digunakan untuk berinteraksi dengan tabel, dan fitur apa yang tersedia terhadapnya.
TableTypeEnum	Pembuat tabel.

Column

Objek

Kolom tabel.

Nama	Jenis	Deskripsi
dataTypeHint	ColumnDataTypeHintEnum	Petunjuk logis jenis data kolom.
description	string	Deskripsi kolom.
displayName	string	Nama tampilan kolom.
isDefaultDisplay	boolean	Ditampilkan secara default.
isHidden	boolean	Apakah kolom disembunyikan.
name	string	Nama kolom.
type	ColumnTypeEnum	Jenis data kolom.

ColumnDataTypeHintEnum

Enumeration

Petunjuk logis jenis data kolom.

Nilai	Deskripsi
armPath	Jalur Azure Resource Model (ARM): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	GUID 128-bit standar mengikuti bentuk standar, xxxxxxxx-xxxx-xxxx-xxxx-xxxx
ip	Alamat ip V4/V6 standar setelah bentuk standar, x.x.x.x/y:y:y:y:y:y:y:y:y:y:y
uri	String yang cocok dengan pola URI, misalnya, scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragmen

ColumnTypeEnum

Enumeration

Jenis data kolom.

Nilai	Deskripsi
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Enumeration

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ProvisioningStateEnum

Enumeration

Status provisi tabel saat ini. Jika diatur ke 'memperbarui', menunjukkan kunci sumber daya karena operasi yang sedang berlangsung, melarang pembaruan apa pun ke tabel hingga operasi yang sedang berlangsung disimpulkan.

Nilai	Deskripsi
Deleting	Status tabel dihapus.
InProgress	Skema tabel stabil dan tanpa perubahan, data tabel sedang diperbarui.
Succeeded	Status tabel stabil dan tanpa perubahan, tabel tidak terkunci dan terbuka untuk pembaruan baru.
Updating	Skema tabel masih dibangun dan diperbarui, tabel saat ini dikunci untuk setiap perubahan sampai prosedur selesai.

RestoredLogs

Objek

Pulihkan parameter.

Nama	Jenis	Deskripsi
azureAsyncOperationId	string	Id operasi asinkron tabel hasil pencarian.
endRestoreTime	string (date-time)	Tanda waktu untuk mengakhiri pemulihan menurut (UTC).
sourceTable	string	Tabel untuk memulihkan data.
startRestoreTime	string (date-time)	Tanda waktu untuk memulai pemulihan dari (UTC).

ResultStatistics

Objek

Cari statistik eksekusi pekerjaan.

Nama	Jenis	Deskripsi
ingestedRecords	integer (int32)	Jumlah baris yang dikembalikan oleh pekerjaan pencarian.
progress	number multipleOf: 0.01	Persentase penyelesaian pekerjaan pencarian.
scannedGb	number multipleOf: 0.01	Pekerjaan pencarian: Jumlah data yang dipindai.

Schema

Objek

Skema tabel.

Nama	Jenis	Deskripsi
categories	string[]	Kategori tabel.
columns	Column[]	Daftar kolom kustom tabel.
description	string	Deskripsi tabel.
displayName	string	Nama tampilan tabel.
labels	string[]	Label tabel.
name	string	Nama tabel.
solutions	string[]	Daftar solusi yang berafiliasi dengan tabel
source	SourceEnum	Pembuat tabel.
standardColumns	Column[]	Daftar kolom standar tabel.
tableSubType	TableSubTypeEnum	Subjenis menjelaskan API apa yang dapat digunakan untuk berinteraksi dengan tabel, dan fitur apa yang tersedia terhadapnya.
tableType	TableTypeEnum	Pembuat tabel.

SearchResults

Objek

Parameter pekerjaan pencarian yang memulai tabel ini.

Nama	Jenis	Deskripsi
azureAsyncOperationId	string	Id operasi asinkron tabel hasil pencarian.
description	string	Deskripsi pekerjaan pencarian.
endSearchTime	string (date-time)	Tanda waktu untuk mengakhiri pencarian menurut (UTC)
limit	integer (int32)	Batasi pekerjaan pencarian untuk mengembalikan hingga jumlah baris yang ditentukan.
query	string	Kueri pekerjaan pencarian.
sourceTable	string	Tabel yang digunakan dalam pekerjaan pencarian.
startSearchTime	string (date-time)	Tanda waktu untuk memulai pencarian dari (UTC)

SourceEnum

Enumeration

Pembuat tabel.

Nilai	Deskripsi
customer	Tabel yang dibuat oleh pemilik Ruang Kerja, dan hanya ditemukan di Ruang Kerja ini.
microsoft	Tabel yang disediakan oleh sistem, seperti yang dikumpulkan melalui Pengaturan Diagnostik, Agen, atau sarana pengumpulan data standar lainnya.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.

Table

Objek

Definisi tabel data ruang kerja.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
properties.archiveRetentionInDays	integer (int32)	Retensi arsip data tabel dalam beberapa hari. Dihitung sebagai (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Tanda waktu paket tabel terakhir diubah (UTC).
properties.plan	TablePlanEnum	Instruksikan sistem cara menangani dan mengisi daya log yang diserap ke tabel ini.
properties.provisioningState	ProvisioningStateEnum	Status provisi tabel saat ini. Jika diatur ke 'memperbarui', menunjukkan kunci sumber daya karena operasi yang sedang berlangsung, melarang pembaruan apa pun ke tabel hingga operasi yang sedang berlangsung disimpulkan.
properties.restoredLogs	RestoredLogs	Parameter operasi pemulihan yang memulai tabel ini.
properties.resultStatistics	ResultStatistics	Cari statistik eksekusi pekerjaan.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	Retensi tabel dalam hari, antara 4 dan 730. Mengatur properti ini ke -1 akan default ke retensi ruang kerja.
properties.retentionInDaysAsDefault	boolean	True - Nilai berasal dari retensi ruang kerja dalam hari, False - Spesifik pelanggan.
properties.schema	Schema	Skema tabel.
properties.searchResults	SearchResults	Parameter pekerjaan pencarian yang memulai tabel ini.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Total retensi tabel dalam hari, antara 4 dan 4383. Mengatur properti ini ke -1 akan default ke retensi tabel.
properties.totalRetentionInDaysAsDefault	boolean	True - Nilai berasal dari retensi dalam hari, False - Spesifik pelanggan.
systemData	systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

TablePlanEnum

Enumeration

Instruksikan sistem cara menangani dan mengisi daya log yang diserap ke tabel ini.

Nilai	Deskripsi
Analytics	Log yang memungkinkan pemantauan dan analitik.
Basic	Log yang disesuaikan untuk mendukung log verbose bernilai rendah volume tinggi.

TableSubTypeEnum

Enumeration

Subjenis menjelaskan API apa yang dapat digunakan untuk berinteraksi dengan tabel, dan fitur apa yang tersedia terhadapnya.

Nilai	Deskripsi
Any	Subjenis default yang membuat tabel bawaan.
Classic	Menunjukkan tabel yang dibuat melalui API Pengumpul Data atau dengan fitur log kustom agen MMA, atau tabel apa pun yang membuat Bidang Kustom.
DataCollectionRuleBased	Tabel yang memenuhi syarat untuk mengirim data ke dalamnya melalui salah satu cara yang didukung oleh Aturan Pengumpulan Data: API Titik Akhir Pengumpulan Data, transformasi waktu penyerapan, atau mekanisme lain yang disediakan oleh Aturan Pengumpulan Data

TableTypeEnum

Enumeration

Pembuat tabel.

Nilai	Deskripsi
CustomLog	Tabel log kustom.
Microsoft	Data standar yang dikumpulkan oleh Azure Monitor.
RestoredLogs	Data yang dipulihkan.
SearchResults	Data yang dikumpulkan oleh pekerjaan pencarian.

Bagikan melalui

Tables - Create Or Update

Parameter URI

Isi Permintaan

Respons

Keamanan

azure_auth

Cakupan

Contoh

TablesUpsert

Permintaan sampel

Respon sampel

Definisi

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

Sumber Daya Tambahan: