Tables - Get

Služba:

Log Analytics

Verze rozhraní API:

2023-09-01

Získá tabulku pracovního prostoru služby Log Analytics.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.
subscriptionId	path	True	string	ID cílového předplatného.
tableName	path	True	string	Název tabulky. Vzor regulárního výrazu: ^[A-Za-z0-9-_]+$
workspaceName	path	True	string	Název pracovního prostoru. Vzor regulárního výrazu: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	Table	Definice odpovědi OK.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

TablesGet

Ukázkový požadavek

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH?api-version=2023-09-01

Ukázková odpověď

Stavový kód:

200

{
  "systemData": {
    "createdBy": "00000000-0000-0000-0000-00000000000",
    "createdAt": "2020-02-03T04:05:06Z"
  },
  "properties": {
    "resultStatistics": {
      "progress": 75,
      "ingestedRecords": 5,
      "scannedGb": 23.5
    },
    "searchResults": {
      "query": "Heartbeat | where SourceSystem != '' | project SourceSystem",
      "description": "This table was created using a Search Job with the following query: 'Heartbeat | where SourceSystem != '' | project SourceSystem'.",
      "limit": 1000,
      "startSearchTime": "2020-02-03T04:05:06Z",
      "endSearchTime": "2020-02-02T04:05:06Z",
      "sourceTable": "Heartbeat"
    },
    "schema": {
      "name": "table1_SRCH",
      "tableSubType": "DataCollectionRuleBased",
      "tableType": "SearchResults",
      "displayName": null,
      "description": null,
      "columns": [],
      "standardColumns": [
        {
          "isHidden": false,
          "name": "TenantId",
          "type": "guid",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "name": "SourceSystem",
          "type": "string",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "name": "MG",
          "type": "guid",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "name": "ManagementGroupName",
          "type": "string",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "name": "TimeGenerated",
          "type": "dateTime",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "name": "Computer",
          "type": "string",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        },
        {
          "isHidden": false,
          "name": "RawData",
          "type": "string",
          "dataTypeHint": null,
          "displayName": null,
          "description": null,
          "isDefaultDisplay": false
        }
      ],
      "categories": null,
      "labels": null,
      "source": null,
      "solutions": [
        "LogManagement"
      ]
    },
    "provisioningState": "InProgress",
    "retentionInDays": 50,
    "totalRetentionInDays": 50,
    "archiveRetentionInDays": 0,
    "retentionInDaysAsDefault": false,
    "totalRetentionInDaysAsDefault": true,
    "plan": "Analytics"
  },
  "id": "/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685/tables/table1_SRCH",
  "name": "table1_SRCH"
}

Definice

Name	Description
Column	Sloupec tabulky.
ColumnDataTypeHintEnum	Logická nápověda pro datový typ 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, označuje zámek prostředku z důvodu probíhající operace, která zakazuje jakoukoli aktualizaci tabulky, dokud se neukončí probíhající operace.
RestoredLogs	Parametry obnovení.
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	Instruujte systém, jak zpracovat a účtovat protokoly ingestované 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

Sloupec tabulky.

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

ColumnDataTypeHintEnum

Logická nápověda pro datový typ sloupce.

Name	Typ	Description
armPath	string	Cesta k Modelu prostředků Azure (ARM): /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ...
guid	string	Standardní 128bitový identifikátor GUID za standardním tvarem xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx
ip	string	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	string	Ř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

Datový typ sloupce.

Name	Typ	Description
boolean	string
dateTime	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string

createdByType

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

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

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

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

ErrorDetail

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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ProvisioningStateEnum

Aktuální stav zřizování tabulky. Pokud je nastavená hodnota aktualizace, označuje zámek prostředku z důvodu probíhající operace, která zakazuje jakoukoli aktualizaci tabulky, dokud se neukončí probíhající operace.

