Tables - Update

Referencia

Szolgáltatás:: Log Analytics

API-verzió:: 2025-02-01

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=2025-02-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	A tábla neve.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	A munkaterület neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
properties.plan	TablePlanEnum	Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába beszúrt naplókat.
properties.restoredLogs	RestoredLogs	A táblát kezdeményező visszaállítási művelet paraméterei.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	A tábla megőrzési ideje 4 és 730 között van. Ha ezt a tulajdonságot -1 értékre állítja, akkor alapértelmezés szerint a munkaterület megőrzési értéke lesz.
properties.schema	Schema	Táblaséma.
properties.searchResults	SearchResults	A táblát kezdeményező keresési feladat paraméterei.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	A tábla teljes megőrzési ideje napokban, 4 és 4383 között. Ha ezt a tulajdonságot a -1 értékre állítja, az alapértelmezés szerint táblamegtartás lesz.

Válaszok

Name	Típus	Description
200 OK	Table	OK válaszdefiníció.
202 Accepted		Elfogadott válaszdefiníció (hosszú ideig futó művelet).
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

TablesUpsert

Mintakérelem

HTTP

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

Mintaválasz

Állapotkód:: 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"
}

Állapotkód:: 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

Definíciók

Name	Description
Column	Táblázat oszlop.
ColumnDataTypeHintEnum	Oszlop adattípusának logikai tippje.
ColumnTypeEnum	Oszlop adattípusa.
createdByType	Az erőforrást létrehozó identitás típusa.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
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 erőforrás-zárolást jelez, és a folyamatban lévő művelet befejezéséig megtiltja a tábla frissítését.
RestoredLogs	Visszaállítási paraméterek.
ResultStatistics	Keresési feladatok végrehajtási statisztikái.
Schema	Táblázat sémája.
SearchResults	A táblát kezdeményező keresési feladat paraméterei.
SourceEnum	A tábla létrehozója.
systemData	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.
TablePlanEnum	Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába beszúrt naplókat.
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.
TableTypeEnum	A tábla létrehozója.

Column

Objektum

Táblázat oszlop.

Name	Típus	Description
dataTypeHint	ColumnDataTypeHintEnum	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	Rejtett oszlop.
name	string	Oszlop neve.
type	ColumnTypeEnum	Oszlop adattípusa.

ColumnDataTypeHintEnum

Enumerálás

Oszlop adattípusának logikai tippje.

Érték	Description
armPath	Egy Azure-erőforrásmodell (ARM) elérési útja: /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	Standard 128 bites GUID a standard alakzatot követve, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ip	Standard V4/V6 IP-cím a standard alakzatot követve, x.x.x.x/y:y:y:y:y:y:y:y:y
uri	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

Enumerálás

Oszlop adattípusa.

Érték	Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Enumerálás

Az erőforrást létrehozó identitás típusa.

Érték	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objektum

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

Objektum

A hiba részletei.

Name	Típus	Description
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

ProvisioningStateEnum

Enumerálás

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 erőforrás-zárolást jelez, és a folyamatban lévő művelet befejezéséig megtiltja a tábla frissítését.

Érték	Description
Deleting	A tábla állapota törölve van.
InProgress	A táblaséma stabil, és módosítások nélkül a táblaadatok frissítése folyamatban van.
Succeeded	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	A táblaséma még mindig épül és frissül, a tábla jelenleg zárolva van a módosításokhoz az eljárás végrehajtásáig.

RestoredLogs

Objektum

Visszaállítási paraméterek.

Name	Típus	Description
azureAsyncOperationId	string	Keresési eredmények tábla aszinkron műveletazonosítója.
endRestoreTime	string (date-time)	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 (date-time)	A visszaállítás indításának időbélyege (UTC).

ResultStatistics

Objektum

Keresési feladatok végrehajtási statisztikái.

Name	Típus	Description
ingestedRecords	integer (int32)	A keresési feladat által visszaadott sorok száma.
progress	number multipleOf: 0.01	Keresési feladatok befejezési százalékos aránya.
scannedGb	number multipleOf: 0.01	Keresési feladat: A beolvasott adatok mennyisége.

