Partager via

Tables - Create Or Update

  • Référence
Service:
Log Analytics
Version d'API:
2025-02-01

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

Conservation de la table en jours, comprise 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.
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. La définition de cette propriété sur -1 est par défaut la rétention de table.

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 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-02-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=2025-02-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-02-01

Définitions

Nom Description
Column

Colonne de table.
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. Si la valeur est « mise à jour », 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 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 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.
TableTypeEnum

Créateur de table.

Column

Object

Colonne de table.

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

Colonne masquée.
name

string

Nom de colonne.
type

ColumnTypeEnum

Type de données de colonne.

ColumnDataTypeHintEnum

Énumération

Indicateur logique de type de données de colonne.

Valeur Description
armPath

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

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

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

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

Énumération

Type de données de colonne.

Valeur Description
boolean
dateTime
dynamic
guid
int
long
real
string

createdByType

Énumération

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

Valeur Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

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

Object

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

Object

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ProvisioningStateEnum

Énumération

État d’approvisionnement actuel de la table. Si la valeur est « mise à jour », 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.

Valeur Description
Deleting

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

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

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

Le schéma de table est toujours généré et mis à jour, la table est actuellement verrouillée pour toutes les modifications jusqu’à ce que la procédure soit effectuée.

RestoredLogs

Object

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

Object

Statistiques d’exécution de travaux de recherche.

Nom Type Description
ingestedRecords

integer (int32)

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

number

multipleOf: 0.01

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

number

multipleOf: 0.01

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

Schema

Object

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 avec laquelle le tableau est affilié
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.
tableType

TableTypeEnum

Créateur de table.

SearchResults

Object

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 (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 le travail de recherche.
startSearchTime

string (date-time)

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

SourceEnum

Énumération

Créateur de table.

Valeur Description
customer

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

Les tables approvisionné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.

systemData

Object

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

Object

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

Conservation de l’archivage des données de 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 la table. Si la valeur est « mise à jour », 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 de travaux de recherche.
properties.retentionInDays

integer (int32)

minimum: 4
maximum: 730

Conservation de la table en jours, comprise 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.
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. La définition de cette propriété sur -1 est par défaut la rétention de table.
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

Énumération

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

Valeur Description
Analytics

Journaux qui autorisent la surveillance et l’analytique.
Basic

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

TableSubTypeEnum

Énumération

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

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 Collecteur de données ou avec la fonctionnalité 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 de point de terminaison de collecte de données, les transformations d’ingestion ou tout autre mécanisme fourni par les règles de collecte de données

TableTypeEnum

Énumération

Créateur de table.

Valeur Description
CustomLog

Table de journaux personnalisée.
Microsoft

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

Données restaurées.
SearchResults

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