Workspaces - Update
Munkaterület frissítése.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-07-01
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
subscription
|
path | True |
string (uuid) |
A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie. |
|
workspace
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
A munkaterület neve. |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Kérelem törzse
| Name | Típus | Description |
|---|---|---|
| identity |
Az erőforrás identitása. |
|
| properties.defaultDataCollectionRuleResourceId |
string |
A munkaterülethez használandó alapértelmezett adatgyűjtési szabály erőforrás-azonosítója. A várt formátum : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
| properties.failover |
munkaterület feladatátvételi tulajdonságai. |
|
| properties.features |
Munkaterületi funkciók. |
|
| properties.forceCmkForQuery |
boolean |
Azt jelzi, hogy az ügyfél által felügyelt tárolás kötelező-e a lekérdezéskezeléshez. |
| properties.publicNetworkAccessForIngestion |
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa. |
|
| properties.publicNetworkAccessForQuery |
A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa. |
|
| properties.replication |
munkaterület replikációs tulajdonságai. |
|
| properties.retentionInDays |
integer (int32) |
A munkaterület adatmegőrzési ideje napokban. Az engedélyezett értékek tarifacsomagonként vannak megadva. Részletekért tekintse meg a tarifacsomagok dokumentációját. |
| properties.sku |
A munkaterület termékváltozata. |
|
| properties.workspaceCapping |
A betöltés napi kötetkorlátja. |
|
| tags |
object |
Erőforráscímkék. Opcionális. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Az Azure-művelet sikeresen befejeződött. |
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Name | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
WorkspacesPatch
Mintakérelem
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
}
}
}
Mintaválasz
{
"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"
}
}
Definíciók
| Name | Description |
|---|---|
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Data |
A munkaterület adatbetöltésének állapota. |
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
| Identity |
Az erőforrás identitása. |
|
Identity |
A felügyelt szolgáltatás identitásának típusa. |
|
Private |
A privát kapcsolat hatókörének erőforrás-referenciája. |
|
Public |
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa. |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
|
User |
Felhasználó által hozzárendelt identitástulajdonságok. |
| Workspace |
A legfelső szintű munkaterület-erőforrás-tároló. |
|
Workspace |
A betöltés napi kötetkorlátja. |
|
Workspace |
A munkaterület kiépítési állapota. |
|
Workspace |
A replikáció feladatátvételi állapota. |
|
Workspace |
A replikáció feladatátvételi állapota. |
|
Workspace |
Munkaterületi funkciók. |
|
Workspace |
A legfelső szintű munkaterület-erőforrás-tároló. |
|
Workspace |
Munkaterület-replikáció tulajdonságai. |
|
Workspace |
A replikáció kiépítési állapota. |
|
Workspace |
A munkaterület termékváltozata (szintje). |
|
Workspace |
Az termékváltozat neve. |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataIngestionStatus
A munkaterület adatbetöltésének állapota.
| Érték | Description |
|---|---|
| RespectQuota |
A betöltés engedélyezve a napi felső kvóta alaphelyzetbe állítása vagy az előfizetés engedélyezése után. |
| ForceOn |
A betöltés a szolgáltatásbeállítás módosítását követően kezdődött. |
| ForceOff |
A betöltés leállt a szolgáltatásbeállítás módosítása után. |
| OverQuota |
Elérte a napi felső kvótát, a betöltés leállt. |
| SubscriptionSuspended |
A felfüggesztett előfizetés után leállt a betöltés. |
| ApproachingQuota |
A napi felső korlát 80% kvótáját érte el. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
| Name | Típus | Description |
|---|---|---|
| info |
object |
A további információk. |
| type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
| Name | Típus | Description |
|---|---|---|
| additionalInfo |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
| Name | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
Identity
Az erőforrás identitása.
| Name | Típus | Description |
|---|---|---|
| principalId |
string |
Az erőforrás-identitás egyszerű azonosítója. |
| tenantId |
string |
Az erőforrás bérlőazonosítója. |
| type |
A felügyelt szolgáltatás identitásának típusa. |
|
| userAssignedIdentities |
<string,
User |
Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai arm-erőforrás-azonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
IdentityType
A felügyelt szolgáltatás identitásának típusa.
| Érték | Description |
|---|---|
| SystemAssigned |
Rendszer Által Hozzárendelve |
| UserAssigned |
UserAssigned |
| None |
Egyik sem |
PrivateLinkScopedResource
A privát kapcsolat hatókörének erőforrás-referenciája.
| Name | Típus | Description |
|---|---|---|
| resourceId |
string |
A privát kapcsolat hatókörének erőforrásának teljes erőforrás-azonosítója. |
| scopeId |
string |
A privát kapcsolat hatókörének egyedi azonosítója. |
PublicNetworkAccessType
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.
| Érték | Description |
|---|---|
| Enabled |
Lehetővé teszi a Log Analyticshez való csatlakozást nyilvános DNS-en keresztül. |
| Disabled |
Letiltja a nyilvános kapcsolatot a Log Analyticshez nyilvános DNS-en keresztül. |
| SecuredByPerimeter |
Az erőforrás csak magánhálózatokról érhető el, és az erőforráshoz társított hálózati biztonsági szegélyhálózat által jóváhagyott hozzáférés. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
| Name | Típus | Description |
|---|---|---|
| createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
| createdBy |
string |
Az erőforrást létrehozó identitás. |
| createdByType |
Az erőforrást létrehozó identitás típusa. |
|
| lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
| lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
| lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
UserIdentityProperties
Felhasználó által hozzárendelt identitástulajdonságok.
| Name | Típus | Description |
|---|---|---|
| clientId |
string |
A felhasználó által hozzárendelt identitás ügyfélazonosítója. |
| principalId |
string |
A felhasználó által hozzárendelt identitás egyszerű azonosítója. |
Workspace
A legfelső szintű munkaterület-erőforrás-tároló.
| Name | Típus | Alapértelmezett érték | Description |
|---|---|---|---|
| etag |
string |
A munkaterület etagje. |
|
| id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Az erőforrás identitása. |
||
| location |
string |
Az a földrajzi hely, ahol az erőforrás él |
|
| name |
string |
Az erőforrás neve |
|
| properties.createdDate |
string (date-time) |
Munkaterület létrehozásának dátuma. |
|
| properties.customerId |
string |
Ez egy csak olvasható tulajdonság. A munkaterülethez társított azonosítót jelöli. |
|
| properties.defaultDataCollectionRuleResourceId |
string |
A munkaterülethez használandó alapértelmezett adatgyűjtési szabály erőforrás-azonosítója. A várt formátum : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
munkaterület feladatátvételi tulajdonságai. |
||
| properties.features |
Munkaterületi funkciók. |
||
| properties.forceCmkForQuery |
boolean |
Azt jelzi, hogy az ügyfél által felügyelt tárolás kötelező-e a lekérdezéskezeléshez. |
|
| properties.modifiedDate |
string (date-time) |
Munkaterület módosításának dátuma. |
|
| properties.privateLinkScopedResources |
A csatolt privát kapcsolati hatókör erőforrásainak listája. |
||
| properties.provisioningState |
A munkaterület kiépítési állapota. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa. |
|
| properties.publicNetworkAccessForQuery | Enabled |
A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa. |
|
| properties.replication |
munkaterület replikációs tulajdonságai. |
||
| properties.retentionInDays |
integer (int32) |
A munkaterület adatmegőrzési ideje napokban. Az engedélyezett értékek tarifacsomagonként vannak megadva. Részletekért tekintse meg a tarifacsomagok dokumentációját. |
|
| properties.sku |
A munkaterület termékváltozata. |
||
| properties.workspaceCapping |
A betöltés napi kötetkorlátja. |
||
| systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
||
| tags |
object |
Erőforráscímkék. |
|
| type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
WorkspaceCapping
A betöltés napi kötetkorlátja.
| Name | Típus | Description |
|---|---|---|
| dailyQuotaGb |
number (double) |
A munkaterület napi betöltési kvótája. |
| dataIngestionStatus |
A munkaterület adatbetöltésének állapota. |
|
| quotaNextResetTime |
string |
Az az idő, amikor a kvóta nyugalmi állapotban lesz. |
WorkspaceEntityStatus
A munkaterület kiépítési állapota.
| Érték | Description |
|---|---|
| Creating |
Készítés |
| Succeeded |
Sikerült |
| Failed |
Sikertelen |
| Canceled |
Visszavont |
| Deleting |
Törlés |
| ProvisioningAccount |
ProvisioningAccount |
| Updating |
Frissítés |
WorkspaceFailoverProperties
A replikáció feladatátvételi állapota.
| Name | Típus | Description |
|---|---|---|
| lastModifiedDate |
string (date-time) |
A feladatátvételi állapot utolsó frissítése. |
| state |
A replikáció feladatátvételi állapota. |
WorkspaceFailoverState
A replikáció feladatátvételi állapota.
| Érték | Description |
|---|---|
| Inactive |
Inaktív |
| Activating |
Aktiválás |
| Active |
Aktív |
| Deactivating |
Inaktiválás |
| Failed |
Sikertelen |
WorkspaceFeatures
Munkaterületi funkciók.
| Name | Típus | Description |
|---|---|---|
| associations |
string[] |
A munkaterület társításainak listája. Azt jelzi, hogy a munkaterület társítva van-e a következő élmények valamelyikéhez: MDC, Sentinel, SentinelGraph stb. |
| clusterResourceId |
string |
Dedikált LA-fürt resourceId azonosítója, amely a munkaterületekhez van csatolva. |
| disableLocalAuth |
boolean |
Tiltsa le a nem AAD-alapú hitelesítést. |
| enableDataExport |
boolean |
Az adatok exportálását jelző jelző. |
| enableLogAccessUsingOnlyResourcePermissions |
boolean |
A használati engedélyt jelző jelölő – erőforrás vagy munkaterület vagy mindkettő. |
| immediatePurgeDataOn30Days |
boolean |
Jelölő, amely leírja, hogy 30 nap után el szeretnénk-e távolítani az adatokat. |
| unifiedSentinelBillingOnly |
boolean |
Annak jelzése, hogy a megadott munkaterület csak a sentinel egységes számlázási modelljére korlátozódik-e. |
WorkspacePatch
A legfelső szintű munkaterület-erőforrás-tároló.
| Name | Típus | Alapértelmezett érték | Description |
|---|---|---|---|
| etag |
string |
Erőforráscímke. |
|
| id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Az erőforrás identitása. |
||
| name |
string |
Az erőforrás neve |
|
| properties.createdDate |
string (date-time) |
Munkaterület létrehozásának dátuma. |
|
| properties.customerId |
string |
Ez egy csak olvasható tulajdonság. A munkaterülethez társított azonosítót jelöli. |
|
| properties.defaultDataCollectionRuleResourceId |
string |
A munkaterülethez használandó alapértelmezett adatgyűjtési szabály erőforrás-azonosítója. A várt formátum : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
munkaterület feladatátvételi tulajdonságai. |
||
| properties.features |
Munkaterületi funkciók. |
||
| properties.forceCmkForQuery |
boolean |
Azt jelzi, hogy az ügyfél által felügyelt tárolás kötelező-e a lekérdezéskezeléshez. |
|
| properties.modifiedDate |
string (date-time) |
Munkaterület módosításának dátuma. |
|
| properties.privateLinkScopedResources |
A csatolt privát kapcsolati hatókör erőforrásainak listája. |
||
| properties.provisioningState |
A munkaterület kiépítési állapota. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa. |
|
| properties.publicNetworkAccessForQuery | Enabled |
A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa. |
|
| properties.replication |
munkaterület replikációs tulajdonságai. |
||
| properties.retentionInDays |
integer (int32) |
A munkaterület adatmegőrzési ideje napokban. Az engedélyezett értékek tarifacsomagonként vannak megadva. Részletekért tekintse meg a tarifacsomagok dokumentációját. |
|
| properties.sku |
A munkaterület termékváltozata. |
||
| properties.workspaceCapping |
A betöltés napi kötetkorlátja. |
||
| systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
||
| tags |
object |
Erőforráscímkék. Opcionális. |
|
| type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
WorkspaceReplicationProperties
Munkaterület-replikáció tulajdonságai.
| Name | Típus | Description |
|---|---|---|
| createdDate |
string (date-time) |
A replikáció utolsó engedélyezése. |
| enabled |
boolean |
Megadja, hogy a replikáció engedélyezve van-e. Ha igaz, a munkaterület konfigurációja és adatai a megadott helyre replikálódnak. Ha a replikáció engedélyezve van, meg kell adni a helyet. |
| lastModifiedDate |
string (date-time) |
A replikáció utolsó frissítése. |
| location |
string |
A replikáció helye. |
| provisioningState |
A replikáció kiépítési állapota. |
WorkspaceReplicationState
A replikáció kiépítési állapota.
| Érték | Description |
|---|---|
| Succeeded |
Sikerült |
| EnableRequested |
EnableRequested |
| Enabling |
Engedélyezés |
| DisableRequested |
DisableRequested |
| Disabling |
Letiltása |
| RollbackRequested |
Visszafordulás kért |
| RollingBack |
RollingBack |
| Failed |
Sikertelen |
| Canceled |
Visszavont |
WorkspaceSku
A munkaterület termékváltozata (szintje).
| Name | Típus | Description |
|---|---|---|
| capacityReservationLevel |
integer (int32) |
A kapacitásfoglalás szintje GB-ban ezen a munkaterületen, amikor a CapacityReservation termékváltozat ki van választva. |
| lastSkuUpdate |
string (date-time) |
Az utolsó alkalom, amikor a termékváltozat frissült. |
| name |
Az termékváltozat neve. |
WorkspaceSkuNameEnum
Az termékváltozat neve.
| Érték | Description |
|---|---|
| Free |
Ingyenes |
| Standard |
Standard |
| Premium |
prémium |
| PerNode |
PerNode |
| PerGB2018 |
PerGB2018 |
| Standalone |
Önálló rendszer |
| CapacityReservation |
Kapacitásfoglalás |
| LACluster |
LACluster |