Schema

Objektum

Táblázat 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áblafeliratok.
name	string	Tábla neve.
solutions	string[]	Azoknak a megoldásoknak a listája, amellyel a táblázat kapcsolódik
source	SourceEnum	A tábla létrehozója.
standardColumns	Column[]	A táblázat szabványos oszlopainak listája.
tableSubType	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.
tableType	TableTypeEnum	A tábla létrehozója.

SearchResults

Objektum

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 (date-time)	A keresés befejezéséhez megadott időbélyeg (UTC)
limit	integer (int32)	A keresési feladat visszaadásának korlátozása megadott számú sorra.
query	string	Keresési feladat lekérdezése.
sourceTable	string	A keresési feladatban használt tábla.
startSearchTime	string (date-time)	A keresés indításának időbélyege (UTC)

SourceEnum

Enumerálás

A tábla létrehozója.

Érték	Description
customer	A munkaterület tulajdonosa által létrehozott táblák, és csak ebben a munkaterületen találhatók.
microsoft	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és során gyűjtenek össze.

systemData

Objektum

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name	Típus	Description
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

Table

Objektum

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 (int32)	A táblaadatok archiválása napok alatt. Számított érték (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	A táblázatterv utolsó módosításának időbélyege (UTC).
properties.plan	TablePlanEnum	Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába beszúrt naplókat.
properties.provisioningState	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 erőforrás-zárolást jelez, és a folyamatban lévő művelet befejezéséig megtiltja a tábla frissítését.
properties.restoredLogs	RestoredLogs	A táblát kezdeményező visszaállítási művelet paraméterei.
properties.resultStatistics	ResultStatistics	Keresési feladatok végrehajtási statisztikái.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	A tábla megőrzési ideje 4 és 730 között van. Ha ezt a tulajdonságot -1 értékre állítja, akkor alapértelmezés szerint a munkaterület megőrzési értéke lesz.
properties.retentionInDaysAsDefault	boolean	Igaz – Az érték a munkaterület napokban való megőrzéséből származik, hamis – Ügyfélspecifikus.
properties.schema	Schema	Táblaséma.
properties.searchResults	SearchResults	A táblát kezdeményező keresési feladat paraméterei.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	A tábla teljes megőrzési ideje napokban, 4 és 4383 között. Ha ezt a tulajdonságot a -1 értékre állítja, az alapértelmezés szerint táblamegtartás lesz.
properties.totalRetentionInDaysAsDefault	boolean	Igaz – Az érték a napok megőrzéséből származik, hamis – Ügyfélspecifikus.
systemData	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. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

TablePlanEnum

Enumerálás

Utasítsa a rendszert, hogyan kezelje és számítsa fel a táblába beszúrt naplókat.

Érték	Description
Analytics	Figyelést és elemzést lehetővé tevő naplók.
Basic	A nagy kötetű, alacsony értékű részletes naplók támogatásához igazított naplók.

TableSubTypeEnum

Enumerálás

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.

Érték	Description
Any	Az alapértelmezett altípus, amellyel a beépített táblák létrejönnek.
Classic	Az Adatgyűjtő API-val vagy az MMA-ügynök egyéni naplói 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	Egy tábla jogosult arra, hogy az adatgyűjtési szabályok által támogatott eszközök bármelyikén keresztül adatokat küldjön be: az adatgyűjtési végpont API-ja, a betöltési idő átalakításai vagy az adatgyűjtési szabályok által biztosított bármely más mechanizmus

TableTypeEnum

Enumerálás

A tábla létrehozója.

Érték	Description
CustomLog	Egyéni naplótábla.
Microsoft	Az Azure Monitor által gyűjtött standard adatok.
RestoredLogs	Visszaállított adatok.
SearchResults	Keresési feladat által gyűjtött adatok.

Megosztás a következőn keresztül:

Tables - Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

TablesUpsert

Mintakérelem

Mintaválasz

Definíciók

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

További források