你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Workspaces - Create Or Update

服务:: Log Analytics

API 版本:: 2025-07-01

创建或更新工作区。

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 minLength: 1	目标订阅的 ID。
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 版本。

请求正文

名称	类型	说明
parameters	Workspace	创建或更新工作区所需的参数。

响应

名称	类型	说明
200 OK	Workspace	确定响应定义。
201 Created	Workspace	创建了响应定义。
202 Accepted		已接受
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

WorkspacesCreate

示例请求

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

状态代码:: 202

定义

名称	说明
createdByType	创建资源的标识的类型。
DataIngestionStatus	此工作区的数据摄取状态。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
Identity	资源的标识。
PrivateLinkScopedResource	链接的专用链接范围资源的列表。
PublicNetworkAccessType	用于访问 Log Analytics 引入的网络访问类型。
ResourceIdentityType	标识类型。
systemData	与创建和上次修改资源相关的元数据。
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

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

Identity

Object

资源的标识。

名称	类型	说明
principalId	string (uuid)	资源标识的主体 ID。该值必须是 UUID。
tenantId	string (uuid)	资源的租户 ID。该值必须是 UUID。
type	ResourceIdentityType	标识类型。

PrivateLinkScopedResource

Object

链接的专用链接范围资源的列表。

名称	类型	说明
resourceId	string	专用链接范围资源的完整资源 ID。
scopeId	string	专用链接范围唯一标识符。

PublicNetworkAccessType

枚举

用于访问 Log Analytics 引入的网络访问类型。

值	说明
Enabled	通过公共 DNS 启用与 Log Analytics 的连接。
Disabled	禁用通过公共 DNS 与 Log Analytics 的公共连接。
SecuredByPerimeter	资源只能从专用网络访问，并且访问由与此资源关联的网络安全外围批准。

ResourceIdentityType

枚举

标识类型。

值	说明
SystemAssigned

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

Workspace

Object

顶级工作区资源容器。

名称	类型	默认值	说明
etag	string		工作区的 etag。
id	string		资源的完全限定资源 ID。示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		资源的标识。
location	string		资源所在的地理位置
name	string		资源的名称
properties.createdDate	string (date-time)		工作区创建日期。
properties.customerId	string		这是一个只读属性。表示与工作区关联的 ID。
properties.defaultDataCollectionRuleResourceId	string		要用于此工作区的默认数据收集规则的资源 ID。预期格式为 - /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		与创建和上次修改资源相关的元数据。
tags	object		资源标记。
type	string		资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

WorkspaceCapping

Object

引入的每日量上限。

名称	类型	说明
dailyQuotaGb	number (double)	引入的工作区每日配额。
dataIngestionStatus	DataIngestionStatus	此工作区的数据摄取状态。
quotaNextResetTime	string	配额休息的时间。

WorkspaceEntityStatus

枚举

工作区的预配状态。

值	说明
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Object

工作区故障转移属性。

名称	类型	说明
lastModifiedDate	string (date-time)	上次更新故障转移状态的时间。
state	WorkspaceFailoverState	复制的故障转移状态。

WorkspaceFailoverState

枚举

复制的故障转移状态。

值	说明
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Object

工作区功能。

名称	类型	说明
associations	string[]	工作区的关联列表。指示工作区是否与以下任何体验相关联：MDC、Sentinel、SentinelGraph 等。
clusterResourceId	string	链接到工作区的专用 LA 群集 resourceId。
disableLocalAuth	boolean	禁用基于非 AAD 的身份验证。
enableDataExport	boolean	指示是否应导出数据的标志。
enableLogAccessUsingOnlyResourcePermissions	boolean	指示使用哪个权限的标志 - 资源或工作区或两者。
immediatePurgeDataOn30Days	boolean	描述是否要在 30 天后删除数据的标志。
unifiedSentinelBillingOnly	boolean	指示指定工作区是否仅限于 Sentinel 的统一计费模型。

WorkspaceReplicationProperties

Object

工作区复制属性。

名称	类型	说明
createdDate	string (date-time)	上次启用复制的时间。
enabled	boolean	指定是否启用复制。如果为 true，工作区配置和数据将复制到指定位置。如果已启用复制，则必须提供位置。
lastModifiedDate	string (date-time)	上次更新复制的时间。
location	string	复制的位置。
provisioningState	WorkspaceReplicationState	复制的预配状态。

WorkspaceReplicationState

枚举

复制的预配状态。

值	说明
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Object

工作区的 SKU。

名称	类型	说明
capacityReservationLevel	integer (int32)	选择 CapacityReservation sku 时，此工作区的容量预留级别为 GB。
lastSkuUpdate	string (date-time)	上次更新 SKU 的时间。
name	WorkspaceSkuNameEnum	SKU 的名称。

WorkspaceSkuNameEnum

枚举

SKU 的名称。

值	说明
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

通过

Workspaces - Create Or Update

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

WorkspacesCreate

示例请求

示例响应

定义

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum