Workspaces - Update
Atualiza um workspace.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-07-01
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string (uuid) |
A ID da assinatura de destino. O valor deve ser uma UUID. |
|
workspace
|
path | True |
string minLength: 4maxLength: 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 da solicitação
| Nome | Tipo | Description |
|---|---|---|
| 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 workspace. O formato esperado é - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
| properties.failover |
propriedades de failover do workspace. |
|
| properties.features |
Recursos do workspace. |
|
| properties.forceCmkForQuery |
boolean |
Indica se o armazenamento gerenciado pelo cliente é obrigatório para o gerenciamento de consultas. |
| properties.publicNetworkAccessForIngestion |
O tipo de acesso à rede para acessar a ingestão do Log Analytics. |
|
| properties.publicNetworkAccessForQuery |
O tipo de acesso à rede para acessar a consulta do Log Analytics. |
|
| properties.replication |
propriedades de replicação do workspace. |
|
| properties.retentionInDays |
integer (int32) |
A retenção de dados do workspace em dias. Os valores permitidos são por plano de preços. Consulte a documentação dos tipos de preços para obter detalhes. |
| properties.sku |
A SKU do workspace. |
|
| properties.workspaceCapping |
O limite de volume diário para ingestão. |
|
| tags |
object |
Tags de recursos. Optional. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
A operação do Azure foi concluída com êxito. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome | Description |
|---|---|
| user_impersonation | representar sua conta de usuário |
Exemplos
WorkspacesPatch
Solicitação de exemplo
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01
{
"properties": {
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
},
"workspaceCapping": {
"dailyQuotaGb": -1
}
}
}
Resposta de exemplo
{
"location": "australiasoutheast",
"properties": {
"publicNetworkAccessForIngestion": "Enabled",
"publicNetworkAccessForQuery": "Enabled",
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
},
"workspaceCapping": {
"dailyQuotaGb": -1,
"dataIngestionStatus": "RespectQuota",
"quotaNextResetTime": "Mon, 16 Nov 2020 15:00:00 GMT"
}
},
"tags": {
"tag1": "val1"
}
}
Definições
| Nome | Description |
|---|---|
|
created |
O tipo de identidade que criou o recurso. |
|
Data |
O status da ingestão de dados para este workspace. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
| Identity |
Identidade do recurso. |
|
Identity |
Tipo de identidade de serviço gerenciado. |
|
Private |
A referência de recurso de escopo de link privado. |
|
Public |
O tipo de acesso à rede para acessar a ingestão do Log Analytics. |
|
system |
Metadados relativos à criação e última modificação do recurso. |
|
User |
Propriedades de identidade atribuídas pelo usuário. |
| Workspace |
O contêiner de recursos do Workspace de nível superior. |
|
Workspace |
O limite de volume diário para ingestão. |
|
Workspace |
O estado de provisionamento do workspace. |
|
Workspace |
O estado de failover da replicação. |
|
Workspace |
O estado de failover da replicação. |
|
Workspace |
Recursos do workspace. |
|
Workspace |
O contêiner de recursos do Workspace de nível superior. |
|
Workspace |
Propriedades de replicação do workspace. |
|
Workspace |
O estado de provisionamento da replicação. |
|
Workspace |
A SKU (camada) de um workspace. |
|
Workspace |
O nome da SKU. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataIngestionStatus
O status da ingestão de dados para este workspace.
| Valor | Description |
|---|---|
| RespectQuota |
Ingestão habilitada após a redefinição da cota de limite diário ou a ativação da assinatura. |
| ForceOn |
A ingestão começou após a alteração da configuração do serviço. |
| ForceOff |
A ingestão foi interrompida após a alteração da configuração do serviço. |
| OverQuota |
Atingiu a cota de limite diário, a ingestão parou. |
| SubscriptionSuspended |
A ingestão foi interrompida após a suspensão da assinatura. |
| ApproachingQuota |
80% da cota diária de limite atingida. |
ErrorAdditionalInfo
As informações adicionais do erro de gerenciamento de recursos.
| Nome | Tipo | Description |
|---|---|---|
| info |
object |
As informações adicionais. |
| type |
string |
O tipo de informação adicional. |
ErrorDetail
O detalhe do erro.
| Nome | Tipo | Description |
|---|---|---|
| additionalInfo |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
Identity
Identidade do recurso.
| Nome | Tipo | Description |
|---|---|---|
| principalId |
string |
A ID principal da identidade do recurso. |
| tenantId |
string |
A ID do locatário do recurso. |
| type |
Tipo de identidade de serviço gerenciado. |
|
| userAssignedIdentities |
<string,
User |
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 do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
IdentityType
Tipo de identidade de serviço gerenciado.
| Valor | Description |
|---|---|
| SystemAssigned |
SystemAssigned |
| UserAssigned |
UserAssigned |
| None |
None |
PrivateLinkScopedResource
A referência de recurso de escopo de link privado.
| Nome | Tipo | Description |
|---|---|---|
| resourceId |
string |
A ID completa 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 | Description |
|---|---|
| Enabled |
Habilita a conectividade com o Log Analytics por meio do DNS público. |
| Disabled |
Desabilita a conectividade pública com o Log Analytics por meio do DNS público. |
| SecuredByPerimeter |
O recurso só pode ser acessado de redes privadas e o acesso é aprovado pelo perímetro de segurança de rede associado a esse recurso. |
systemData
Metadados relativos à criação e última modificação do recurso.
| Nome | 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 |
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 |
O tipo de identidade que modificou o recurso pela última vez. |
UserIdentityProperties
Propriedades de identidade atribuídas pelo usuário.
| Nome | Tipo | Description |
|---|---|---|
| clientId |
string |
A ID do cliente da identidade atribuída pelo usuário. |
| principalId |
string |
A ID principal da identidade atribuída pelo usuário. |
Workspace
O contêiner de recursos do Workspace de nível superior.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| etag |
string |
A etag do workspace. |
|
| id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
A identidade do recurso. |
||
| location |
string |
A localização geográfica onde o recurso reside |
|
| 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 workspace. O formato esperado é - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
propriedades de failover do workspace. |
||
| properties.features |
Recursos do workspace. |
||
| 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 |
Lista de recursos de escopo de link privado vinculado. |
||
| properties.provisioningState |
O estado de provisionamento do workspace. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
O tipo de acesso à rede para acessar a ingestão do Log Analytics. |
|
| properties.publicNetworkAccessForQuery | Enabled |
O tipo de acesso à rede para acessar a consulta do Log Analytics. |
|
| properties.replication |
propriedades de replicação do workspace. |
||
| properties.retentionInDays |
integer (int32) |
A retenção de dados do workspace em dias. Os valores permitidos são por plano de preços. Consulte a documentação dos tipos de preços para obter detalhes. |
|
| properties.sku |
A SKU do workspace. |
||
| properties.workspaceCapping |
O limite de volume diário para ingestão. |
||
| systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
||
| tags |
object |
Tags de recursos. |
|
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
WorkspaceCapping
O limite de volume diário para ingestão.
| Nome | Tipo | Description |
|---|---|---|
| dailyQuotaGb |
number (double) |
A cota diária do workspace para ingestão. |
| dataIngestionStatus |
O status da ingestão de dados para este workspace. |
|
| quotaNextResetTime |
string |
A hora em que a cota será de descanso. |
WorkspaceEntityStatus
O estado de provisionamento do workspace.
| Valor | Description |
|---|---|
| Creating |
Criando |
| Succeeded |
Succeeded |
| Failed |
Falha |
| Canceled |
Cancelado |
| Deleting |
Excluir |
| ProvisioningAccount |
ProvisioningAccount |
| Updating |
Atualização |
WorkspaceFailoverProperties
O estado de failover da replicação.
| Nome | Tipo | Description |
|---|---|---|
| lastModifiedDate |
string (date-time) |
A última vez em que o estado de failover foi atualizado. |
| state |
O estado de failover da replicação. |
WorkspaceFailoverState
O estado de failover da replicação.
| Valor | Description |
|---|---|
| Inactive |
Inativo |
| Activating |
Ativando |
| Active |
Ativo |
| Deactivating |
Desativando |
| Failed |
Falha |
WorkspaceFeatures
Recursos do workspace.
| Nome | Tipo | Description |
|---|---|---|
| associations |
string[] |
Lista de associações para o espaço de trabalho. Indica se o workspace está associado a qualquer uma das seguintes experiências: MDC, Sentinel, SentinelGraph etc. |
| clusterResourceId |
string |
ResourceId de cluster la dedicado que está vinculado aos workspaces. |
| disableLocalAuth |
boolean |
Desabilite a autenticação não baseada no AAD. |
| enableDataExport |
boolean |
Sinalizador que indica se os dados devem ser exportados. |
| enableLogAccessUsingOnlyResourcePermissions |
boolean |
Sinalizador que indica qual permissão usar – recurso ou workspace ou ambos. |
| immediatePurgeDataOn30Days |
boolean |
Sinalizador que descreve se queremos remover os dados após 30 dias. |
| unifiedSentinelBillingOnly |
boolean |
Uma indicação se o workspace especificado está limitado apenas ao modelo de cobrança unificado do sentinel. |
WorkspacePatch
O contêiner de recursos do Workspace de nível superior.
| Nome | Tipo | Valor padrão | Description |
|---|---|---|---|
| etag |
string |
Etag de recurso. |
|
| id |
string (arm-id) |
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| 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 workspace. O formato esperado é - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
propriedades de failover do workspace. |
||
| properties.features |
Recursos do workspace. |
||
| 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 |
Lista de recursos de escopo de link privado vinculado. |
||
| properties.provisioningState |
O estado de provisionamento do workspace. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
O tipo de acesso à rede para acessar a ingestão do Log Analytics. |
|
| properties.publicNetworkAccessForQuery | Enabled |
O tipo de acesso à rede para acessar a consulta do Log Analytics. |
|
| properties.replication |
propriedades de replicação do workspace. |
||
| properties.retentionInDays |
integer (int32) |
A retenção de dados do workspace em dias. Os valores permitidos são por plano de preços. Consulte a documentação dos tipos de preços para obter detalhes. |
|
| properties.sku |
A SKU do workspace. |
||
| properties.workspaceCapping |
O limite de volume diário para ingestão. |
||
| systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
||
| tags |
object |
Tags de recursos. Optional. |
|
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
WorkspaceReplicationProperties
Propriedades de replicação do workspace.
| Nome | 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 true, a configuração e os dados do workspace 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 |
O estado de provisionamento da replicação. |
WorkspaceReplicationState
O estado de provisionamento da replicação.
| Valor | Description |
|---|---|
| Succeeded |
Succeeded |
| EnableRequested |
EnableRequested |
| Enabling |
Habilitando |
| DisableRequested |
DisableRequested |
| Disabling |
Desabilitar |
| RollbackRequested |
ReverterSolicitado |
| RollingBack |
RollingBack |
| Failed |
Falha |
| Canceled |
Cancelado |
WorkspaceSku
A SKU (camada) de um workspace.
| Nome | Tipo | Description |
|---|---|---|
| capacityReservationLevel |
integer (int32) |
O nível de reserva de capacidade em GB para esse workspace, quando o sku CapacityReservation é selecionado. |
| lastSkuUpdate |
string (date-time) |
A última vez em que o sku foi atualizado. |
| name |
O nome da SKU. |
WorkspaceSkuNameEnum
O nome da SKU.
| Valor | Description |
|---|---|
| Free |
Gratuito |
| Standard |
Standard |
| Premium |
Premium |
| PerNode |
PerNode |
| PerGB2018 |
PerGB2018 |
| Standalone |
Autônomo |
| CapacityReservation |
Reservas de Capacidade |
| LACluster |
LACluster |