Partager via

Tables - Create Or Update

  • Référence
Service:
Log Analytics
Version d'API:
2023-09-01

Mettre à jour ou créer une table d’espace de travail Log Analytics.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
 path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId
 path True

string

ID de l’abonnement cible.
tableName
 path True

string

Nom de la table.

Modèle d’expression régulière: ^[A-Za-z0-9-_]+$
workspaceName
 path True

string

Nom de l’espace de travail.

Modèle d’expression régulière: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version
 query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Type Description
properties.plan

TablePlanEnum

Indiquez au système comment gérer et charger les journaux ingérés dans cette table.
properties.restoredLogs

RestoredLogs

Paramètres de l’opération de restauration qui a lancé cette table.
properties.retentionInDays

integer

Conservation de la table en jours, entre 4 et 730. La définition de cette propriété sur -1 est définie par défaut sur la rétention de l’espace de travail.
properties.schema

Schema

Schéma de la table
properties.searchResults

SearchResults

Paramètres du travail de recherche qui a lancé cette table.
properties.totalRetentionInDays

integer

Conservation totale de la table en jours, comprise entre 4 et 4383. Si vous affectez la valeur -1 à cette propriété, la rétention de la table est définie par défaut.

Réponses

Nom Type Description
200 OK

Table

Définition de réponse OK.
202 Accepted

Définition de réponse acceptée (opération de longue durée).
Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

TablesUpsert

Exemple de requête

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

Exemple de réponse

Code d’état:
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"
}
Code d’état:
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

Définitions

Nom Description
Column

Colonne de table.
ColumnDataTypeHintEnum

Indicateur logique du type de données de colonne.
ColumnTypeEnum

Type de données de la colonne.
createdByType

Type d’identité qui a créé la ressource.
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
ProvisioningStateEnum

État d’approvisionnement actuel de table. Si la valeur est « update », indique un verrou de ressource en raison d’une opération en cours, interdisant toute mise à jour de la table jusqu’à ce que l’opération en cours soit terminée.
RestoredLogs

Paramètres de restauration.
ResultStatistics

Statistiques d’exécution des travaux de recherche.
Schema

Schéma de la table.
SearchResults

Paramètres du travail de recherche qui a lancé cette table.
SourceEnum

Créateur de table.
systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.
Table

Définition de table de données d’espace de travail.
TablePlanEnum

Indiquez au système comment gérer et charger les journaux ingérés dans cette table.
TableSubTypeEnum

Le sous-type décrit les API qui peuvent être utilisées pour interagir avec la table et les fonctionnalités disponibles pour celle-ci.
TableTypeEnum

Créateur de table.

Column

Colonne de table.

Nom Type Description
dataTypeHint

ColumnDataTypeHintEnum

Indicateur logique du type de données de colonne.
description

string

Description de la colonne.
displayName

string

Nom complet de la colonne.
isDefaultDisplay

boolean

Est affiché par défaut.
isHidden

boolean

Colonne masquée.
name

string

Nom de la colonne.
type

ColumnTypeEnum

Type de données de la colonne.

ColumnDataTypeHintEnum

Indicateur logique du type de données de colonne.

Nom Type Description
armPath

string

Un chemin d’accès ARM (Azure Resource Model) : /subscriptions/{...} /resourceGroups/{...} /providers/Microsoft. {...} /{...} /{...} /{...} ...
guid

string

GUID 128 bits standard suivant la forme standard, xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx
ip

string

Une adresse IP V4/V6 standard suivant la forme standard, x.x.x.x/y :y :y :y :y :y :y :y :y :y :y
uri

string

Chaîne qui correspond au modèle d’un URI, par exemple, scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment

ColumnTypeEnum

Type de données de la colonne.

Nom Type Description
boolean

string

dateTime

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires
type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d'erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet error.

ProvisioningStateEnum

État d’approvisionnement actuel de table. Si la valeur est « update », indique un verrou de ressource en raison d’une opération en cours, interdisant toute mise à jour de la table jusqu’à ce que l’opération en cours soit terminée.

Nom Type Description
Deleting

string

L’état de la table est supprimé.
InProgress

string

Le schéma de table est stable et sans modification, les données de table sont mises à jour.
Succeeded

string

L’état de la table est stable et sans modification, la table est déverrouillée et ouverte pour les nouvelles mises à jour.
Updating

string

Le schéma de table est toujours en cours de génération et de mise à jour, la table est actuellement verrouillée pour toutes les modifications jusqu’à ce que la procédure soit terminée.

RestoredLogs

Paramètres de restauration.

Nom Type Description
azureAsyncOperationId

string

Id d’opération asynchrone de la table des résultats de la recherche.
endRestoreTime

string

Horodatage pour terminer la restauration par (UTC).
sourceTable

string

Table à partir de laquelle restaurer les données.
startRestoreTime

string

Horodatage à partir duquel démarrer la restauration à partir de (UTC).

ResultStatistics

Statistiques d’exécution des travaux de recherche.

Nom Type Description
ingestedRecords

integer

Nombre de lignes retournées par le travail de recherche.
progress

number

Pourcentage d’achèvement du travail de recherche.
scannedGb

number

Travail de recherche : quantité de données analysées.

Schema

Schéma de la table.

Nom Type Description
categories

string[]

Catégorie de table.
columns

Column[]

Liste de colonnes personnalisées de table.
description

string

Description de la table.
displayName

string

Nom complet de la table.
labels

string[]

Étiquettes de table.
name

string

Nom de la table.
solutions

string[]

Liste des solutions associées à la table
source

SourceEnum

Créateur de table.
standardColumns

Column[]

Liste des colonnes standard de table.
tableSubType

TableSubTypeEnum

Le sous-type décrit les API qui peuvent être utilisées pour interagir avec la table et les fonctionnalités disponibles pour celle-ci.
tableType

TableTypeEnum

Créateur de table.

SearchResults

Paramètres du travail de recherche qui a lancé cette table.

Nom Type Description
azureAsyncOperationId

string

Id d’opération asynchrone de la table des résultats de la recherche.
description

string

Description du travail de recherche.
endSearchTime

string

Horodatage pour mettre fin à la recherche par (UTC)
limit

integer

Limitez le travail de recherche à retourner jusqu’au nombre de lignes spécifié.
query

string

Requête de travail de recherche.
sourceTable

string

Table utilisée dans le travail de recherche.
startSearchTime

string

Horodatage à partir duquel démarrer la recherche à partir de (UTC)

SourceEnum

Créateur de table.

Nom Type Description
customer

string

Tables créées par le propriétaire de l’espace de travail et trouvées uniquement dans cet espace de travail.
microsoft

string

Tables approvisionnées par le système, telles qu’elles sont collectées via les paramètres de diagnostic, les agents ou tout autre moyen de collecte de données standard.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).
createdBy

string

Identité qui a créé la ressource.
createdByType

createdByType

Type d’identité qui a créé la ressource.
lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

Table

Définition de table de données d’espace de travail.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

nom de la ressource.
properties.archiveRetentionInDays

integer

Conservation des données de la table en jours. Calculé comme (totalRetentionInDays-retentionInDays)
properties.lastPlanModifiedDate

string

Horodatage de la dernière modification du plan de table (UTC).
properties.plan

TablePlanEnum

Indiquez au système comment gérer et charger les journaux ingérés dans cette table.
properties.provisioningState

ProvisioningStateEnum

État d’approvisionnement actuel de table. Si la valeur est « update », indique un verrou de ressource en raison d’une opération en cours, interdisant toute mise à jour de la table jusqu’à ce que l’opération en cours soit terminée.
properties.restoredLogs

RestoredLogs

Paramètres de l’opération de restauration qui a lancé cette table.
properties.resultStatistics

ResultStatistics

Statistiques d’exécution des travaux de recherche.
properties.retentionInDays

integer

Conservation de la table en jours, entre 4 et 730. La définition de cette propriété sur -1 est définie par défaut sur la rétention de l’espace de travail.
properties.retentionInDaysAsDefault

boolean

True : la valeur provient de la rétention de l’espace de travail en jours, false - spécifique au client.
properties.schema

Schema

Schéma de la table
properties.searchResults

SearchResults

Paramètres du travail de recherche qui a lancé cette table.
properties.totalRetentionInDays

integer

Conservation totale de la table en jours, comprise entre 4 et 4383. Si vous affectez la valeur -1 à cette propriété, la rétention de la table est définie par défaut.
properties.totalRetentionInDaysAsDefault

boolean

True : la valeur provient de la rétention en jours, False - Spécifique au client.
systemData

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.
type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

TablePlanEnum

Indiquez au système comment gérer et charger les journaux ingérés dans cette table.

Nom Type Description
Analytics

string

Journaux qui autorisent la surveillance et l’analytique.
Basic

string

Journaux qui sont ajustés pour prendre en charge les journaux détaillés à faible volume élevé.

TableSubTypeEnum

Le sous-type décrit les API qui peuvent être utilisées pour interagir avec la table et les fonctionnalités disponibles pour celle-ci.

Nom Type Description
Any

string

Sous-type par défaut avec lequel les tables intégrées sont créées.
Classic

string

Indique une table créée via l’API Collecteur de données ou avec la fonctionnalité de journaux personnalisés de l’agent MMA, ou toute table sur laquelle les champs personnalisés ont été créés.
DataCollectionRuleBased

string

Une table éligible à l’envoi de données via l’un des moyens pris en charge par les règles de collecte de données : l’API de point de terminaison de collecte de données, les transformations au moment de l’ingestion ou tout autre mécanisme fourni par les règles de collecte de données

TableTypeEnum

Créateur de table.

Nom Type Description
CustomLog

string

Table de journaux personnalisée.
Microsoft

string

Données standard collectées par Azure Monitor.
RestoredLogs

string

Données restaurées.
SearchResults

string

Données collectées par un travail de recherche.