Tables - Create Or Update
Mettez à jour ou créez 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=2025-07-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
path | True |
string minLength: 1 |
ID de l’abonnement cible. |
|
table
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9-_]+$ |
Nom de la table. |
|
workspace
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
Nom de l’espace de travail. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| properties.plan |
Indiquez au système comment gérer et charger les journaux ingérés dans cette table. |
|
| properties.restoredLogs |
Paramètres de l’opération de restauration qui a lancé cette table. |
|
| properties.retentionInDays |
integer (int32) minimum: 4maximum: 730 |
Dans la table Analytics : les tables de rétention des analyses en jours, entre 4 et 730. La définition de cette propriété sur -1 est par défaut la rétention de l’espace de travail. Dans la table de base et la table auxiliaire : propriété en lecture seule. |
| properties.schema |
Schéma de table. |
|
| properties.searchResults |
Paramètres du travail de recherche qui a lancé cette table. |
|
| properties.totalRetentionInDays |
integer (int32) minimum: 4maximum: 4383 |
Conservation totale de la table en jours, comprise entre 4 et 4383. Si vous attribuez la valeur -1 à cette propriété, la valeur par défaut est retentionInDays. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Définition de la réponse OK. |
|
| 202 Accepted |
Définition de la réponse acceptée (opération de longue durée). |
|
| Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
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=2025-07-01
{
"properties": {
"schema": {
"name": "AzureNetworkFlow",
"columns": [
{
"name": "MyNewColumn",
"type": "guid"
}
]
},
"retentionInDays": 45,
"totalRetentionInDays": 70
}
}
Exemple de réponse
{
"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=2025-07-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-07-01
Définitions
| Nom | Description |
|---|---|
| Column |
Colonne Tableau. |
|
Column |
Indicateur logique de type de données de colonne. |
|
Column |
Type de données de colonne. |
|
created |
Type d’identité qui a créé la ressource. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Provisioning |
État d’approvisionnement actuel de la table. S’il est défini sur 'mise à jour', indique un verrouillage de la 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. |
|
Restored |
Restaurer les paramètres. |
|
Result |
Statistiques d’exécution de travaux de recherche. |
| Schema |
Schéma de la table. |
|
Search |
Paramètres du travail de recherche qui a lancé cette table. |
|
Source |
Créateur de la table. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
| Table |
Définition de la table de données de l’espace de travail. |
|
Table |
Indiquez au système comment gérer et charger les journaux ingérés dans cette table. |
|
Table |
Le sous-type décrit les API qui peuvent être utilisées pour interagir avec la table et les fonctionnalités disponibles sur celle-ci. |
|
Table |
Créateur de la table. |
Column
Colonne Tableau.
| Nom | Type | Description |
|---|---|---|
| dataTypeHint |
Indicateur logique de type de données de colonne. |
|
| description |
string |
Description de colonne. |
| displayName |
string |
Nom complet de colonne. |
| isDefaultDisplay |
boolean |
S’affiche par défaut. |
| isHidden |
boolean |
La colonne est cachée. |
| name |
string |
Nom de colonne. |
| type |
Type de données de colonne. |
ColumnDataTypeHintEnum
Indicateur logique de type de données de colonne.
| Valeur | Description |
|---|---|
| uri |
Une chaîne qui correspond au modèle d’une URI, par exemple, scheme://username:password@host:1234/this/is/a/path?k1=v1&k2=v2#fragment |
| guid |
GUID standard de 128 bits suivant la forme standard xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| armPath |
Chemin d’accès Azure Resource Model (ARM) : /subscriptions/{...}/resourceGroups/{...}/providers/Microsoft. {...}/{...}/{...}/{...}... |
| ip |
Une adresse IP standard V4/V6 suivant la forme standard, x.x.x.x/y :y :y :y :y :y :y |
ColumnTypeEnum
Type de données de colonne.
| Valeur | Description |
|---|---|
| string | |
| int | |
| long | |
| real | |
| boolean | |
| dateTime | |
| guid | |
| dynamic |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
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émentaire. |
ErrorDetail
Détail de l’erreur.
| Nom | Type | Description |
|---|---|---|
| additionalInfo |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
Objet d’erreur. |
ProvisioningStateEnum
État d’approvisionnement actuel de la table. S’il est défini sur 'mise à jour', indique un verrouillage de la 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.
| Valeur | Description |
|---|---|
| Updating |
Le schéma de la table est toujours en cours de construction et de mise à jour, la table est actuellement verrouillée pour toute modification jusqu’à ce que la procédure soit terminée. |
| InProgress |
Le schéma de la table est stable et sans modifications, les données de la table sont mises à jour. |
| Succeeded |
L’état de la table est stable et sans modifications, la table est déverrouillée et ouverte pour de nouvelles mises à jour. |
| Deleting |
L’état de la table est en cours de suppression. |
RestoredLogs
Restaurer les paramètres.
| Nom | Type | Description |
|---|---|---|
| azureAsyncOperationId |
string |
ID d’opération asynchrone de la table des résultats de recherche. |
| endRestoreTime |
string (date-time) |
Horodatage pour mettre fin à la restauration par (UTC). |
| sourceTable |
string |
Table à partir de laquelle restaurer des données. |
| startRestoreTime |
string (date-time) |
Horodatage pour démarrer la restauration à partir de (UTC). |
ResultStatistics
Statistiques d’exécution de travaux de recherche.
| Nom | Type | Description |
|---|---|---|
| ingestedRecords |
integer (int32) |
Nombre de lignes renvoyées par la tâche de recherche. |
| progress |
number multipleOf: 0.01 |
Pourcentage d’achèvement de la tâche. |
| scannedGb |
number multipleOf: 0.01 |
Tâche de recherche : quantité de données numérisées. |
Schema
Schéma de la table.
| Nom | Type | Description |
|---|---|---|
| categories |
string[] |
Catégorie de table. |
| columns |
Column[] |
Liste des colonnes personnalisées de table. |
| description |
string |
Description du tableau. |
| displayName |
string |
Nom complet de la table. |
| labels |
string[] |
Étiquettes de table. |
| name |
string |
Nom de la table. |
| solutions |
string[] |
Liste des solutions auxquelles la table est affiliée |
| source |
Créateur de la table. |
|
| standardColumns |
Column[] |
Liste des colonnes standard de la table. |
| tableSubType |
Le sous-type décrit les API qui peuvent être utilisées pour interagir avec la table et les fonctionnalités disponibles sur celle-ci. |
|
| tableType |
Créateur de la 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 recherche. |
| description |
string |
Description du travail de recherche. |
| endSearchTime |
string (date-time) |
Horodatage pour mettre fin à la recherche par (UTC) |
| limit |
integer (int32) |
Limitez le travail de recherche à retourner jusqu’au nombre spécifié de lignes. |
| query |
string |
Rechercher une requête de travail. |
| sourceTable |
string |
Table utilisée dans la tâche de recherche. |
| startSearchTime |
string (date-time) |
Horodatage pour démarrer la recherche à partir de (UTC) |
SourceEnum
Créateur de la table.
| Valeur | Description |
|---|---|
| microsoft |
Tables provisionnées par le système, telles que collectées via les paramètres de diagnostic, les agents ou tout autre moyen de collecte de données standard. |
| customer |
Tables créées par le propriétaire de l’espace de travail et qui se trouvent uniquement dans cet espace de travail. |
systemData
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom | Type | Description |
|---|---|---|
| createdAt |
string (date-time) |
Horodatage de la création de ressources (UTC). |
| createdBy |
string |
Identité qui a créé la ressource. |
| createdByType |
Type d’identité qui a créé la ressource. |
|
| lastModifiedAt |
string (date-time) |
Horodatage de la dernière modification de ressource (UTC) |
| lastModifiedBy |
string |
Identité qui a modifié la ressource pour la dernière fois. |
| lastModifiedByType |
Type d’identité qui a modifié la ressource pour la dernière fois. |
Table
Définition de la table de données de l’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 (int32) |
Les tables de rétention à long terme en jours. Calculé comme suit : (totalRetentionInDays-retentionInDays). |
| properties.lastPlanModifiedDate |
string |
L’horodatage de la dernière modification du plan de table (UTC). |
| properties.plan |
Indiquez au système comment gérer et charger les journaux ingérés dans cette table. |
|
| properties.provisioningState |
État d’approvisionnement actuel de la table. S’il est défini sur 'mise à jour', indique un verrouillage de la 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 |
Paramètres de l’opération de restauration qui a lancé cette table. |
|
| properties.resultStatistics |
Statistiques d’exécution de travaux de recherche. |
|
| properties.retentionInDays |
integer (int32) minimum: 4maximum: 730 |
Dans la table Analytics : les tables de rétention des analyses en jours, entre 4 et 730. La définition de cette propriété sur -1 est par défaut la rétention de l’espace de travail. Dans la table de base et la table auxiliaire : propriété en lecture seule. |
| 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 |
Schéma de table. |
|
| properties.searchResults |
Paramètres du travail de recherche qui a lancé cette table. |
|
| properties.totalRetentionInDays |
integer (int32) minimum: 4maximum: 4383 |
Conservation totale de la table en jours, comprise entre 4 et 4383. Si vous attribuez la valeur -1 à cette propriété, la valeur par défaut est retentionInDays. |
| properties.totalRetentionInDaysAsDefault |
boolean |
Vrai - La valeur provient de la rétention en jours, Faux - Spécifique au client. |
| 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.
| Valeur | Description |
|---|---|
| Basic |
Journaux à contact moyen nécessaires pour le dépannage et la réponse aux incidents. |
| Analytics |
Journaux à forte valeur ajoutée utilisés pour la surveillance continue, la détection en temps réel et l’analyse des performances. |
| Auxiliary |
Journaux à faible interaction, tels que les journaux détaillés, et données requises pour l’audit et la conformité. |
TableSubTypeEnum
Le sous-type décrit les API qui peuvent être utilisées pour interagir avec la table et les fonctionnalités disponibles sur celle-ci.
| Valeur | Description |
|---|---|
| Any |
Sous-type par défaut avec lequel les tables intégrées sont créées. |
| Classic |
Indique une table créée via l’API Data Collector ou avec la fonctionnalité de journaux personnalisés de l’agent MMA, ou toute table sur laquelle des champs personnalisés ont été créés. |
| DataCollectionRuleBased |
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 du 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 la table.
| Valeur | Description |
|---|---|
| Microsoft |
Données standard collectées par Azure Monitor. |
| CustomLog |
Table de journaux personnalisée. |
| RestoredLogs |
Données restaurées. |
| SearchResults |
Données collectées par un job de recherche. |