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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
path True

string (uuid)

A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.

workspaceName
path True

string

minLength: 4
maxLength: 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

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

WorkspaceFailoverProperties

munkaterület feladatátvételi tulajdonságai.

properties.features

WorkspaceFeatures

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

PublicNetworkAccessType

A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa.

properties.replication

WorkspaceReplicationProperties

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

WorkspaceSku

A munkaterület termékváltozata.

properties.workspaceCapping

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

Workspace

Az Azure-művelet sikeresen befejeződött.

Other Status Codes

ErrorResponse

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
createdByType

Az erőforrást létrehozó identitás típusa.

DataIngestionStatus

A munkaterület adatbetöltésének állapota.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

Identity

Az erőforrás identitása.

IdentityType

A felügyelt szolgáltatás identitásának típusa.

PrivateLinkScopedResource

A privát kapcsolat hatókörének erőforrás-referenciája.

PublicNetworkAccessType

A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

UserIdentityProperties

Felhasználó által hozzárendelt identitástulajdonságok.

Workspace

A legfelső szintű munkaterület-erőforrás-tároló.

WorkspaceCapping

A betöltés napi kötetkorlátja.

WorkspaceEntityStatus

A munkaterület kiépítési állapota.

WorkspaceFailoverProperties

A replikáció feladatátvételi állapota.

WorkspaceFailoverState

A replikáció feladatátvételi állapota.

WorkspaceFeatures

Munkaterületi funkciók.

WorkspacePatch

A legfelső szintű munkaterület-erőforrás-tároló.

WorkspaceReplicationProperties

Munkaterület-replikáció tulajdonságai.

WorkspaceReplicationState

A replikáció kiépítési állapota.

WorkspaceSku

A munkaterület termékváltozata (szintje).

WorkspaceSkuNameEnum

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

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

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

IdentityType

A felügyelt szolgáltatás identitásának típusa.

userAssignedIdentities

<string,  UserIdentityProperties>

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

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

createdByType

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

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

WorkspaceFailoverProperties

munkaterület feladatátvételi tulajdonságai.

properties.features

WorkspaceFeatures

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

PrivateLinkScopedResource[]

A csatolt privát kapcsolati hatókör erőforrásainak listája.

properties.provisioningState

WorkspaceEntityStatus

A munkaterület kiépítési állapota.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa.

properties.replication

WorkspaceReplicationProperties

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

WorkspaceSku

A munkaterület termékváltozata.

properties.workspaceCapping

WorkspaceCapping

A betöltés napi kötetkorlátja.

systemData

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

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

WorkspaceFailoverState

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

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

WorkspaceFailoverProperties

munkaterület feladatátvételi tulajdonságai.

properties.features

WorkspaceFeatures

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

PrivateLinkScopedResource[]

A csatolt privát kapcsolati hatókör erőforrásainak listája.

properties.provisioningState

WorkspaceEntityStatus

A munkaterület kiépítési állapota.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa.

properties.replication

WorkspaceReplicationProperties

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

WorkspaceSku

A munkaterület termékváltozata.

properties.workspaceCapping

WorkspaceCapping

A betöltés napi kötetkorlátja.

systemData

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

WorkspaceReplicationState

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

WorkspaceSkuNameEnum

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