Tables - Create Or Update

Usługa:

Log Analytics

Wersja interfejsu API:

2023-09-01

Aktualizowanie lub tworzenie tabeli obszaru roboczego usługi Log Analytics.

PUT 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.

Treść żądania

Nazwa	Typ	Opis
properties.plan	TablePlanEnum	Poinstruuj system, jak obsługiwać i ładować dzienniki pozyskane do tej tabeli.
properties.restoredLogs	RestoredLogs	Parametry operacji przywracania, która zainicjowała tę tabelę.
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.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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Table	Definicja odpowiedzi OK.
202 Accepted		Zaakceptowana definicja odpowiedzi (długotrwała operacja).
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

TablesUpsert

Przykładowe żądanie

HTTP

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

{
  "properties": {
    "schema": {
      "name": "AzureNetworkFlow",
      "columns": [
        {
          "name": "MyNewColumn",
          "type": "guid"
        }
      ]
    },
    "retentionInDays": 45,
    "totalRetentionInDays": 70
  }
}

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

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=2023-09-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=2023-09-01

Definicje

Nazwa	Opis
Column	Kolumna tabeli.
ColumnDataTypeHintEnum	Wskazówka logiczna typu danych typu 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 ze względu na bieżącą operację, zabraniając każdej aktualizacji tabeli do momentu zakończenia trwającej operacji.
RestoredLogs	Przywróć parametry.
ResultStatistics	Statystyki wykonywania zadań wyszukiwania.
Schema	Schemat tabeli.
SearchResults	Parametry zadania wyszukiwania, które zainicjowało 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, jakie interfejsy API mogą sł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 typu kolumny.
description	string	Opis kolumny.
displayName	string	Nazwa wyświetlana kolumny.
isDefaultDisplay	boolean	Jest domyślnie wyświetlany.
isHidden	boolean	Czy kolumna jest ukryta.
name	string	Nazwa kolumny.
type	ColumnTypeEnum	Typ danych kolumny.

ColumnDataTypeHintEnum

Wskazówka logiczna typu danych typu 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 błędu.

ProvisioningStateEnum

Bieżący stan aprowizacji tabeli. Jeśli ustawiono wartość "aktualizowanie", wskazuje blokadę zasobu ze względu na bieżącą operację, zabraniając każdej 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

Przywróć parametry.

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

ResultStatistics

Statystyki wykonywania zadań 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, jakie interfejsy API mogą sł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ło tę tabelę.

Nazwa	Typ	Opis
azureAsyncOperationId	string	Identyfikator operacji asynchronicznego tabeli wyników wyszukiwania.
description	string	Opis zadania wyszukiwania.
endSearchTime	string	Sygnatura czasowa kończąca wyszukiwanie według (UTC)
limit	integer	Ogranicz zadanie wyszukiwania, aby powrócić do określonej liczby wierszy.
query	string	Kwerenda zadania wyszukiwania.
sourceTable	string	Tabela używana w zadaniu wyszukiwania.
startSearchTime	string	Sygnatura czasowa do rozpoczęcia wyszukiwania z (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 środków zbierania danych.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string	Sygnatura czasowa tworzenia zasobu (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 ze względu na bieżącą operację, zabraniając każdej 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 zadań wyszukiwania.
properties.retentionInDays	integer	Przechowywanie tabeli w dniach 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 przechowywania obszaru roboczego w dniach, Fałsz — określony przez klienta.
properties.schema	Schema	Schemat tabeli.
properties.searchResults	SearchResults	Parametry zadania wyszukiwania, które zainicjowało 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 przechowywanie tabel.
properties.totalRetentionInDaysAsDefault	boolean	True — wartość pochodzi z przechowywania w dniach, False — 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, jakie interfejsy API mogą służyć do interakcji z tabelą i jakie funkcje są dostępne dla niej.

Nazwa	Typ	Opis
Any	string	Domyślny podtyp, z którym są tworzone wbudowane tabele.
Classic	string	Wskazuje tabelę utworzoną za pomocą 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 dowolnej metody obsługiwanej przez reguły zbierania danych: interfejs API punktu końcowego zbierania danych, przekształcenia czasu pozyskiwania lub dowolny inny mechanizm dostarczony przez reguły zbierania danych

TableTypeEnum

Twórca tabeli.

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