Workspaces - Create Or Update

Referência

Serviço:: Log Analytics

Versão da API:: 2025-02-01

Crie ou atualize um espaço de trabalho.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	A ID da assinatura de destino.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	O nome do espaço de trabalho.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A geolocalização onde o recurso vive
etag		string	A etag do espaço de trabalho.
identity		Identity	A identidade do recurso.
properties.defaultDataCollectionRuleResourceId		string	A ID do recurso da Regra de Coleta de Dados padrão a ser usada para este espaço de trabalho. O formato esperado é - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover		WorkspaceFailoverProperties	propriedades de failover do espaço de trabalho.
properties.features		WorkspaceFeatures	Recursos do espaço de trabalho.
properties.forceCmkForQuery		boolean	Indica se o armazenamento gerenciado pelo cliente é obrigatório para o gerenciamento de consultas.
properties.publicNetworkAccessForIngestion		PublicNetworkAccessType	O tipo de acesso à rede para acessar a ingestão do Log Analytics.
properties.publicNetworkAccessForQuery		PublicNetworkAccessType	O tipo de acesso à rede para acessar a consulta do Log Analytics.
properties.replication		WorkspaceReplicationProperties	propriedades de replicação do espaço de trabalho.
properties.retentionInDays		integer (int32)	A retenção de dados do espaço de trabalho em dias. Os valores permitidos são por plano de preços. Consulte a documentação dos níveis de preços para obter detalhes.
properties.sku		WorkspaceSku	A SKU do espaço de trabalho.
properties.workspaceCapping		WorkspaceCapping	A tampa de volume diária para ingestão.
tags		object	Tags de recursos.

Respostas

Name	Tipo	Description
200 OK	Workspace	Definição de resposta OK.
201 Created	Workspace	Definição de resposta criada.
202 Accepted		Aceito
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

WorkspacesCreate

Pedido de amostra

HTTP

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

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Código de estado:: 202

Definições

Name	Description
CapacityReservationLevel	O nível de reserva de capacidade em GB para este espaço de trabalho, quando CapacityReservation sku é selecionado.
createdByType	O tipo de identidade que criou o recurso.
DataIngestionStatus	O status da ingestão de dados para este espaço de trabalho.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Identity	Identidade do recurso.
IdentityType	Tipo de identidade de serviço gerenciado.
PrivateLinkScopedResource	A referência de recurso de escopo de link privado.
PublicNetworkAccessType	O tipo de acesso à rede para operar no espaço de trabalho do Log Analytics. Por padrão, ele está habilitado
systemData	Metadados referentes à criação e última modificação do recurso.
UserIdentityProperties	Propriedades de identidade atribuídas pelo usuário.
Workspace	O contêiner de recursos de espaço de trabalho de nível superior.
WorkspaceCapping	A tampa de volume diária para ingestão.
WorkspaceEntityStatus	O estado de provisionamento do espaço de trabalho.
WorkspaceFailoverProperties	O estado de failover da replicação.
WorkspaceFailoverState	O estado de failover da replicação.
WorkspaceFeatures	Recursos do espaço de trabalho.
WorkspaceReplicationProperties	Propriedades de replicação do espaço de trabalho.
WorkspaceReplicationState	O estado de provisionamento da replicação.
WorkspaceSku	A SKU (camada) de um espaço de trabalho.
WorkspaceSkuNameEnum	O nome do SKU.

CapacityReservationLevel

Enumeração

O nível de reserva de capacidade em GB para este espaço de trabalho, quando CapacityReservation sku é selecionado.

Valor	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Enumeração

O status da ingestão de dados para este espaço de trabalho.

Valor	Description
ApproachingQuota	80% da quota máxima diária atingida.
ForceOff	A ingestão parou após a alteração da configuração do serviço.
ForceOn	A ingestão começou após a alteração da configuração do serviço.
OverQuota	Atingida a quota máxima diária, a ingestão parou.
RespectQuota	Ingestão ativada após redefinição de cota de limite diário ou ativação de assinatura.
SubscriptionSuspended	A ingestão parou após a suspensão da assinatura.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

Identity

Object

Identidade do recurso.

Name	Tipo	Description
principalId	string	A ID principal da identidade do recurso.
tenantId	string	A ID do locatário do recurso.
type	IdentityType	Tipo de identidade de serviço gerenciado.
userAssignedIdentities	<string, UserIdentityProperties>	A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Enumeração

Tipo de identidade de serviço gerenciado.

Valor	Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Object

A referência de recurso de escopo de link privado.

Name	Tipo	Description
resourceId	string	O ID de recurso completo do recurso de escopo de link privado.
scopeId	string	O identificador exclusivo do escopo do link privado.

PublicNetworkAccessType

Enumeração

O tipo de acesso à rede para operar no espaço de trabalho do Log Analytics. Por padrão, ele está habilitado

Valor	Description
Disabled	Desabilita a conectividade pública com o Log Analytics por meio de DNS público.
Enabled	Permite a conectividade com o Log Analytics por meio de DNS público.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UserIdentityProperties

Object

Propriedades de identidade atribuídas pelo usuário.

Name	Tipo	Description
clientId	string	O ID do cliente da identidade atribuída ao usuário.
principalId	string	O id principal da identidade atribuída ao usuário.

Workspace

Object

O contêiner de recursos de espaço de trabalho de nível superior.

Name	Tipo	Default value	Description
etag	string		A etag do espaço de trabalho.
id	string		ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		A identidade do recurso.
location	string		A geolocalização onde o recurso vive
name	string		O nome do recurso
properties.createdDate	string (date-time)		Data de criação do espaço de trabalho.
properties.customerId	string		Esta é uma propriedade somente leitura. Representa a ID associada ao espaço de trabalho.
properties.defaultDataCollectionRuleResourceId	string		A ID do recurso da Regra de Coleta de Dados padrão a ser usada para este espaço de trabalho. O formato esperado é - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		propriedades de failover do espaço de trabalho.
properties.features	WorkspaceFeatures		Recursos do espaço de trabalho.
properties.forceCmkForQuery	boolean		Indica se o armazenamento gerenciado pelo cliente é obrigatório para o gerenciamento de consultas.
properties.modifiedDate	string (date-time)		Data de modificação do espaço de trabalho.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Lista de recursos de escopo de link privado vinculados.
properties.provisioningState	WorkspaceEntityStatus		O estado de provisionamento do espaço de trabalho.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	O tipo de acesso à rede para acessar a ingestão do Log Analytics.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	O tipo de acesso à rede para acessar a consulta do Log Analytics.
properties.replication	WorkspaceReplicationProperties		propriedades de replicação do espaço de trabalho.
properties.retentionInDays	integer (int32)		A retenção de dados do espaço de trabalho em dias. Os valores permitidos são por plano de preços. Consulte a documentação dos níveis de preços para obter detalhes.
properties.sku	WorkspaceSku		A SKU do espaço de trabalho.
properties.workspaceCapping	WorkspaceCapping		A tampa de volume diária para ingestão.
systemData	systemData		Metadados referentes à criação e última modificação do recurso.
tags	object		Tags de recursos.
type	string		O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Object

A tampa de volume diária para ingestão.

Name	Tipo	Description
dailyQuotaGb	number (double)	A quota diária do espaço de trabalho para ingestão.
dataIngestionStatus	DataIngestionStatus	O status da ingestão de dados para este espaço de trabalho.
quotaNextResetTime	string	O tempo em que a cota será de descanso.

WorkspaceEntityStatus

Enumeração

O estado de provisionamento do espaço de trabalho.

Valor	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Object

O estado de failover da replicação.

Name	Tipo	Description
lastModifiedDate	string (date-time)	A última vez em que o estado de failover foi atualizado.
state	WorkspaceFailoverState	O estado de failover da replicação.

WorkspaceFailoverState

Enumeração

O estado de failover da replicação.

Valor	Description
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Object

Recursos do espaço de trabalho.

Name	Tipo	Description
clusterResourceId	string	ResourceId de cluster LA dedicado que está vinculado aos espaços de trabalho.
disableLocalAuth	boolean	Desative a autenticação não baseada em AAD.
enableDataExport	boolean	Sinalizador que indica se os dados devem ser exportados.
enableLogAccessUsingOnlyResourcePermissions	boolean	Sinalizador que indica qual permissão usar - recurso ou espaço de trabalho ou ambos.
immediatePurgeDataOn30Days	boolean	Sinalizador que descreve se queremos remover os dados após 30 dias.
unifiedSentinelBillingOnly	boolean	Uma indicação se o espaço de trabalho de especificação está limitado apenas ao modelo de faturamento unificado do sentinel.

WorkspaceReplicationProperties

Object

Propriedades de replicação do espaço de trabalho.

Name	Tipo	Description
createdDate	string (date-time)	A última vez em que a replicação foi habilitada.
enabled	boolean	Especifica se a replicação está habilitada ou não. Quando verdadeiro, a configuração e os dados do espaço de trabalho são replicados para o local especificado. Se a replicação estiver habilitada, o local deverá ser fornecido.
lastModifiedDate	string (date-time)	A última vez em que a replicação foi atualizada.
location	string	O local da replicação.
provisioningState	WorkspaceReplicationState	O estado de provisionamento da replicação.

WorkspaceReplicationState

Enumeração

O estado de provisionamento da replicação.

Valor	Description
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Object

A SKU (camada) de um espaço de trabalho.

Name	Tipo	Description
capacityReservationLevel	CapacityReservationLevel (int32)	O nível de reserva de capacidade em GB para este espaço de trabalho, quando CapacityReservation sku é selecionado.
lastSkuUpdate	string (date-time)	A última vez em que o sku foi atualizado.
name	WorkspaceSkuNameEnum	O nome do SKU.

WorkspaceSkuNameEnum

Enumeração

O nome do SKU.

Valor	Description
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

Partilhar via

Workspaces - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

WorkspacesCreate

Pedido de amostra

Resposta da amostra

Definições

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Recursos adicionais