Workspaces - Create Or Update
Créez ou mettez à jour un espace de travail.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?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 (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
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 | Obligatoire | Type | Description |
|---|---|---|---|
| location | True |
string |
Emplacement géographique où réside la ressource |
| etag |
string |
Etag de l’espace de travail. |
|
| identity |
Identité de la ressource. |
||
| properties.defaultDataCollectionRuleResourceId |
string |
ID de ressource de la règle de collecte de données par défaut à utiliser pour cet espace de travail. Le format attendu est : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
propriétés de basculement de l’espace de travail. |
||
| properties.features |
Fonctionnalités de l’espace de travail. |
||
| properties.forceCmkForQuery |
boolean |
Indique si le stockage géré par le client est obligatoire pour la gestion des requêtes. |
|
| properties.publicNetworkAccessForIngestion |
Type d’accès réseau pour accéder à l’ingestion Log Analytics. |
||
| properties.publicNetworkAccessForQuery |
Type d’accès réseau pour accéder à la requête Log Analytics. |
||
| properties.replication |
propriétés de réplication d’espace de travail. |
||
| properties.retentionInDays |
integer (int32) |
Conservation des données de l’espace de travail en jours. Les valeurs autorisées varient selon le plan tarifaire. Pour plus d’informations, consultez la documentation sur les niveaux tarifaires. |
|
| properties.sku |
Référence SKU de l’espace de travail. |
||
| properties.workspaceCapping |
Limite de volume quotidienne pour l’ingestion. |
||
| tags |
object |
Balises de ressource. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Réussite de l’opération de mise à jour de la ressource « Espace de travail » |
|
| 201 Created |
Réussite de l’opération de création de la ressource « Espace de travail » En-têtes
|
|
| 202 Accepted |
Exploitation des ressources acceptée. En-têtes
|
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Azure Active Directory OAuth2 Flow.
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
WorkspacesCreate
Exemple de requête
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01
{
"location": "australiasoutheast",
"properties": {
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
},
"tags": {
"tag1": "val1"
}
}
Exemple de réponse
{
"name": "AzTest2170",
"type": "Microsoft.OperationalInsights/workspaces",
"id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
"location": "australiasoutheast",
"properties": {
"customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
"provisioningState": "Creating",
"publicNetworkAccessForIngestion": "Enabled",
"publicNetworkAccessForQuery": "Enabled",
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
},
"tags": {
"tag1": "val1"
}
}
{
"name": "AzTest2170",
"type": "Microsoft.OperationalInsights/workspaces",
"id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
"location": "australiasoutheast",
"properties": {
"customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
"provisioningState": "Creating",
"publicNetworkAccessForIngestion": "Enabled",
"publicNetworkAccessForQuery": "Enabled",
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
},
"tags": {
"tag1": "val1"
}
}
Définitions
| Nom | Description |
|---|---|
|
created |
Type d’identité qui a créé la ressource. |
|
Data |
L’état de l’ingestion des données pour cet espace de travail. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
| Identity |
Identité de la ressource. |
|
Identity |
Type d’identité de service managé. |
|
Private |
Informations de référence sur la ressource d’étendue de liaison privée. |
|
Public |
Type d’accès réseau pour accéder à l’ingestion Log Analytics. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
|
User |
Propriétés d’identité attribuées par l’utilisateur. |
| Workspace |
Conteneur de ressources Workspace de niveau supérieur. |
|
Workspace |
Limite de volume quotidienne pour l’ingestion. |
|
Workspace |
État d’approvisionnement de l’espace de travail. |
|
Workspace |
État de basculement de la réplication. |
|
Workspace |
État de basculement de la réplication. |
|
Workspace |
Fonctionnalités de l’espace de travail. |
|
Workspace |
Propriétés de réplication de l’espace de travail. |
|
Workspace |
État de provisionnement de la réplication. |
|
Workspace |
Référence SKU (niveau) d’un espace de travail. |
|
Workspace |
Nom de la référence SKU. |
createdByType
Type d’identité qui a créé la ressource.
| Valeur | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataIngestionStatus
L’état de l’ingestion des données pour cet espace de travail.
| Valeur | Description |
|---|---|
| RespectQuota |
Ingestion activée après la réinitialisation du quota de plafond quotidien ou l’activation de l’abonnement. |
| ForceOn |
L’ingestion a démarré suite à la modification des paramètres du service. |
| ForceOff |
L’ingestion s’est arrêtée suite à la modification des paramètres du service. |
| OverQuota |
Atteint le quota quotidien, l’ingestion a cessé. |
| SubscriptionSuspended |
L’ingestion a cessé suite à la suspension de l’abonnement. |
| ApproachingQuota |
80% de quota quotidien atteint. |
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. |
Identity
Identité de la ressource.
| Nom | Type | Description |
|---|---|---|
| principalId |
string |
ID principal de l’identité de ressource. |
| tenantId |
string |
ID de locataire de la ressource. |
| type |
Type d’identité de service managé. |
|
| userAssignedIdentities |
<string,
User |
Liste des identités utilisateur associées à la ressource. Les références de clé de dictionnaire d’identité utilisateur seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} ». |
IdentityType
Type d’identité de service managé.
| Valeur | Description |
|---|---|
| SystemAssigned |
Attribué par le système |
| UserAssigned |
UserAssigned |
| None |
None |
PrivateLinkScopedResource
Informations de référence sur la ressource d’étendue de liaison privée.
| Nom | Type | Description |
|---|---|---|
| resourceId |
string |
ID de ressource complet de la ressource d’étendue de lien privé. |
| scopeId |
string |
L’identificateur unique de portée du lien privé. |
PublicNetworkAccessType
Type d’accès réseau pour accéder à l’ingestion Log Analytics.
| Valeur | Description |
|---|---|
| Enabled |
Permet la connectivité à Log Analytics via un DNS public. |
| Disabled |
Désactive la connectivité publique à Log Analytics via le DNS public. |
| SecuredByPerimeter |
La ressource n’est accessible qu’à partir de réseaux privés et l’accès approuvé par le périmètre de sécurité du réseau associé à cette ressource. |
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. |
UserIdentityProperties
Propriétés d’identité attribuées par l’utilisateur.
| Nom | Type | Description |
|---|---|---|
| clientId |
string |
ID client de l’identité affectée par l’utilisateur. |
| principalId |
string |
ID principal de l’identité affectée par l’utilisateur. |
Workspace
Conteneur de ressources Workspace de niveau supérieur.
| Nom | Type | Valeur par défaut | Description |
|---|---|---|---|
| etag |
string |
Etag de l’espace de travail. |
|
| id |
string (arm-id) |
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} » |
|
| identity |
Identité de la ressource. |
||
| location |
string |
Emplacement géographique où réside la ressource |
|
| name |
string |
Nom de la ressource |
|
| properties.createdDate |
string (date-time) |
Date de création de l’espace de travail. |
|
| properties.customerId |
string |
Il s’agit d’une propriété en lecture seule. Représente l’ID associé à l’espace de travail. |
|
| properties.defaultDataCollectionRuleResourceId |
string |
ID de ressource de la règle de collecte de données par défaut à utiliser pour cet espace de travail. Le format attendu est : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
propriétés de basculement de l’espace de travail. |
||
| properties.features |
Fonctionnalités de l’espace de travail. |
||
| properties.forceCmkForQuery |
boolean |
Indique si le stockage géré par le client est obligatoire pour la gestion des requêtes. |
|
| properties.modifiedDate |
string (date-time) |
Date de modification de l’espace de travail. |
|
| properties.privateLinkScopedResources |
Liste des ressources de portée de lien privé lié. |
||
| properties.provisioningState |
État d’approvisionnement de l’espace de travail. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Type d’accès réseau pour accéder à l’ingestion Log Analytics. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Type d’accès réseau pour accéder à la requête Log Analytics. |
|
| properties.replication |
propriétés de réplication d’espace de travail. |
||
| properties.retentionInDays |
integer (int32) |
Conservation des données de l’espace de travail en jours. Les valeurs autorisées varient selon le plan tarifaire. Pour plus d’informations, consultez la documentation sur les niveaux tarifaires. |
|
| properties.sku |
Référence SKU de l’espace de travail. |
||
| properties.workspaceCapping |
Limite de volume quotidienne pour l’ingestion. |
||
| systemData |
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy. |
||
| tags |
object |
Balises de ressource. |
|
| type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
WorkspaceCapping
Limite de volume quotidienne pour l’ingestion.
| Nom | Type | Description |
|---|---|---|
| dailyQuotaGb |
number (double) |
Quota quotidien de l’espace de travail pour l’ingestion. |
| dataIngestionStatus |
L’état de l’ingestion des données pour cet espace de travail. |
|
| quotaNextResetTime |
string |
Le moment où le quota sera au repos. |
WorkspaceEntityStatus
État d’approvisionnement de l’espace de travail.
| Valeur | Description |
|---|---|
| Creating |
Création |
| Succeeded |
Réussi |
| Failed |
Échec |
| Canceled |
Annulé |
| Deleting |
Suppression |
| ProvisioningAccount |
ProvisioningAccount |
| Updating |
Mise à jour |
WorkspaceFailoverProperties
État de basculement de la réplication.
| Nom | Type | Description |
|---|---|---|
| lastModifiedDate |
string (date-time) |
La dernière fois que l’état de basculement a été mis à jour. |
| state |
État de basculement de la réplication. |
WorkspaceFailoverState
État de basculement de la réplication.
| Valeur | Description |
|---|---|
| Inactive |
Inactifs |
| Activating |
Activation en cours |
| Active |
Actif |
| Deactivating |
Désactivation |
| Failed |
Échec |
WorkspaceFeatures
Fonctionnalités de l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| associations |
string[] |
Liste des associations pour l’espace de travail. Indique si l’espace de travail est associé à l’une des expériences suivantes : MDC, Sentinel, SentinelGraph, etc. |
| clusterResourceId |
string |
ResourceId de cluster LA dédié lié aux espaces de travail. |
| disableLocalAuth |
boolean |
Désactivez l’authentification non basée sur AAD. |
| enableDataExport |
boolean |
Indicateur indiquant si les données doivent être exportées. |
| enableLogAccessUsingOnlyResourcePermissions |
boolean |
Indicateur qui indique l’autorisation d’utiliser - ressource ou espace de travail ou les deux. |
| immediatePurgeDataOn30Days |
boolean |
Indicateur qui décrit si nous voulons supprimer les données après 30 jours. |
| unifiedSentinelBillingOnly |
boolean |
Une indication si l’espace de travail spécifié est limité au modèle de facturation unifié de sentinelle uniquement. |
WorkspaceReplicationProperties
Propriétés de réplication de l’espace de travail.
| Nom | Type | Description |
|---|---|---|
| createdDate |
string (date-time) |
La dernière fois que la réplication a été activée. |
| enabled |
boolean |
Spécifie si la réplication est activée ou non. Lorsque la valeur est true, la configuration et les données de l’espace de travail sont répliquées à l’emplacement spécifié. Si la réplication est activée, l’emplacement doit être fourni. |
| lastModifiedDate |
string (date-time) |
La dernière fois que la réplication a été mise à jour. |
| location |
string |
Emplacement de la réplication. |
| provisioningState |
État de provisionnement de la réplication. |
WorkspaceReplicationState
État de provisionnement de la réplication.
| Valeur | Description |
|---|---|
| Succeeded |
Réussi |
| EnableRequested |
EnableRequested |
| Enabling |
Activation |
| DisableRequested |
Demandé pour Handicap |
| Disabling |
Désactivation |
| RollbackRequested |
RollbackRequested |
| RollingBack |
RollingBack |
| Failed |
Échec |
| Canceled |
Annulé |
WorkspaceSku
Référence SKU (niveau) d’un espace de travail.
| Nom | Type | Description |
|---|---|---|
| capacityReservationLevel |
integer (int32) |
Niveau de réservation de capacité en Go pour cet espace de travail, lorsque la référence SKU CapacityReservation est sélectionnée. |
| lastSkuUpdate |
string (date-time) |
La dernière fois que le SKU a été mis à jour. |
| name |
Nom de la référence SKU. |
WorkspaceSkuNameEnum
Nom de la référence SKU.
| Valeur | Description |
|---|---|
| Free |
Free |
| Standard |
Standard |
| Premium |
Premium |
| PerNode |
PerNode |
| PerGB2018 |
PerGB2018 |
| Standalone |
Indépendant |
| CapacityReservation |
Réservation de capacité |
| LACluster |
LACluster |