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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string minLength: 1 |
Identyfikator subskrypcji docelowej. |
|
workspace
|
path | True |
string minLength: 4maxLength: 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 |
Parametry wymagane do stosowania poprawek obszaru roboczego. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Istniejący obszar roboczy został pomyślnie zaktualizowany. Sprawdź provisioningStatus , aby wyświetlić szczegółowy stan. |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Data |
Stan pozyskiwania danych dla tego obszaru roboczego. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
| Identity |
Tożsamość zasobu. |
|
Private |
Lista połączonych zasobów zakresu łącza prywatnego. |
|
Public |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics. |
|
Resource |
Typ tożsamości. |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
| Workspace |
Kontener zasobów obszaru roboczego najwyższego poziomu. |
|
Workspace |
Dzienny limit ilości na potrzeby pozyskiwania. |
|
Workspace |
Stan aprowizacji obszaru roboczego. |
|
Workspace |
właściwości trybu failover obszaru roboczego. |
|
Workspace |
Stan pracy awaryjnej replikacji. |
|
Workspace |
Funkcje obszaru roboczego. |
|
Workspace |
Parametry wymagane do stosowania poprawek obszaru roboczego. |
|
Workspace |
właściwości replikacji obszaru roboczego. |
|
Workspace |
Stan aprowizacji replikacji. |
|
Workspace |
Jednostka SKU obszaru roboczego. |
|
Workspace |
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 |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
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 |
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 |
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 |
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 |
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 |
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 |
właściwości trybu failover obszaru roboczego. |
||
| properties.features |
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 |
Lista połączonych zasobów zakresu łącza prywatnego. |
||
| properties.provisioningState |
Stan aprowizacji obszaru roboczego. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do zapytania usługi Log Analytics. |
|
| properties.replication |
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 |
Jednostka SKU obszaru roboczego. |
||
| properties.workspaceCapping |
Dzienny limit ilości na potrzeby pozyskiwania. |
||
| 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 |
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 |
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 |
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 |
właściwości trybu failover obszaru roboczego. |
||
| properties.features |
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 |
Lista połączonych zasobów zakresu łącza prywatnego. |
||
| properties.provisioningState |
Stan aprowizacji obszaru roboczego. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do zapytania usługi Log Analytics. |
|
| properties.replication |
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 |
Jednostka SKU obszaru roboczego. |
||
| properties.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 |
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 |
Nazwa jednostki SKU. |
WorkspaceSkuNameEnum
Nazwa jednostki SKU.
| Wartość | Opis |
|---|---|
| Free | |
| Standard | |
| Premium | |
| PerNode | |
| PerGB2018 | |
| Standalone | |
| CapacityReservation | |
| LACluster |