Partilhar via


Workspaces - Update

Atualiza um espaço de trabalho.

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

Parâmetros URI

Nome Em Necessário Tipo Descrição
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 utilizar para esta operação.

Órgão do Pedido

Nome Tipo Descrição
parameters

WorkspacePatch

Os parâmetros necessários para corrigir um espaço de trabalho.

Respostas

Nome Tipo Descrição
200 OK

Workspace

O espaço de trabalho existente foi atualizado com êxito. Verifique provisioningStatus para ver o status detalhado.

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
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

WorkspacesPatch

Pedido de exemplo

PATCH 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,
    "workspaceCapping": {
      "dailyQuotaGb": -1
    }
  }
}

Resposta de exemplo

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled",
    "workspaceCapping": {
      "dailyQuotaGb": -1,
      "quotaNextResetTime": "Mon, 16 Nov 2020 15:00:00 GMT",
      "dataIngestionStatus": "RespectQuota"
    }
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Definições

Nome Descrição
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.

PrivateLinkScopedResource

Lista de recursos de escopo de link privado vinculados.

PublicNetworkAccessType

O tipo de acesso à rede para acessar a ingestão do Log Analytics.

ResourceIdentityType

O tipo de identidade.

systemData

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

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

propriedades de failover do espaço de trabalho.

WorkspaceFailoverState

O estado de failover da replicação.

WorkspaceFeatures

Recursos do espaço de trabalho.

WorkspacePatch

Os parâmetros necessários para corrigir um 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 do espaço de trabalho.

WorkspaceSkuNameEnum

O nome do SKU.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

DataIngestionStatus

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

Valor Descrição
RespectQuota

Ingestão ativada após redefinição de cota de limite diário ou ativação de assinatura.

ForceOn

A ingestão começou após a alteração da configuração do serviço.

ForceOff

A ingestão parou após a alteração da configuração do serviço.

OverQuota

Atingida a quota máxima diária, a ingestão parou.

SubscriptionSuspended

A ingestão parou após a suspensão da assinatura.

ApproachingQuota

80% da quota máxima diária atingida.

ErrorAdditionalInfo

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

Nome Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Descrição
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

Resposta de erro

Nome Tipo Descrição
error

ErrorDetail

O objeto de erro.

Identity

Identidade do recurso.

Nome Tipo Descrição
principalId

string (uuid)

A ID principal da identidade do recurso. O valor deve ser um UUID.

tenantId

string (uuid)

A ID do locatário do recurso. O valor deve ser um UUID.

type

ResourceIdentityType

O tipo de identidade.

PrivateLinkScopedResource

Lista de recursos de escopo de link privado vinculados.

Nome Tipo Descrição
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

O tipo de acesso à rede para acessar a ingestão do Log Analytics.

Valor Descrição
Enabled

Permite a conectividade com o Log Analytics por meio de DNS público.

Disabled

Desabilita a conectividade pública com o Log Analytics por meio de DNS público.

SecuredByPerimeter

O recurso só é acessível a partir de redes privadas e acesso aprovado pelo perímetro de segurança de rede associado a este recurso.

ResourceIdentityType

O tipo de identidade.

Valor Descrição
SystemAssigned

systemData

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

Nome Tipo Descrição
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.

Workspace

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

Nome Tipo Valor padrão Descrição
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, medida 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

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

Nome Tipo Descrição
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

O estado de provisionamento do espaço de trabalho.

Valor Descrição
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

propriedades de failover do espaço de trabalho.

Nome Tipo Descrição
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

O estado de failover da replicação.

Valor Descrição
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Recursos do espaço de trabalho.

Nome Tipo Descrição
associations

string[]

Lista de associações para o espaço de trabalho. Indica se o espaço de trabalho está associado a alguma das seguintes experiências: MDC, Sentinel, SentinelGraph, etc.

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.

WorkspacePatch

Os parâmetros necessários para corrigir um espaço de trabalho.

Nome Tipo Valor padrão Descrição
etag

string

Etag de recurso.

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.

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, medida 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. Opcional.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

WorkspaceReplicationProperties

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

Nome Tipo Descrição
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

O estado de provisionamento da replicação.

Valor Descrição
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

A SKU do espaço de trabalho.

Nome Tipo Descrição
capacityReservationLevel

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

O nome do SKU.

Valor Descrição
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster