Tables - Create Or Update

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

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

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

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

TablesUpsert

Sample Request

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

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

Sample Response

{
  "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"
}
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=2022-10-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.