Udostępnij przez


Workspaces - Update

Aktualizuje obszar roboczy.

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

Parametry URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

workspaceName
path True

string

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

Nazwa obszaru roboczego.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Ciało żądania

Nazwa Typ Opis
parameters

WorkspacePatch

Parametry wymagane do stosowania poprawek obszaru roboczego.

Odpowiedzi

Nazwa Typ Opis
200 OK

Workspace

Istniejący obszar roboczy został pomyślnie zaktualizowany. Sprawdź provisioningStatus , aby wyświetlić szczegółowy stan.

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: implicit
URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresów

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

WorkspacesPatch

Przykładowa prośba

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
createdByType

Typ tożsamości, która utworzyła zasób.

DataIngestionStatus

Stan pozyskiwania danych dla tego obszaru roboczego.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

Identity

Tożsamość zasobu.

PrivateLinkScopedResource

Lista połączonych zasobów zakresu łącza prywatnego.

PublicNetworkAccessType

Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics.

ResourceIdentityType

Typ tożsamości.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Workspace

Kontener zasobów obszaru roboczego najwyższego poziomu.

WorkspaceCapping

Dzienny limit ilości na potrzeby pozyskiwania.

WorkspaceEntityStatus

Stan aprowizacji obszaru roboczego.

WorkspaceFailoverProperties

właściwości trybu failover obszaru roboczego.

WorkspaceFailoverState

Stan pracy awaryjnej replikacji.

WorkspaceFeatures

Funkcje obszaru roboczego.

WorkspacePatch

Parametry wymagane do stosowania poprawek obszaru roboczego.

WorkspaceReplicationProperties

właściwości replikacji obszaru roboczego.

WorkspaceReplicationState

Stan aprowizacji replikacji.

WorkspaceSku

Jednostka SKU obszaru roboczego.

WorkspaceSkuNameEnum

Nazwa jednostki SKU.

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

DataIngestionStatus

Stan pozyskiwania danych dla tego obszaru roboczego.

Wartość Opis
RespectQuota

Pozyskiwanie włączone po zresetowaniu dziennego limitu przydziału lub włączeniu subskrypcji.

ForceOn

Pozyskiwanie rozpoczęło się po zmianie ustawień usługi.

ForceOff

Pozyskiwanie zostało zatrzymane po zmianie ustawień usługi.

OverQuota

Osiągnięto dzienny limit przydziału, przyjmowanie zostało zatrzymane.

SubscriptionSuspended

Pozyskiwanie zostało zatrzymane po zawieszeniu subskrypcji.

ApproachingQuota

Osiągnięto 80% dziennego limitu.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

Identity

Tożsamość zasobu.

Nazwa Typ Opis
principalId

string (uuid)

Identyfikator podmiotu zabezpieczeń tożsamości zasobu. Wartość musi być identyfikatorem UUID.

tenantId

string (uuid)

Identyfikator dzierżawy zasobu. Wartość musi być identyfikatorem UUID.

type

ResourceIdentityType

Typ tożsamości.

PrivateLinkScopedResource

Lista połączonych zasobów zakresu łącza prywatnego.

Nazwa Typ Opis
resourceId

string

Pełny identyfikator zasobu zakresu łącza prywatnego.

scopeId

string

Unikatowy identyfikator zakresu łącza prywatnego.

PublicNetworkAccessType

Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics.

Wartość Opis
Enabled

Umożliwia łączność z usługą Log Analytics za pośrednictwem publicznego systemu DNS.

Disabled

Wyłącza łączność publiczną z usługą Log Analytics za pośrednictwem publicznego systemu DNS.

SecuredByPerimeter

Zasób jest dostępny tylko z sieci prywatnych i dostępu zatwierdzonego przez obwód zabezpieczeń sieci skojarzony z tym zasobem.

ResourceIdentityType

Typ tożsamości.

Wartość Opis
SystemAssigned

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

Workspace

Kontener zasobów obszaru roboczego najwyższego poziomu.

Nazwa Typ Wartość domyślna Opis
etag

string

Element etag obszaru roboczego.

id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identity

Tożsamość zasobu.

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.createdDate

string (date-time)

Data utworzenia obszaru roboczego.

properties.customerId

string

Jest to właściwość tylko do odczytu. Reprezentuje identyfikator skojarzony z obszarem roboczym.

properties.defaultDataCollectionRuleResourceId

string

Identyfikator zasobu domyślnej reguły zbierania danych do użycia w tym obszarze roboczym. Oczekiwany format to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

właściwości trybu failover obszaru roboczego.

properties.features

WorkspaceFeatures

Funkcje obszaru roboczego.

properties.forceCmkForQuery

boolean

Wskazuje, czy magazyn zarządzany przez klienta jest obowiązkowy do zarządzania zapytaniami.

properties.modifiedDate

string (date-time)

Data modyfikacji przestrzeni roboczej.

properties.privateLinkScopedResources

PrivateLinkScopedResource[]

Lista połączonych zasobów zakresu łącza prywatnego.

properties.provisioningState

WorkspaceEntityStatus

Stan aprowizacji obszaru roboczego.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Typ dostępu do sieci na potrzeby uzyskiwania dostępu do zapytania usługi Log Analytics.

properties.replication

WorkspaceReplicationProperties

właściwości replikacji obszaru roboczego.

properties.retentionInDays

integer (int32)

Okres przechowywania danych obszaru roboczego w dniach. Dozwolone wartości są według planu cenowego. Aby uzyskać szczegółowe informacje, zobacz dokumentację warstw cenowych.

