Tables - Update

Odwołanie

Usługa:: Log Analytics

Wersja interfejsu API:: 2025-02-01

Aktualizowanie tabeli obszaru roboczego usługi Log Analytics.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string minLength: 1	Identyfikator subskrypcji docelowej.
tableName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9-_]+$	Nazwa tabeli.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Nazwa obszaru roboczego.
api-version	query	True	string minLength: 1	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 (int32) minimum: 4 maximum: 730	Przechowywanie tabeli w dniach z zakresu od 4 do 730. Ustawienie tej właściwości na wartość -1 spowoduje ustawienie domyślnego przechowywania obszaru roboczego.
properties.schema	Schema	Schemat tabeli.
properties.searchResults	SearchResults	Parametry zadania wyszukiwania, które zainicjowały tę tabelę.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Łączny okres przechowywania tabeli wynosi od 4 do 4383. Ustawienie tej właściwości na wartość -1 spowoduje domyślne przechowywanie 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 protokołu 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

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

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

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 ze względu na bieżącą operację, zakazują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ł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żywać do interakcji z tabelą i jakie funkcje są dostępne dla niej.
TableTypeEnum	Twórca tabeli.

Column

Objekt

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	Czy kolumna jest ukryta.
name	string	Nazwa kolumny.
type	ColumnTypeEnum	Typ danych kolumny.

ColumnDataTypeHintEnum

Wyliczanie

Wskazówka logiczna typu danych kolumny.

Wartość	Opis
armPath	Ścieżka modelu zasobów platformy Azure (ARM): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid	Standardowy 128-bitowy identyfikator GUID po standardowym kształcie xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx
ip	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	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

Wyliczanie

Typ danych kolumny.

Wartość	Opis
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Wyliczanie

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

Wartość	Opis
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Objekt

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

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

ErrorDetail

Objekt

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

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ProvisioningStateEnum

Wyliczanie

Bieżący stan aprowizacji tabeli. Jeśli ustawiono wartość "aktualizowanie", wskazuje blokadę zasobu ze względu na bieżącą operację, zakazując każdej aktualizacji tabeli do momentu zakończenia trwającej operacji.

Wartość	Opis
Deleting	Stan tabeli jest usuwany.
InProgress	Schemat tabeli jest stabilny i bez zmian, dane tabeli są aktualizowane.
Succeeded	Stan tabeli jest stabilny i bez zmian, tabela jest odblokowana i otwarta dla nowych aktualizacji.
Updating	Schemat tabeli jest nadal kompilowany i aktualizowany, tabela jest obecnie zablokowana dla wszelkich zmian do momentu wykonania procedury.

RestoredLogs

Objekt

Przywróć parametry.

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

ResultStatistics

Objekt

Statystyki wykonywania zadań wyszukiwania.

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

Schema

Objekt

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żywać do interakcji z tabelą i jakie funkcje są dostępne dla niej.
tableType	TableTypeEnum	Twórca tabeli.

SearchResults

Objekt

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

Nazwa	Typ	Opis
azureAsyncOperationId	string	Identyfikator operacji asynchronicznych tabeli wyników wyszukiwania.
description	string	Opis zadania wyszukiwania.
endSearchTime	string (date-time)	Znacznik czasu zakończenia wyszukiwania według (UTC)
limit	integer (int32)	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 (date-time)	Znacznik czasu rozpoczęcia wyszukiwania z (UTC)

SourceEnum

Wyliczanie

Twórca tabeli.

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

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	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 (date-time)	Znacznik czasu 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

Objekt

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 (int32)	Przechowywanie archiwum danych tabeli w dniach. Obliczane jako (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate	string	Sygnatura czasowa ostatniej modyfikacji planu tabeli (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ę, zakazują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 (int32) minimum: 4 maximum: 730	Przechowywanie tabeli w dniach z zakresu od 4 do 730. Ustawienie tej właściwości na wartość -1 spowoduje ustawienie domyślnego przechowywania obszaru roboczego.
properties.retentionInDaysAsDefault	boolean	True — wartość pochodzi z przechowywania obszaru roboczego w dniach, False — specyficzne dla klienta.
properties.schema	Schema	Schemat tabeli.
properties.searchResults	SearchResults	Parametry zadania wyszukiwania, które zainicjowały tę tabelę.
properties.totalRetentionInDays	integer (int32) minimum: 4 maximum: 4383	Łączny okres przechowywania tabeli wynosi od 4 do 4383. Ustawienie tej właściwości na wartość -1 spowoduje domyślne przechowywanie tabeli.
properties.totalRetentionInDaysAsDefault	boolean	True — wartość pochodzi z okresu 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

Wyliczanie

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

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

TableSubTypeEnum

Wyliczanie

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

Wartość	Opis
Any	Domyślny podtyp, za pomocą którego tworzone są wbudowane tabele.
Classic	Wskazuje tabelę utworzoną za pomocą interfejsu API modułu zbierającego dane lub funkcję dzienników niestandardowych agenta MMA lub dowolną tabelę, dla której utworzono pola niestandardowe.
DataCollectionRuleBased	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

Wyliczanie

Twórca tabeli.

Wartość	Opis
CustomLog	Niestandardowa tabela dzienników.
Microsoft	Standardowe dane zbierane przez usługę Azure Monitor.
RestoredLogs	Przywrócone dane.
SearchResults	Dane zbierane przez zadanie wyszukiwania.

Udostępnij za pośrednictwem

Tables - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

TablesUpsert

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Column

ColumnDataTypeHintEnum

ColumnTypeEnum

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ProvisioningStateEnum

RestoredLogs

ResultStatistics

Schema

SearchResults

SourceEnum

systemData

Table

TablePlanEnum

TableSubTypeEnum

TableTypeEnum

Dodatkowe zasoby