Workspaces - Create Or Update

Создание или обновление рабочего пространства.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не зависит от регистра.

subscriptionId
path True

string (uuid)

Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).

workspaceName
path True

string

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

Имя рабочей области.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Обязательно Тип Описание
location True

string

Географическое расположение, в котором находится ресурс

etag

string

Etag рабочей области.

identity

Identity

Удостоверение ресурса.

properties.defaultDataCollectionRuleResourceId

string

Идентификатор ресурса правила сбора данных по умолчанию, используемого для этой рабочей области. Ожидаемый формат : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

Свойства отработки отказа рабочей области.

properties.features

WorkspaceFeatures

Функции рабочей области.

properties.forceCmkForQuery

boolean

Указывает, является ли управляемое клиентом хранилище обязательным для управления запросами.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Тип сетевого доступа для доступа к приему Log Analytics.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Тип доступа к сети для доступа к запросу Log Analytics.

properties.replication

WorkspaceReplicationProperties

Свойства репликации рабочей области.

properties.retentionInDays

integer (int32)

Хранение данных рабочей области в днях. Допустимые значения — на тарифный план. Дополнительные сведения см. в документации по ценовой категории.

properties.sku

WorkspaceSku

Номер SKU рабочей области.

properties.workspaceCapping

WorkspaceCapping

Ежедневное ограничение тома для приема.

tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

Workspace

Операция обновления ресурса "Workspace" выполнена успешно

201 Created

Workspace

Операция по созданию ресурса 'Workspace' выполнена успешно

Заголовки

  • Location: string
  • Retry-After: integer
202 Accepted

Операция ресурса принята.

Заголовки

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

WorkspacesCreate

Образец запроса

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

Пример ответа

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

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

DataIngestionStatus

Состояние приема данных для этой рабочей области.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

Identity

Удостоверение ресурса.

IdentityType

Тип управляемого удостоверения службы.

PrivateLinkScopedResource

Ссылка на ресурс области приватного канала.

PublicNetworkAccessType

Тип сетевого доступа для доступа к приему Log Analytics.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

UserIdentityProperties

Свойства назначаемого пользователем удостоверения.

Workspace

Контейнер ресурсов верхнего уровня Workspace.

WorkspaceCapping

Ежедневное ограничение тома для приема.

WorkspaceEntityStatus

Состояние подготовки рабочей области.

WorkspaceFailoverProperties

Состояние отработки отказа репликации.

WorkspaceFailoverState

Состояние отработки отказа репликации.

WorkspaceFeatures

Функции рабочей области.

WorkspaceReplicationProperties

Свойства репликации рабочей области.

WorkspaceReplicationState

Состояние подготовки репликации.

WorkspaceSku

Номер SKU (уровень) рабочей области.

WorkspaceSkuNameEnum

Имя номера SKU.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

DataIngestionStatus

Состояние приема данных для этой рабочей области.

Значение Описание
RespectQuota

Прием включается после сброса ежедневной квоты или активации подписки.

ForceOn

Прием начался после изменения настроек службы.

ForceOff

Прием остановлен после изменения настроек службы.

OverQuota

Достигнута суточная квота ограничения, прием остановлен.

SubscriptionSuspended

Прием остановлен после приостановления подписки.

ApproachingQuota

Достигнуто 80% дневной квоты.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

Identity

Удостоверение ресурса.

Имя Тип Описание
principalId

string

Идентификатор субъекта удостоверения ресурса.

tenantId

string

Идентификатор клиента ресурса.

type

IdentityType

Тип управляемого удостоверения службы.

userAssignedIdentities

<string,  UserIdentityProperties>

Список удостоверений пользователей, связанных с ресурсом. Ссылки на ключ словаря удостоверений пользователя будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

IdentityType

Тип управляемого удостоверения службы.

Значение Описание
SystemAssigned

Системное назначение

UserAssigned

UserAssigned

None

Отсутствует

PrivateLinkScopedResource

Ссылка на ресурс области приватного канала.

Имя Тип Описание
resourceId

string

Полный идентификатор ресурса области приватного канала.

scopeId

string

Уникальный идентификатор области приватного канала.

PublicNetworkAccessType

Тип сетевого доступа для доступа к приему Log Analytics.

Значение Описание
Enabled

Обеспечивает подключение к Log Analytics через общедоступный DNS.

Disabled

Отключает общедоступное подключение к Log Analytics через общедоступный DNS.

SecuredByPerimeter

Доступ к ресурсу возможен только из частных сетей, а доступ разрешен периметром безопасности сети, связанным с этим ресурсом.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя Тип Описание
createdAt

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.

UserIdentityProperties

Свойства назначаемого пользователем удостоверения.

Имя Тип Описание
clientId

string

Идентификатор клиента назначаемого пользователем удостоверения.

principalId

string

Идентификатор субъекта назначаемого пользователем удостоверения.

Workspace

Контейнер ресурсов верхнего уровня Workspace.

Имя Тип Значение по умолчанию Описание
etag

string

Etag рабочей области.

id

string (arm-id)

Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

Identity