Name	Typ	Description
Deleting	string	Stav tabulky se odstraňuje.
InProgress	string	Schéma tabulky je stabilní a data tabulky se aktualizují beze změn.
Succeeded	string	Stav tabulky je stabilní a beze změn se tabulka odemkne a otevře se pro nové aktualizace.
Updating	string	Schéma tabulky se stále sestavuje a aktualizuje. Tabulka je nyní uzamčena pro případné změny až do dokončení postupu.

RestoredLogs

Parametry obnovení.

Name	Typ	Description
azureAsyncOperationId	string	ID asynchronní operace tabulky výsledků hledání
endRestoreTime	string	Časové razítko ukončení obnovení do (UTC)
sourceTable	string	Tabulka, ze které chcete obnovit data.
startRestoreTime	string	Časové razítko, od které se má spustit obnovení (UTC).

ResultStatistics

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

Name	Typ	Description
ingestedRecords	integer	Počet řádků vrácených úlohou vyhledávání
progress	number	Procento dokončení úlohy hledání
scannedGb	number	Úloha hledání: Množství naskenovaných dat.

Schema

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

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

Name	Typ	Description
azureAsyncOperationId	string	ID asynchronní operace tabulky výsledků hledání
description	string	Popis úlohy hledání.
endSearchTime	string	Časové razítko pro ukončení hledání do (UTC)
limit	integer	Omezte úlohu vyhledávání tak, aby vracela až zadaný počet řádků.
query	string	Dotaz na úlohu vyhledávání
sourceTable	string	Tabulka použitá v úloze vyhledávání.
startSearchTime	string	Časové razítko pro spuštění vyhledávání od (UTC)

SourceEnum

Tvůrce tabulky.

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

systemData

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

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

Table

Definice tabulky dat pracovního prostoru

Name	Typ	Description
id	string	Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}
name	string	Název prostředku
properties.archiveRetentionInDays	integer	Uchovávání dat v archivu tabulek ve dnech Vypočteno jako (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Časové razítko plánu tabulky se naposledy změnilo (UTC).
properties.plan	TablePlanEnum	Instruujte systém, jak zpracovat a účtovat protokoly ingestované do této tabulky.
properties.provisioningState	ProvisioningStateEnum	Aktuální stav zřizování tabulky. Pokud je nastavená hodnota aktualizace, označuje zámek prostředku z důvodu probíhající operace, která zakazuje jakoukoli aktualizaci tabulky, dokud se neukončí 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	Uchovávání tabulek ve dnech mezi 4 a 730. Nastavením této vlastnosti na hodnotu -1 se ve výchozím nastavení použije uchovávání pracovního prostoru.
properties.retentionInDaysAsDefault	boolean	True – Hodnota pochází z uchovávání pracovního prostoru 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	Celková doba uchování v tabulce ve dnech mezi 4 a 4383. Nastavením této vlastnosti na hodnotu -1 se ve výchozím nastavení použije uchovávání tabulek.
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říklad Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

TablePlanEnum

Instruujte systém, jak zpracovat a účtovat protokoly ingestované do této tabulky.

Name	Typ	Description
Analytics	string	Protokoly, které umožňují monitorování a analýzy.
Basic	string	Protokoly, které jsou upravené tak, aby podporovaly velké objemy podrobných protokolů s nízkou hodnotou.

TableSubTypeEnum

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

Name	Typ	Description
Any	string	Výchozí podtyp, pomocí kterého se vytvářejí předdefinované tabulky.
Classic	string	Označuje tabulku vytvořenou prostřednictvím rozhraní API kolektoru dat, pomocí funkce vlastních protokolů agenta MMA nebo jakoukoli tabulku, pro kterou byla vytvořena vlastní pole.
DataCollectionRuleBased	string	Tabulka, která má nárok na odesílání dat prostřednictvím některého ze 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

Tvůrce tabulky.

Name	Typ	Description
CustomLog	string	Vlastní tabulka protokolů.
Microsoft	string	Standardní data shromažďovaná službou Azure Monitor.
RestoredLogs	string	Obnovená data.
SearchResults	string	Data shromážděná úlohou vyhledávání.