Tables - Update
Log Analytics-munkaterület táblázatának frissítése.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2022-10-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket. |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
table
|
path | True |
string |
A tábla neve. |
workspace
|
path | True |
string |
A munkaterület neve. Regex pattern: |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Kérelem törzse
Name | Típus | Description |
---|---|---|
properties.plan |
Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába betöltött naplókat. |
|
properties.restoredLogs |
A táblát kezdeményező visszaállítási művelet paraméterei. |
|
properties.retentionInDays |
integer |
A tábla megőrzési ideje napokban, 4 és 730 között. Ha ezt a tulajdonságot -1 értékre állítja, az alapértelmezés szerint a munkaterület adatmegőrzési értéke lesz. |
properties.schema |
Táblaséma. |
|
properties.searchResults |
A táblát kezdeményező keresési feladat paraméterei. |
|
properties.totalRetentionInDays |
integer |
A tábla teljes adatmegőrzése napokban, 4 és 4383 között. Ha ezt a tulajdonságot -1 értékre állítja, az alapértelmezés szerint táblamegőrzés lesz. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK válaszdefiníció. |
|
202 Accepted |
Elfogadott válaszdefiníció (hosszú ideig futó művelet). |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
TablesUpsert
Sample Request
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/AzureNetworkFlow?api-version=2022-10-01
{
"properties": {
"schema": {
"name": "AzureNetworkFlow",
"columns": [
{
"name": "MyNewColumn",
"type": "guid"
}
]
},
"retentionInDays": 45,
"totalRetentionInDays": 70
}
}
Sample Response
{
"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"
}
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=2022-10-01
Definíciók
Name | Description |
---|---|
Column |
Táblaoszlop. |
Column |
Az oszlop adattípusának logikai tippje. |
Column |
Oszlop adattípusa. |
created |
Az erőforrást létrehozó identitás típusa. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Provisioning |
A tábla jelenlegi kiépítési állapota. Ha a "frissítés" értékre van állítva, a folyamatban lévő művelet miatt egy erőforrás-zárolást jelez, amely megtiltja a tábla frissítését a folyamatban lévő művelet befejezéséig. |
Restored |
Paraméterek visszaállítása. |
Result |
Keresési feladatok végrehajtási statisztikái. |
Schema |
Tábla sémája. |
Search |
A táblát kezdeményező keresési feladat paraméterei. |
Source |
Tábla létrehozója. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
Table |
Munkaterület adattáblájának definíciója. |
Table |
Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába betöltött naplókat. |
Table |
Az altípus azt írja le, hogy milyen API-k használhatók a táblával való interakcióhoz, és milyen funkciók érhetők el rajta. |
Table |
Tábla létrehozója. |
Column
Táblaoszlop.
Name | Típus | Description |
---|---|---|
dataTypeHint |
Az oszlop adattípusának logikai tippje. |
|
description |
string |
Oszlop leírása. |
displayName |
string |
Oszlop megjelenítendő neve. |
isDefaultDisplay |
boolean |
Alapértelmezés szerint megjelenik. |
isHidden |
boolean |
Az oszlop rejtett. |
name |
string |
Oszlop neve. |
type |
Oszlop adattípusa. |
ColumnDataTypeHintEnum
Az oszlop adattípusának logikai tippje.
Name | Típus | Description |
---|---|---|
armPath |
string |
Egy Azure-erőforrásmodell (ARM) elérési útja: /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ... |
guid |
string |
Standard 128 bites GUID a szabványos alakzatot követve: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
ip |
string |
Standard V4/V6 IP-cím a szabványos alakzatot követve, x.x.x.x/y:y:y:y:y:y:y:y:y |
uri |
string |
Egy URI mintájának megfelelő sztring, például scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment |
ColumnTypeEnum
Oszlop adattípusa.
Name | Típus | Description |
---|---|---|
boolean |
string |
|
dateTime |
string |
|
dynamic |
string |
|
guid |
string |
|
int |
string |
|
long |
string |
|
real |
string |
|
string |
string |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
ProvisioningStateEnum
A tábla jelenlegi kiépítési állapota. Ha a "frissítés" értékre van állítva, a folyamatban lévő művelet miatt egy erőforrás-zárolást jelez, amely megtiltja a tábla frissítését a folyamatban lévő művelet befejezéséig.
Name | Típus | Description |
---|---|---|
Deleting |
string |
A tábla állapota törölve van. |
InProgress |
string |
A táblaséma stabil, és módosítások nélkül a táblaadatok frissítése folyamatban van. |
Succeeded |
string |
A tábla állapota stabil, és módosítások nélkül, a tábla feloldva van, és meg van nyitva az új frissítésekhez. |
Updating |
string |
A táblaséma létrehozása és frissítése folyamatban van, a tábla jelenleg zárolva van a módosításokhoz, amíg az eljárás befejeződik. |
RestoredLogs
Paraméterek visszaállítása.
Name | Típus | Description |
---|---|---|
azureAsyncOperationId |
string |
Keresési eredmények tábla aszinkron műveletazonosítója. |
endRestoreTime |
string |
A visszaállítás befejezésének időbélyege (UTC). |
sourceTable |
string |
A tábla, amelyből adatokat állíthat vissza. |
startRestoreTime |
string |
A visszaállítás indításának időbélyege (UTC). |
ResultStatistics
Keresési feladatok végrehajtási statisztikái.
Name | Típus | Description |
---|---|---|
ingestedRecords |
integer |
A keresési feladat által visszaadott sorok száma. |
progress |
number |
Keresési feladat befejezési százaléka. |
scannedGb |
number |
Keresési feladat: A beolvasott adatok mennyisége. |
Schema
Tábla sémája.
Name | Típus | Description |
---|---|---|
categories |
string[] |
Táblakategória. |
columns |
Column[] |
Egyéni táblázatoszlopok listája. |
description |
string |
Táblázat leírása. |
displayName |
string |
Tábla megjelenítendő neve. |
labels |
string[] |
Táblacímkék. |
name |
string |
Tábla neve. |
solutions |
string[] |
Azoknak a megoldásoknak a listája, amellyel a táblázat kapcsolódik |
source |
Tábla létrehozója. |
|
standardColumns |
Column[] |
A táblázat szabványos oszlopainak listája. |
tableSubType |
Az altípus azt írja le, hogy milyen API-k használhatók a táblával való interakcióhoz, és milyen funkciók érhetők el rajta. |
|
tableType |
Tábla létrehozója. |
SearchResults
A táblát kezdeményező keresési feladat paraméterei.
Name | Típus | Description |
---|---|---|
azureAsyncOperationId |
string |
Keresési eredmények tábla aszinkron műveletazonosítója. |
description |
string |
Keresési feladat leírása. |
endSearchTime |
string |
A keresés befejezésének időbélyege (UTC) |
limit |
integer |
Korlátozza a keresési feladatot a megadott számú sorra való visszatérésre. |
query |
string |
Keresési feladat lekérdezése. |
sourceTable |
string |
A keresési feladatban használt tábla. |
startSearchTime |
string |
A keresés indításának időbélyege (UTC) |
SourceEnum
Tábla létrehozója.
Name | Típus | Description |
---|---|---|
customer |
string |
A munkaterület tulajdonosa által létrehozott táblák, amelyeket csak ebben a munkaterületen talál. |
microsoft |
string |
A rendszer által kiépített táblák, amelyeket a diagnosztikai beállítások, az ügynökök vagy bármely más szabványos adatgyűjtési eszköz gyűjt. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az az identitás, amely legutóbb módosította az erőforrást. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
Table
Munkaterület adattáblájának definíciója.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Az erőforrás neve |
properties.archiveRetentionInDays |
integer |
A táblaadatok archiválási megőrzési ideje napokban. Számított érték (totalRetentionInDays-retentionInDays) |
properties.lastPlanModifiedDate |
string |
A táblacsomag időbélyege legutóbb módosult (UTC). |
properties.plan |
Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába betöltött naplókat. |
|
properties.provisioningState |
A tábla jelenlegi kiépítési állapota. Ha a "frissítés" értékre van állítva, a folyamatban lévő művelet miatt egy erőforrás-zárolást jelez, amely megtiltja a tábla frissítését a folyamatban lévő művelet befejezéséig. |
|
properties.restoredLogs |
A táblát kezdeményező visszaállítási művelet paraméterei. |
|
properties.resultStatistics |
Keresési feladatok végrehajtási statisztikái. |
|
properties.retentionInDays |
integer |
A tábla megőrzési ideje napokban, 4 és 730 között. Ha ezt a tulajdonságot -1 értékre állítja, az alapértelmezés szerint a munkaterület adatmegőrzési értéke lesz. |
properties.retentionInDaysAsDefault |
boolean |
Igaz – Az érték a munkaterület napokon belüli megőrzéséből származik, Hamis – Ügyfélspecifikus. |
properties.schema |
Táblaséma. |
|
properties.searchResults |
A táblát kezdeményező keresési feladat paraméterei. |
|
properties.totalRetentionInDays |
integer |
A tábla teljes adatmegőrzése napokban, 4 és 4383 között. Ha ezt a tulajdonságot -1 értékre állítja, az alapértelmezés szerint táblamegőrzés lesz. |
properties.totalRetentionInDaysAsDefault |
boolean |
Igaz – Az érték a napok megőrzéséből származik, Hamis – Ügyfélspecifikus. |
systemData |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
|
type |
string |
Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
TablePlanEnum
Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába betöltött naplókat.
Name | Típus | Description |
---|---|---|
Analytics |
string |
Figyelést és elemzést lehetővé tevő naplók. |
Basic |
string |
A nagy mennyiségű, alacsony értékű részletes naplók támogatásához igazított naplók. |
TableSubTypeEnum
Az altípus azt írja le, hogy milyen API-k használhatók a táblával való interakcióhoz, és milyen funkciók érhetők el rajta.
Name | Típus | Description |
---|---|---|
Any |
string |
Az alapértelmezett altípus, amellyel a beépített táblák létrejönnek. |
Classic |
string |
A Data Collector API-n vagy az MMA-ügynök egyéni naplók funkciójával létrehozott táblát, vagy bármely táblát jelöl, amelyhez egyéni mezőket hoztak létre. |
DataCollectionRuleBased |
string |
Egy tábla jogosult arra, hogy az adatgyűjtési szabályok által támogatott bármely eszközzel adatokat küldhessenek bele: az adatgyűjtési végpont API-ját, a betöltési idő átalakításait vagy az adatgyűjtési szabályok által biztosított bármely más mechanizmust |
TableTypeEnum
Tábla létrehozója.
Name | Típus | Description |
---|---|---|
CustomLog |
string |
Egyéni naplótábla. |
Microsoft |
string |
Az Azure Monitor által gyűjtött standard adatok. |
RestoredLogs |
string |
Visszaállított adatok. |
SearchResults |
string |
Keresési feladat által gyűjtött adatok. |