Tables - Create Or Update

Reference

Služba:: Log Analytics

Verze rozhraní API:: 2025-02-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-02-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	Uchování tabulky 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ů.
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 se ve výchozím nastavení nastaví uchovávání tabulek.

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

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", značí zámek prostředků kvůli probíhající operaci a vynutí všechny aktualizace v tabulce, dokud nedojde k ukončení probíhající operace.
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 tabulky dat 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 je možné použít k interakci s tabulkou a jaké funkce jsou 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	Zobrazuje se ve výchozím nastavení.
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
armPath	Cesta modelu prostředků Azure (ARM): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	Standardní 128bitový identifikátor GUID za standardním obrazcem xxxxxxxx-xxxx-xxxx-xxxxxxxx
ip	Standardní IP adresa V4/V6 za standardním tvarem x.x.x.x/y:y:y:y:y:y:y:y:y:y:y
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

ColumnTypeEnum

Výčet

Datový typ sloupce

Hodnota	Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Výčet

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

Hodnota	Description
Application
Key
ManagedIdentity
User

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", značí zámek prostředků kvůli probíhající operaci a vynutí všechny aktualizace v tabulce, dokud nedojde k ukončení probíhající operace.

Hodnota	Description
Deleting	Stav tabulky se odstraňuje.
InProgress	Schéma tabulky je stabilní a beze změn se data tabulky aktualizují.
Succeeded	Stav tabulky je stabilní a bez změn, tabulka se odemkne a otevře pro nové aktualizace.
Updating	Schéma tabulky se stále sestavuje a aktualizuje, tabulka je nyní uzamčena pro všechny změny, dokud se postup nedokončí.

RestoredLogs

Objekt

Obnovte parametry.

Name	Typ	Description
azureAsyncOperationId	string	ID asynchronní operace v tabulce výsledků hledání
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ů vrácených úlohou vyhledávání
progress	number multipleOf: 0.01	Procento dokončení úlohy hledání
scannedGb	number multipleOf: 0.01	Úloha hledání: 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 tabulky
name	string	Název tabulky
solutions	string[]	Seznam řešení, ke kterým je tabulka přidružená
source	SourceEnum	Tvůrce tabulky.
standardColumns	Column[]	Seznam standardních sloupců tabulky
tableSubType	TableSubTypeEnum	Podtyp popisuje, jaká rozhraní API je možné použít k interakci s tabulkou a jaké funkce jsou k dispozici.
tableType	TableTypeEnum	Tvůrce tabulky.

SearchResults

Objekt

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

Name	Typ	Description
azureAsyncOperationId	string	ID asynchronní operace v tabulce výsledků hledání
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á ve vyhledávací úloze.
startSearchTime	string (date-time)	Časové razítko pro zahájení hledání od (UTC)

SourceEnum

Výčet

Tvůrce tabulky.

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

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 tabulky dat 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)	Uchování archivu dat tabulky ve dnech. Vypočítáno jako (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Časové razítko, které plán tabulky naposledy upravil (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", značí zámek prostředků kvůli probíhající operaci a vynutí všechny aktualizace v tabulce, dokud nedojde k ukončení probíhající operace.
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	Uchování tabulky 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ů.
properties.retentionInDaysAsDefault	boolean	True – Hodnota pochází z uchovávání pracovních prostorů ve dnech, Nepravda – Konkrétní zákazník.
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 se ve výchozím nastavení nastaví uchovávání tabulek.
properties.totalRetentionInDaysAsDefault	boolean	True – Hodnota pochází z uchovávání ve dnech, False – Konkrétní zákazník.
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
type	string	Typ prostředku. Například 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
Analytics	Protokoly, které umožňují monitorování a analýzu
Basic	Protokoly upravené tak, aby podporovaly podrobné protokoly s nízkou hodnotou velkého objemu.

TableSubTypeEnum

Výčet

Podtyp popisuje, jaká rozhraní API je možné použít k interakci s tabulkou a jaké funkce jsou k dispozici.

Hodnota	Description
Any	Výchozí podtyp, pomocí kterého se vytvoří předdefinované tabulky.
Classic	Označuje tabulku vytvořenou prostřednictvím rozhraní API kolektoru dat nebo pomocí funkce vlastních protokolů agenta MMA nebo jakékoli tabulky, pro kterou byla vytvořena vlastní pole.
DataCollectionRuleBased	Tabulka, která má nárok na odeslání dat prostřednictvím kteréhokoli z prostředků podporovaných pravidly shromažďování dat: rozhraní API koncového bodu shromažďování dat, transformace doby příjmu dat nebo jakýkoli jiný mechanismus poskytovaný pravidly shromažďování dat

TableTypeEnum

Výčet

Tvůrce tabulky.

Hodnota	Description
CustomLog	Vlastní tabulka protokolů
Microsoft	Standardní data shromážděná službou Azure Monitor
RestoredLogs	Obnovená data
SearchResults	Data shromážděná úlohou vyhledávání

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

Další materiály