properties.sku

WorkspaceSku

Jednostka SKU obszaru roboczego.

properties.workspaceCapping

WorkspaceCapping

Dzienny limit ilości na potrzeby pozyskiwania.

systemData

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Dzienny limit ilości na potrzeby pozyskiwania.

Nazwa Typ Opis
dailyQuotaGb

number (double)

Dzienny limit przydziału obszaru roboczego na potrzeby pozyskiwania.

dataIngestionStatus

DataIngestionStatus

Stan pozyskiwania danych dla tego obszaru roboczego.

quotaNextResetTime

string

Czas, w którym limit przydziału będzie spoczynkiem.

WorkspaceEntityStatus

Stan aprowizacji obszaru roboczego.

Wartość Opis
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

właściwości trybu failover obszaru roboczego.

Nazwa Typ Opis
lastModifiedDate

string (date-time)

Ostatni czas aktualizacji stanu trybu failover.

state

WorkspaceFailoverState

Stan pracy awaryjnej replikacji.

WorkspaceFailoverState

Stan pracy awaryjnej replikacji.

Wartość Opis
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Funkcje obszaru roboczego.

Nazwa Typ Opis
associations

string[]

Lista powiązań dla obszaru roboczego. Wskazuje, czy obszar roboczy jest skojarzony z którymkolwiek z następujących środowisk: MDC, Sentinel, SentinelGraph itp.

clusterResourceId

string

Dedykowany identyfikator resourceId klastra la połączony z obszarami roboczymi.

disableLocalAuth

boolean

Wyłącz uwierzytelnianie oparte na usłudze AAD.

enableDataExport

boolean

Flaga wskazująca, czy dane mają być eksportowane.

enableLogAccessUsingOnlyResourcePermissions

boolean

Flaga wskazująca, które uprawnienie do użycia — zasób lub obszar roboczy lub oba te elementy.

immediatePurgeDataOn30Days

boolean

Flaga opisując, czy chcemy usunąć dane po 30 dniach.

unifiedSentinelBillingOnly

boolean

Wskazanie, czy określony obszar roboczy jest ograniczony tylko do ujednoliconego modelu rozliczeń usługi Sentinel.

WorkspacePatch

Parametry wymagane do stosowania poprawek obszaru roboczego.

Nazwa Typ Wartość domyślna Opis
etag

string

Zasób Etag.

id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Przykład - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identity

Tożsamość zasobu.

name

string

Nazwa zasobu

properties.createdDate

string (date-time)

Data utworzenia obszaru roboczego.

properties.customerId

string

Jest to właściwość tylko do odczytu. Reprezentuje identyfikator skojarzony z obszarem roboczym.

properties.defaultDataCollectionRuleResourceId

string

Identyfikator zasobu domyślnej reguły zbierania danych do użycia w tym obszarze roboczym. Oczekiwany format to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

właściwości trybu failover obszaru roboczego.

properties.features

WorkspaceFeatures

Funkcje obszaru roboczego.

properties.forceCmkForQuery

boolean

Wskazuje, czy magazyn zarządzany przez klienta jest obowiązkowy do zarządzania zapytaniami.

properties.modifiedDate

string (date-time)

Data modyfikacji przestrzeni roboczej.

properties.privateLinkScopedResources

PrivateLinkScopedResource[]

Lista połączonych zasobów zakresu łącza prywatnego.

properties.provisioningState

WorkspaceEntityStatus

Stan aprowizacji obszaru roboczego.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Typ dostępu do sieci na potrzeby uzyskiwania dostępu do zapytania usługi Log Analytics.

properties.replication

WorkspaceReplicationProperties

właściwości replikacji obszaru roboczego.

properties.retentionInDays

integer (int32)

Okres przechowywania danych obszaru roboczego w dniach. Dozwolone wartości są według planu cenowego. Aby uzyskać szczegółowe informacje, zobacz dokumentację warstw cenowych.

properties.sku

WorkspaceSku

Jednostka SKU obszaru roboczego.

properties.workspaceCapping

WorkspaceCapping

Dzienny limit ilości na potrzeby pozyskiwania.

tags

object

Tagi zasobów. Opcjonalny.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

WorkspaceReplicationProperties

właściwości replikacji obszaru roboczego.

Nazwa Typ Opis
createdDate

string (date-time)

Ostatni raz, kiedy replikacja była włączona.

enabled

boolean

Określa, czy replikacja jest włączona, czy nie. W przypadku wartości true konfiguracja i dane obszaru roboczego są replikowane do określonej lokalizacji. Jeśli włączono replikację, należy podać lokalizację.

lastModifiedDate

string (date-time)

Ostatni czas aktualizacji replikacji.

location

string

Lokalizacja replikacji.

provisioningState

WorkspaceReplicationState

Stan aprowizacji replikacji.

WorkspaceReplicationState

Stan aprowizacji replikacji.

Wartość Opis
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Jednostka SKU obszaru roboczego.

Nazwa Typ Opis
capacityReservationLevel

integer (int32)

Poziom rezerwacji pojemności w GB dla tego obszaru roboczego po wybraniu jednostki SKU CapacityReservation.

lastSkuUpdate

string (date-time)

Ostatni czas aktualizacji jednostki SKU.

name

WorkspaceSkuNameEnum

Nazwa jednostki SKU.

WorkspaceSkuNameEnum

Nazwa jednostki SKU.

Wartość Opis
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster