Share via

Tables - Get

  • Odwołanie
Service:
Log Analytics
API Version:
2022-10-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=2022-10-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.
workspaceName
 path True

string

Nazwa obszaru roboczego.

Regex pattern: ^[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

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

TablesGet

Sample Request

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

Sample Response

Status code:
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.