Tables - Create Or Update

Služba:: Log Analytics

Verze rozhraní API:: 2025-07-01

Aktualizujte nebo vytvořte tabulku pracovního prostoru služby Log Analytics.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Název tabulky.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Název pracovního prostoru.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties.plan	TablePlanEnum	Řekněte systému, jak zpracovat a účtovat protokoly přijaté do této tabulky.
properties.restoredLogs	RestoredLogs	Parametry operace obnovení, která iniciovala tuto tabulku.
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	V tabulce Analytics: tabulky Analytické uchovávání ve dnech, mezi 4 a 730. Nastavením této vlastnosti na -1 se ve výchozím nastavení nastaví uchovávání pracovních prostorů. V Základní a Pomocné tabulce: vlastnost pouze ke čtení.
properties.schema	Schema	Schéma tabulky
properties.searchResults	SearchResults	Parametry úlohy vyhledávání, která iniciovala tuto tabulku
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Celková doba uchování tabulky ve dnech mezi 4 a 4383. Nastavením této vlastnosti na -1 bude výchozí retentionInDays.

Odpovědi

Name	Typ	Description
200 OK	Table	Definice odpovědi OK.
202 Accepted		Přijatá definice odpovědi (dlouhotrvající operace).
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

TablesUpsert

Ukázkový požadavek

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/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
  }
}

Ukázková odpověď

Stavový kó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"
}

Stavový kó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-07-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-07-01

Definice

Name	Description
Column	Sloupec tabulky.
ColumnDataTypeHintEnum	Logický tip datového typu sloupce
ColumnTypeEnum	Datový typ sloupce
createdByType	Typ identity, která prostředek vytvořila.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ProvisioningStateEnum	Aktuální stav zřizování tabulky. Pokud je nastavená hodnota "aktualizace", znamená uzamčení zdroje z důvodu probíhající operace, která zakazuje jakoukoli aktualizaci tabulky, dokud není probíhající operace dokončena.
RestoredLogs	Obnovte parametry.
ResultStatistics	Statistika provádění úlohy vyhledávání
Schema	Schéma tabulky.
SearchResults	Parametry úlohy vyhledávání, která iniciovala tuto tabulku
SourceEnum	Tvůrce tabulky.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
Table	Definice datové tabulky pracovního prostoru.
TablePlanEnum	Řekněte systému, jak zpracovat a účtovat protokoly přijaté do této tabulky.
TableSubTypeEnum	Podtyp popisuje, jaká rozhraní API lze použít k interakci s tabulkou a jaké funkce jsou pro ni k dispozici.
TableTypeEnum	Tvůrce tabulky.

Column

Objekt

Sloupec tabulky.

Name	Typ	Description
dataTypeHint	ColumnDataTypeHintEnum	Logický tip datového typu sloupce
description	string	Popis sloupce
displayName	string	Zobrazovaný název sloupce
isDefaultDisplay	boolean	Ve výchozím nastavení se zobrazí.
isHidden	boolean	Je sloupec skrytý.
name	string	Název sloupce
type	ColumnTypeEnum	Datový typ sloupce

ColumnDataTypeHintEnum

Výčet

Logický tip datového typu sloupce

Hodnota	Description
uri	Řetězec, který odpovídá vzoru identifikátoru URI, například scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment
guid	Standardní 128bitový identifikátor GUID se standardním tvarem: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
armPath	Cesta k modelu prostředků Azure (ARM): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
ip	Standardní adresa IP V4/V6 odpovídající standardnímu tvaru, x.x.x.x/y:y:y:y:y:

ColumnTypeEnum

Výčet

Datový typ sloupce

Hodnota	Description
string
int
long
real
boolean
dateTime
guid
dynamic

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ProvisioningStateEnum

Výčet

Aktuální stav zřizování tabulky. Pokud je nastavená hodnota "aktualizace", znamená uzamčení zdroje z důvodu probíhající operace, která zakazuje jakoukoli aktualizaci tabulky, dokud není probíhající operace dokončena.

Hodnota	Description
Updating	Schéma tabulky se stále vytváří a aktualizuje, tabulka je v současné době uzamčena pro jakékoli změny, dokud nebude procedura dokončena.
InProgress	Schéma tabulky je stabilní a beze změn, data v tabulce se aktualizují.
Succeeded	Stav tabulky je stabilní a beze změn, tabulka je odemčená a otevřená pro nové aktualizace.
Deleting	Stav tabulky je odstraněn.

RestoredLogs

Objekt

Obnovte parametry.

Name	Typ	Description
azureAsyncOperationId	string	Tabulka výsledků hledání ID asynchronní operace.
endRestoreTime	string (date-time)	Časové razítko pro ukončení obnovení do (UTC).
sourceTable	string	Tabulka, ze které chcete obnovit data.
startRestoreTime	string (date-time)	Časové razítko pro spuštění obnovení od (UTC).

ResultStatistics

Objekt

Statistika provádění úlohy vyhledávání

Name	Typ	Description
ingestedRecords	integer (int32)	Počet řádků, které byly vráceny úlohou vyhledávání.
progress	number multipleOf: 0.01	Procento dokončení úlohy vyhledávání.
scannedGb	number multipleOf: 0.01	Vyhledávací úloha: Množství naskenovaných dat.

Schema

Objekt

Schéma tabulky.

