Delen via

Tables - Get

  • Referentie
Service:
Log Analytics
API-versie:
2025-02-01

Hiermee haalt u een Log Analytics-werkruimtetabel op.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId
 path True

string

minLength: 1

De id van het doelabonnement.
tableName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9-_]+$

De naam van de tabel.
workspaceName
 path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

De naam van de werkruimte.
api-version
 query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name Type Description
200 OK

Table

Ok-antwoorddefinitie.
Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

TablesGet

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
Column

Tabelkolom.
ColumnDataTypeHintEnum

Logische hint voor kolomgegevenstype.
ColumnTypeEnum

Kolomgegevenstype.
createdByType

Het type identiteit waarmee de resource is gemaakt.
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ProvisioningStateEnum

De huidige inrichtingsstatus van de tabel. Als deze optie is ingesteld op 'bijwerken', wordt een resourcevergrendeling aangegeven vanwege een lopende bewerking, waarbij een update naar de tabel wordt verboden totdat de lopende bewerking is voltooid.
RestoredLogs

Parameters herstellen.
ResultStatistics

Statistieken voor het uitvoeren van een zoektaak.
Schema

Het schema van de tabel.
SearchResults

Parameters van de zoektaak die deze tabel heeft gestart.
SourceEnum

De maker van de tabel.
systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
Table

Definitie van werkruimtegegevenstabel.
TablePlanEnum

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.
TableSubTypeEnum

In het subtype wordt beschreven welke API's kunnen worden gebruikt om te communiceren met de tabel en welke functies er tegen beschikbaar zijn.
TableTypeEnum

De maker van de tabel.

Column

Object

Tabelkolom.

Name Type Description
dataTypeHint

ColumnDataTypeHintEnum

Logische hint voor kolomgegevenstype.
description

string

Kolombeschrijving.
displayName

string

Weergavenaam van kolom.
isDefaultDisplay

boolean

Wordt standaard weergegeven.
isHidden

boolean

Is kolom verborgen.
name

string

Kolomnaam.
type

ColumnTypeEnum

Kolomgegevenstype.

ColumnDataTypeHintEnum

Inventarisatie

Logische hint voor kolomgegevenstype.

Waarde Description
armPath

Een ARM-pad (Azure Resource Model): /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}...
guid

Een standaard 128-bits GUID na de standaardvorm xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ip

Een standaard-V4/V6-IP-adres dat volgt op de standaardshape x.x.x/y:y:y:y:y:y:y:y
uri

Een tekenreeks die overeenkomt met het patroon van een URI, bijvoorbeeld scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment

ColumnTypeEnum

Inventarisatie

Kolomgegevenstype.

Waarde Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ProvisioningStateEnum

Inventarisatie

De huidige inrichtingsstatus van de tabel. Als deze optie is ingesteld op 'bijwerken', wordt een resourcevergrendeling aangegeven vanwege een lopende bewerking, waarbij een update naar de tabel wordt verboden totdat de lopende bewerking is voltooid.

Waarde Description
Deleting

Tabelstatus wordt verwijderd.
InProgress

Tabelschema is stabiel en zonder wijzigingen worden tabelgegevens bijgewerkt.
Succeeded

De tabelstatus is stabiel en zonder wijzigingen, de tabel wordt ontgrendeld en geopend voor nieuwe updates.
Updating

Tabelschema wordt nog steeds gebouwd en bijgewerkt. De tabel is momenteel vergrendeld voor wijzigingen totdat de procedure is uitgevoerd.

RestoredLogs

Object

Parameters herstellen.

Name Type Description
azureAsyncOperationId

string

Tabel asynchrone bewerkings-id voor zoekresultaten.
endRestoreTime

string (date-time)

De tijdstempel voor het beëindigen van de herstelbewerking door (UTC).
sourceTable

string

De tabel waaruit gegevens moeten worden hersteld.
startRestoreTime

string (date-time)

De tijdstempel voor het starten van de herstelbewerking vanaf (UTC).

ResultStatistics

Object

Statistieken voor het uitvoeren van een zoektaak.

Name Type Description
ingestedRecords

integer (int32)

Het aantal rijen dat door de zoektaak is geretourneerd.
progress

number

multipleOf: 0.01

Voltooiingspercentage van zoektaak.
scannedGb

number

multipleOf: 0.01

Zoektaak: Hoeveelheid gescande gegevens.

Schema

Object

Het schema van de tabel.

Name Type Description
categories

string[]

Tabelcategorie.
columns

Column[]

Een lijst met aangepaste tabelkolommen.
description

string

Tabelbeschrijving.
displayName

string

Weergavenaam van tabel.
labels

string[]

Tabellabels.
name

string

Tabelnaam.
solutions

string[]

Lijst met oplossingen waarmee de tabel is gekoppeld
source

SourceEnum

De maker van de tabel.
standardColumns

Column[]

Een lijst met tabelstandaardkolommen.
tableSubType

TableSubTypeEnum

In het subtype wordt beschreven welke API's kunnen worden gebruikt om te communiceren met de tabel en welke functies er tegen beschikbaar zijn.
tableType

TableTypeEnum

De maker van de tabel.

SearchResults

Object

Parameters van de zoektaak die deze tabel heeft gestart.

Name Type Description
azureAsyncOperationId

string

Tabel asynchrone bewerkings-id voor zoekresultaten.
description

string

Zoektaakbeschrijving.
endSearchTime

string (date-time)

De tijdstempel voor het beëindigen van de zoekopdracht op (UTC)
limit

integer (int32)

Beperk de zoektaak om maximaal het opgegeven aantal rijen te retourneren.
query

string

Zoektaakquery.
sourceTable

string

De tabel die in de zoektaak wordt gebruikt.
startSearchTime

string (date-time)

Het tijdstempel voor het starten van de zoekopdracht vanaf (UTC)

SourceEnum

Inventarisatie

De maker van de tabel.

Waarde Description
customer

Tabellen die zijn gemaakt door de eigenaar van de werkruimte en alleen gevonden in deze werkruimte.
microsoft

Tabellen die door het systeem zijn ingericht, zoals verzameld via diagnostische instellingen, agents of andere standaardgegevensverzameling.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).
createdBy

string

De identiteit waarmee de resource is gemaakt.
createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Table

Object

Definitie van werkruimtegegevenstabel.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

De naam van de resource
properties.archiveRetentionInDays

integer (int32)

De bewaarperiode van het tabelgegevensarchief in dagen. Berekend als (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate

string

De tijdstempel van het tabelplan is voor het laatst gewijzigd (UTC).
properties.plan

TablePlanEnum

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.
properties.provisioningState

ProvisioningStateEnum

De huidige inrichtingsstatus van de tabel. Als deze optie is ingesteld op 'bijwerken', wordt een resourcevergrendeling aangegeven vanwege een lopende bewerking, waarbij een update naar de tabel wordt verboden totdat de lopende bewerking is voltooid.
properties.restoredLogs

RestoredLogs

Parameters van de herstelbewerking die deze tabel heeft gestart.
properties.resultStatistics

ResultStatistics

Statistieken voor het uitvoeren van een zoektaak.
properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

De tabelretentie in dagen, tussen 4 en 730. Als u deze eigenschap instelt op -1 wordt de werkruimteretentie standaard ingesteld.
properties.retentionInDaysAsDefault

boolean

True - Waarde is afkomstig van de retentie van werkruimten in dagen, Onwaar - Klantspecifiek.
properties.schema

Schema

Tabelschema.
properties.searchResults

SearchResults

Parameters van de zoektaak die deze tabel heeft gestart.
properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 4383

De totale retentie van de tabel in dagen, tussen 4 en 4383. Als u deze eigenschap instelt op -1 wordt standaard de tabelretentie ingesteld.
properties.totalRetentionInDaysAsDefault

boolean

True - Waarde is afkomstig van retentie in dagen, Onwaar - Klantspecifiek.
systemData

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

TablePlanEnum

Inventarisatie

Instrueer het systeem hoe de logboeken die zijn opgenomen in deze tabel moeten worden verwerkt en in rekening worden gebracht.

Waarde Description
Analytics

Logboeken die bewaking en analyse toestaan.
Basic

Logboeken die zijn aangepast ter ondersteuning van uitgebreide logboeken met een hoge volume lage waarde.

TableSubTypeEnum

Inventarisatie

In het subtype wordt beschreven welke API's kunnen worden gebruikt om te communiceren met de tabel en welke functies er tegen beschikbaar zijn.

Waarde Description
Any

Het standaardsubtype waarmee ingebouwde tabellen worden gemaakt.
Classic

Geeft een tabel aan die is gemaakt via de Data Collector-API of met de functie voor aangepaste logboeken van de MMA-agent, of een tabel waarmee aangepaste velden zijn gemaakt.
DataCollectionRuleBased

Een tabel die in aanmerking komt om gegevens erin te laten verzenden via een van de methoden die worden ondersteund door regels voor gegevensverzameling: de API voor gegevensverzamelingseindpunt, opnametijdtransformaties of een ander mechanisme dat wordt geleverd door regels voor gegevensverzameling

TableTypeEnum

Inventarisatie

De maker van de tabel.

Waarde Description
CustomLog

Aangepaste logboektabel.
Microsoft

Standaardgegevens die door Azure Monitor worden verzameld.
RestoredLogs

Herstelde gegevens.
SearchResults

Gegevens die worden verzameld door een zoektaak.