Удостоверение ресурса.

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса

properties.createdDate

string (date-time)

Дата создания рабочего пространства.

properties.customerId

string

Это свойство доступно только для чтения. Представляет идентификатор, связанный с рабочей областью.

properties.defaultDataCollectionRuleResourceId

string

Идентификатор ресурса правила сбора данных по умолчанию, используемого для этой рабочей области. Ожидаемый формат : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

Свойства отработки отказа рабочей области.

properties.features

WorkspaceFeatures

Функции рабочей области.

properties.forceCmkForQuery

boolean

Указывает, является ли управляемое клиентом хранилище обязательным для управления запросами.

properties.modifiedDate

string (date-time)

Дата изменения рабочего пространства.

properties.privateLinkScopedResources

PrivateLinkScopedResource[]

Список ресурсов области связанного приватного канала.

properties.provisioningState

WorkspaceEntityStatus

Состояние подготовки рабочей области.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Тип сетевого доступа для доступа к приему Log Analytics.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Тип доступа к сети для доступа к запросу Log Analytics.

properties.replication

WorkspaceReplicationProperties

Свойства репликации рабочей области.

properties.retentionInDays

integer (int32)

Хранение данных рабочей области в днях. Допустимые значения — на тарифный план. Дополнительные сведения см. в документации по ценовой категории.

properties.sku

WorkspaceSku

Номер SKU рабочей области.

properties.workspaceCapping

WorkspaceCapping

Ежедневное ограничение тома для приема.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Ежедневное ограничение тома для приема.

Имя Тип Описание
dailyQuotaGb

number (double)

Ежедневная квота рабочей области для приема.

dataIngestionStatus

DataIngestionStatus

Состояние приема данных для этой рабочей области.

quotaNextResetTime

string

Время, когда норма будет отдыхать.

WorkspaceEntityStatus

Состояние подготовки рабочей области.

Значение Описание
Creating

Создавать

Succeeded

Succeeded

Failed

Неудача

Canceled

Отменено

Deleting

Удаление

ProvisioningAccount

ProvisioningAccount

Updating

Обновление

WorkspaceFailoverProperties

Состояние отработки отказа репликации.

Имя Тип Описание
lastModifiedDate

string (date-time)

Время последнего обновления состояния отработки отказа.

state

WorkspaceFailoverState

Состояние отработки отказа репликации.

WorkspaceFailoverState

Состояние отработки отказа репликации.

Значение Описание
Inactive

Неактивное

Activating

Активация

Active

Активный

Deactivating

Деактивация

Failed

Неудача

WorkspaceFeatures

Функции рабочей области.

Имя Тип Описание
associations

string[]

Список ассоциаций для рабочей области. Указывает, связана ли рабочая область с каким-либо из следующих интерфейсов: MDC, Sentinel, SentinelGraph и т. д.

clusterResourceId

string

Выделенный идентификатор ресурса кластера LA, связанный с рабочими областями.

disableLocalAuth

boolean

Отключите проверку подлинности, отличной от AAD.

enableDataExport

boolean

Флаг, указывающий, следует ли экспортировать данные.

enableLogAccessUsingOnlyResourcePermissions

boolean

Пометка, указывающая, какое разрешение на использование — ресурс или рабочая область или оба.

immediatePurgeDataOn30Days

boolean

Флаг, описывающий, следует ли удалять данные через 30 дней.

unifiedSentinelBillingOnly

boolean

Указание на то, что указанное рабочее пространство ограничено только единой моделью выставления счетов Sentinel.

WorkspaceReplicationProperties

Свойства репликации рабочей области.

Имя Тип Описание
createdDate

string (date-time)

Время последнего включения репликации.

enabled

boolean

Указывает, включена ли репликация. Если задано значение true, конфигурация рабочей области и данные реплицируются в указанное расположение. Если репликация включена, необходимо указать расположение.

lastModifiedDate

string (date-time)

Время последнего обновления репликации.

location

string

Расположение репликации.

provisioningState

WorkspaceReplicationState

Состояние подготовки репликации.

WorkspaceReplicationState

Состояние подготовки репликации.

Значение Описание
Succeeded

Succeeded

EnableRequested

ВключитьЗапрошено

Enabling

Включение

DisableRequested

DisableRequested

Disabling

Отключение

RollbackRequested

Запрос отката

RollingBack

RollingBack

Failed

Неудача

Canceled

Отменено

WorkspaceSku

Номер SKU (уровень) рабочей области.

Имя Тип Описание
capacityReservationLevel

integer (int32)

Уровень резервирования емкости в ГБ для этой рабочей области при выборе номера SKU CapacityReservation.

lastSkuUpdate

string (date-time)

Последний раз когда обновлялся артикул.

name

WorkspaceSkuNameEnum

Имя номера SKU.

WorkspaceSkuNameEnum

Имя номера SKU.

Значение Описание
Free

Free

Standard

Standard

Premium

Премия

PerNode

PerNode

PerGB2018

PerGB2018

Standalone

Автономный

CapacityReservation

Резервирование вместимости

LACluster

LACluster