Name	Typ	Description
categories	string[]	Kategorie tabulky.
columns	Column[]	Seznam vlastních sloupců tabulky
description	string	Popis tabulky
displayName	string	Zobrazovaný název tabulky
labels	string[]	Popisky tabulek.
name	string	Název tabulky
solutions	string[]	Seznam řešení, ke kterým je tabulka přidružena
source	SourceEnum	Tvůrce tabulky.
standardColumns	Column[]	Seznam standardních sloupců tabulky.
tableSubType	TableSubTypeEnum	Podtyp popisuje, jaká rozhraní API lze použít k interakci s tabulkou a jaké funkce jsou pro ni k dispozici.
tableType	TableTypeEnum	Tvůrce tabulky.

SearchResults

Objekt

Parametry úlohy vyhledávání, která iniciovala tuto tabulku

Name	Typ	Description
azureAsyncOperationId	string	Tabulka výsledků hledání ID asynchronní operace.
description	string	Popis úlohy hledání
endSearchTime	string (date-time)	Časové razítko pro ukončení hledání podle (UTC)
limit	integer (int32)	Omezte úlohu vyhledávání tak, aby se vrátila až na zadaný počet řádků.
query	string	Dotaz na úlohu vyhledávání
sourceTable	string	Tabulka použitá v úloze vyhledávání.
startSearchTime	string (date-time)	Časové razítko pro zahájení hledání od (UTC)

SourceEnum

Výčet

Tvůrce tabulky.

Hodnota	Description
microsoft	Tabulky poskytované systémem, jak jsou shromažďovány prostřednictvím nastavení diagnostiky, agentů nebo jiných standardních prostředků pro shromažďování dat.
customer	Tabulky vytvořené vlastníkem pracovního prostoru, které se nacházejí pouze v tomto pracovním prostoru.

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Table

Objekt

Definice datové tabulky pracovního prostoru.

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Název prostředku
properties.archiveRetentionInDays	integer (int32)	Tabulky jsou dlouhodobě uchovávány ve dnech. Vypočítá se jako (totalRetentionInDays-retentionInDays).
properties.lastPlanModifiedDate	string	Časové razítko, podle kterého byl plán tabulky naposledy změněn (UTC).
properties.plan	TablePlanEnum	Řekněte systému, jak zpracovat a účtovat protokoly přijaté do této tabulky.
properties.provisioningState	ProvisioningStateEnum	Aktuální stav zřizování tabulky. Pokud je nastavená hodnota "aktualizace", znamená uzamčení zdroje z důvodu probíhající operace, která zakazuje jakoukoli aktualizaci tabulky, dokud není probíhající operace dokončena.
properties.restoredLogs	RestoredLogs	Parametry operace obnovení, která iniciovala tuto tabulku.
properties.resultStatistics	ResultStatistics	Statistika provádění úlohy vyhledávání
properties.retentionInDays	integer (int32) minimum: 4 maximum: 730	V tabulce Analytics: tabulky Analytické uchovávání ve dnech, mezi 4 a 730. Nastavením této vlastnosti na -1 se ve výchozím nastavení nastaví uchovávání pracovních prostorů. V Základní a Pomocné tabulce: vlastnost pouze ke čtení.
properties.retentionInDaysAsDefault	boolean	True – Hodnota pochází z uchovávání pracovních prostorů ve dnech, False – specifické pro zákazníka.
properties.schema	Schema	Schéma tabulky
properties.searchResults	SearchResults	Parametry úlohy vyhledávání, která iniciovala tuto tabulku
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Celková doba uchování tabulky ve dnech mezi 4 a 4383. Nastavením této vlastnosti na -1 bude výchozí retentionInDays.
properties.totalRetentionInDaysAsDefault	boolean	True – Hodnota pochází z uchovávání ve dnech, False – specifické pro zákazníka.
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
type	string	Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

TablePlanEnum

Výčet

Řekněte systému, jak zpracovat a účtovat protokoly přijaté do této tabulky.

Hodnota	Description
Basic	Protokoly středního dotyku potřebné pro řešení problémů a reakci na incidenty.
Analytics	Protokoly s vysokou hodnotou používané pro nepřetržité monitorování, detekci v reálném čase a analýzu výkonu.
Auxiliary	Protokoly s nízkým dotykem, jako jsou podrobné protokoly, a data potřebná pro auditování a dodržování předpisů.

TableSubTypeEnum

Výčet

Podtyp popisuje, jaká rozhraní API lze použít k interakci s tabulkou a jaké funkce jsou pro ni k dispozici.

Hodnota	Description
Any	Výchozí podtyp, se kterým se vytvářejí vestavěné tabulky.
Classic	Označuje tabulku vytvořenou prostřednictvím rozhraní API kolekce dat nebo pomocí funkce vlastních protokolů agenta MMA nebo libovolnou tabulku, pro kterou byla vytvořena vlastní pole.
DataCollectionRuleBased	Tabulka, do které lze odesílat data pomocí libovolného prostředku podporovaného pravidly shromažďování dat: rozhraní API koncového bodu shromažďování dat, transformace doby příjmu dat nebo jakéhokoli jiného mechanismu poskytovaného pravidly shromažďování dat

TableTypeEnum

Výčet

Tvůrce tabulky.

Hodnota	Description
Microsoft	Standardní data shromažďovaná službou Azure Monitor.
CustomLog	Vlastní tabulka protokolu.
RestoredLogs	Obnovená data.
SearchResults	Data shromážděná vyhledávací úlohou.

Sdílet prostřednictvím

Tables - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

TablesUpsert

Ukázkový požadavek

Ukázková odpověď

Definice

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum