Tables - Get

Usługa:

Log Analytics

Wersja interfejsu API:

2023-09-01

Pobiera tabelę obszaru roboczego usługi Log Analytics.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
subscriptionId	path	True	string	Identyfikator subskrypcji docelowej.
tableName	path	True	string	Nazwa tabeli. Wzorzec wyrażenia regularnego: ^[A-Za-z0-9-_]+$
workspaceName	path	True	string	Nazwa obszaru roboczego. Wzorzec wyrażenia regularnego: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Table	Definicja odpowiedzi OK.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

TablesGet

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Definicje

Nazwa	Opis
Column	Kolumna tabeli.
ColumnDataTypeHintEnum	Wskazówka logiczna typu danych kolumny.
ColumnTypeEnum	Typ danych kolumny.
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ProvisioningStateEnum	Bieżący stan aprowizacji tabeli. Jeśli ustawiono wartość "aktualizowanie", wskazuje blokadę zasobu z powodu trwającej operacji, zabraniając żadnej aktualizacji tabeli do momentu zakończenia trwającej operacji.
RestoredLogs	Parametry przywracania.
ResultStatistics	Statystyki wykonywania zadania wyszukiwania.
Schema	Schemat tabeli.
SearchResults	Parametry zadania wyszukiwania, które zainicjowały tę tabelę.
SourceEnum	Twórca tabeli.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Table	Definicja tabeli danych obszaru roboczego.
TablePlanEnum	Poinstruuj system, jak obsługiwać i ładować dzienniki pozyskane do tej tabeli.
TableSubTypeEnum	Podtyp opisuje interfejsy API, których można użyć do interakcji z tabelą i jakie funkcje są dostępne dla niej.
TableTypeEnum	Twórca tabeli.

Column

Kolumna tabeli.

Nazwa	Typ	Opis
dataTypeHint	ColumnDataTypeHintEnum	Wskazówka logiczna typu danych kolumny.
description	string	Opis kolumny.
displayName	string	Nazwa wyświetlana kolumny.
isDefaultDisplay	boolean	Jest domyślnie wyświetlany.
isHidden	boolean	Jest ukryta kolumna.
name	string	Nazwa kolumny.
type	ColumnTypeEnum	Typ danych kolumny.

ColumnDataTypeHintEnum

Wskazówka logiczna typu danych kolumny.

Nazwa	Typ	Opis
armPath	string	Ścieżka modelu zasobów platformy Azure (ARM): /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ...
guid	string	Standardowy 128-bitowy identyfikator GUID zgodnie ze standardowym kształtem xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ip	string	Standardowy adres IP V4/V6 po standardowym kształcie, x.x.x.x/y:y:y:y:y:y:y:y:y:y:y
uri	string	Ciąg zgodny ze wzorcem identyfikatora URI, na przykład scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment

ColumnTypeEnum

Typ danych kolumny.

Nazwa	Typ	Opis
boolean	string
dateTime	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa	Typ	Opis
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt error.

ProvisioningStateEnum

Bieżący stan aprowizacji tabeli. Jeśli ustawiono wartość "aktualizowanie", wskazuje blokadę zasobu z powodu trwającej operacji, zabraniając żadnej aktualizacji tabeli do momentu zakończenia trwającej operacji.

Nazwa	Typ	Opis
Deleting	string	Stan tabeli jest usuwany.
InProgress	string	Schemat tabeli jest stabilny i bez zmian, dane tabeli są aktualizowane.
Succeeded	string	Stan tabeli jest stabilny i bez zmian, tabela jest odblokowana i otwarta dla nowych aktualizacji.
Updating	string	Schemat tabeli jest nadal kompilowany i aktualizowany. Tabela jest obecnie zablokowana dla wszelkich zmian do momentu ukończenia procedury.

RestoredLogs

Parametry przywracania.

Nazwa	Typ	Opis
azureAsyncOperationId	string	Identyfikator operacji asynchronicznego tabeli wyników wyszukiwania.
endRestoreTime	string	Sygnatura czasowa zakończenia przywracania o (UTC).
sourceTable	string	Tabela do przywrócenia danych z.
startRestoreTime	string	Sygnatura czasowa rozpoczęcia przywracania z (UTC).

ResultStatistics

Statystyki wykonywania zadania wyszukiwania.

Nazwa	Typ	Opis
ingestedRecords	integer	Liczba wierszy zwróconych przez zadanie wyszukiwania.
progress	number	Procent ukończenia zadania wyszukiwania.
scannedGb	number	Zadanie wyszukiwania: ilość zeskanowanych danych.

Schema

Schemat tabeli.

Nazwa	Typ	Opis
categories	string[]	Kategoria tabeli.
columns	Column[]	Lista kolumn niestandardowych tabeli.
description	string	Opis tabeli.
displayName	string	Nazwa wyświetlana tabeli.
labels	string[]	Etykiety tabel.
name	string	Nazwa tabeli.
solutions	string[]	Lista rozwiązań, z których tabela jest powiązana
source	SourceEnum	Twórca tabeli.
standardColumns	Column[]	Lista kolumn standardowych tabeli.
tableSubType	TableSubTypeEnum	Podtyp opisuje interfejsy API, których można użyć do interakcji z tabelą i jakie funkcje są dostępne dla niej.
tableType	TableTypeEnum	Twórca tabeli.

SearchResults

Parametry zadania wyszukiwania, które zainicjowały tę tabelę.

Nazwa	Typ	Opis
azureAsyncOperationId	string	Identyfikator operacji asynchronicznego tabeli wyników wyszukiwania.
description	string	Opis zadania wyszukiwania.
endSearchTime	string	Sygnatura czasowa zakończenia wyszukiwania według (UTC)
limit	integer	Ogranicz zadanie wyszukiwania, aby zwrócić maksymalnie określoną liczbę wierszy.
query	string	Kwerenda zadania wyszukiwania.
sourceTable	string	Tabela używana w zadaniu wyszukiwania.
startSearchTime	string	Sygnatura czasowa rozpoczęcia wyszukiwania od (UTC)

SourceEnum

Twórca tabeli.

Nazwa	Typ	Opis
customer	string	Tabele utworzone przez właściciela obszaru roboczego i znalezione tylko w tym obszarze roboczym.
microsoft	string	Tabele aprowidowane przez system, zbierane za pośrednictwem ustawień diagnostycznych, agentów lub innych standardowych metod zbierania danych.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobów (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string	Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

Table

Definicja tabeli danych obszaru roboczego.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.archiveRetentionInDays	integer	Przechowywanie archiwum danych tabeli w dniach. Obliczane jako (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Sygnatura czasowa planu tabeli została ostatnio zmodyfikowana (UTC).
properties.plan	TablePlanEnum	Poinstruuj system, jak obsługiwać i ładować dzienniki pozyskane do tej tabeli.
properties.provisioningState	ProvisioningStateEnum	Bieżący stan aprowizacji tabeli. Jeśli ustawiono wartość "aktualizowanie", wskazuje blokadę zasobu z powodu trwającej operacji, zabraniając żadnej aktualizacji tabeli do momentu zakończenia trwającej operacji.
properties.restoredLogs	RestoredLogs	Parametry operacji przywracania, która zainicjowała tę tabelę.
properties.resultStatistics	ResultStatistics	Statystyki wykonywania zadania wyszukiwania.
properties.retentionInDays	integer	Przechowywanie tabeli w dniach z zakresu od 4 do 730. Ustawienie tej właściwości na -1 spowoduje domyślne ustawienie przechowywania obszaru roboczego.
properties.retentionInDaysAsDefault	boolean	True — wartość pochodzi z okresu przechowywania obszaru roboczego w dniach, Fałsz — specyficzne dla klienta.
properties.schema	Schema	Schemat tabeli.
properties.searchResults	SearchResults	Parametry zadania wyszukiwania, które zainicjowały tę tabelę.
properties.totalRetentionInDays	integer	Łączny okres przechowywania tabeli w dniach z zakresu od 4 do 4383. Ustawienie tej właściwości na -1 spowoduje domyślne ustawienie przechowywania tabeli.
properties.totalRetentionInDaysAsDefault	boolean	True — wartość pochodzi z okresu przechowywania w dniach, Fałsz — specyficzne dla klienta.
systemData	systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

TablePlanEnum

Poinstruuj system, jak obsługiwać i ładować dzienniki pozyskane do tej tabeli.

Nazwa	Typ	Opis
Analytics	string	Dzienniki, które umożliwiają monitorowanie i analizę.
Basic	string	Dzienniki dostosowane do obsługi pełnych dzienników o dużej wartości.

TableSubTypeEnum

Podtyp opisuje interfejsy API, których można użyć do interakcji z tabelą i jakie funkcje są dostępne dla niej.

Nazwa	Typ	Opis
Any	string	Domyślny podtyp, za pomocą którego tworzone są wbudowane tabele.
Classic	string	Wskazuje tabelę utworzoną za pośrednictwem interfejsu API modułu zbierającego dane lub z funkcją dzienników niestandardowych agenta MMA lub dowolną tabelą, względem której utworzono pola niestandardowe.
DataCollectionRuleBased	string	Tabela, która kwalifikuje się do wysłania do niej danych za pośrednictwem dowolnych środków obsługiwanych przez reguły zbierania danych: interfejs API punktu końcowego zbierania danych, przekształcenia czasu pozyskiwania lub dowolny inny mechanizm zapewniany przez reguły zbierania danych

TableTypeEnum

Twórca tabeli.

Nazwa	Typ	Opis
CustomLog	string	Niestandardowa tabela dziennika.
Microsoft	string	Standardowe dane zbierane przez usługę Azure Monitor.
RestoredLogs	string	Przywrócone dane.
SearchResults	string	Dane zbierane przez zadanie wyszukiwania.