Partager via


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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

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

subscriptionId
path True

string

minLength: 1

ID de l’abonnement cible.

tableName
path True

string

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

Nom de la table.

workspaceName
path True

string

minLength: 4
maxLength: 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

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 (int32)

minimum: 4
maximum: 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

Schema

Schéma de table.

properties.searchResults

SearchResults

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

properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 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

Table

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

ErrorResponse

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.

ColumnDataTypeHintEnum

Indicateur logique de type de données de colonne.

ColumnTypeEnum

Type de données de 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 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.

RestoredLogs

Restaurer les paramètres.

ResultStatistics

Statistiques d’exécution de 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 la table.

systemData

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.

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 sur celle-ci.

TableTypeEnum

Créateur de la table.

Column

Colonne Tableau.

Nom Type Description
dataTypeHint

ColumnDataTypeHintEnum

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

ColumnTypeEnum

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

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

SourceEnum

Créateur de la table.

standardColumns

Column[]

Liste des colonnes standard de la 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 sur celle-ci.

tableType

TableTypeEnum

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

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

createdByType

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

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

RestoredLogs

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

properties.resultStatistics

ResultStatistics

Statistiques d’exécution de travaux de recherche.

properties.retentionInDays

integer (int32)

minimum: 4
maximum: 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

Schema

Schéma de table.

properties.searchResults

SearchResults

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

properties.totalRetentionInDays

integer (int32)

minimum: 4
maximum: 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

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.