Workspaces - Create Or Update

Referencia

Szolgáltatás:: Log Analytics

API-verzió:: 2025-02-01

Munkaterület létrehozása vagy frissítése.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-02-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 minLength: 1	A cél-előfizetés azonosítója.
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álni kívánt API-verzió.

Kérelem törzse

Name	Kötelező	Típus	Description
location	True	string	Az a földrajzi hely, ahol az erőforrás él
etag		string	A munkaterület etagje.
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.

Válaszok

Name	Típus	Description
200 OK	Workspace	OK válaszdefiníció.
201 Created	Workspace	Válaszdefiníciót hozott létre.
202 Accepted		Elfogadott
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

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

WorkspacesCreate

Mintakérelem

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-02-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Mintaválasz

Állapotkód:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

Állapotkód:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
  "name": "AzTest2170",
  "type": "Microsoft.OperationalInsights/workspaces",
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  },
  "properties": {
    "customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
    "provisioningState": "Creating",
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled"
  }
}

Állapotkód:: 202

Definíciók

Name	Description
CapacityReservationLevel	A kapacitásfoglalás szintje GB-ban ezen a munkaterületen, amikor a CapacityReservation termékváltozat ki van választva.
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-munkaterületen való üzemeltetés hálózati hozzáférési típusa. Alapértelmezés szerint engedélyezve van
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ástárolója.
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.
WorkspaceReplicationProperties	Munkaterület replikációs 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.

CapacityReservationLevel

Enumerálás

A kapacitásfoglalás szintje GB-ban ezen a munkaterületen, amikor a CapacityReservation termékváltozat ki van választva.

Érték	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Enumerálás

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

Érték	Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Enumerálás

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

Érték	Description
ApproachingQuota	80% elérte a napi korlátkvótát.
ForceOff	A betöltés leállt a szolgáltatásbeállítás módosítását követően.
ForceOn	A betöltés a szolgáltatásbeállítás módosítását követően kezdődött.
OverQuota	Elérte a napi korlátkvótát, a betöltés leállt.
RespectQuota	A napi korlátkvóta alaphelyzetbe állítása vagy az előfizetés engedélyezése után engedélyezve van a betöltés.
SubscriptionSuspended	A betöltés a felfüggesztett előfizetést követően leállt.

ErrorAdditionalInfo

Objektum

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

Objektum

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

Objektum

Hibaválasz

Name	Típus	Description
error	ErrorDetail	A hibaobjektum.

Identity

Objektum

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

Enumerálás

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

Érték	Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Objektum

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 teljes erőforrás-azonosítója.
scopeId	string	A privát kapcsolat hatókörének egyedi azonosítója.

PublicNetworkAccessType

Enumerálás

A Log Analytics-munkaterületen való üzemeltetés hálózati hozzáférési típusa. Alapértelmezés szerint engedélyezve van

Érték	Description
Disabled	Letiltja a Log Analytics nyilvános DNS-kapcsolatát.
Enabled	Engedélyezi a Log Analyticshez való kapcsolódást nyilvános DNS-kapcsolaton keresztül.

systemData

Objektum

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

Objektum

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

Objektum

A legfelső szintű munkaterület erőforrástárolója.

Name	Típus	Alapértelmezett érték	Description
etag	string		A munkaterület etagje.
id	string		Az erőforrás teljes erőforrás-azonosítója. Ex - /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ási dátuma.
properties.customerId	string		Ez egy írásvédett 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 kapcsolat hatókörének 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		Az erőforrás létrehozásával és utolsó módosításával kapcsolatos 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

Objektum

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 pihen.

WorkspaceEntityStatus

Enumerálás

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

Érték	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Objektum

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

Name	Típus	Description
lastModifiedDate	string (date-time)	A feladatátvételi állapot legutóbbi frissítésekor.
state	WorkspaceFailoverState	A replikáció feladatátvételi állapota.

WorkspaceFailoverState

Enumerálás

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

Érték	Description
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Objektum

Munkaterületi funkciók.

Name	Típus	Description
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 egyesített számlázási modelljére korlátozódik-e.

WorkspaceReplicationProperties

Objektum

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

Name	Típus	Description
createdDate	string (date-time)	A replikáció engedélyezésének utolsó időpontja.
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ésének időpontja.
location	string	A replikáció helye.
provisioningState	WorkspaceReplicationState	A replikáció kiépítési állapota.

WorkspaceReplicationState

Enumerálás

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

Érték	Description
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Objektum

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

Name	Típus	Description
capacityReservationLevel	CapacityReservationLevel (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ó alkalommal, amikor a termékváltozat frissült.
name	WorkspaceSkuNameEnum	Az termékváltozat neve.

WorkspaceSkuNameEnum

Enumerálás

Az termékváltozat neve.

Érték	Description
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

Megosztás a következőn keresztül:

Workspaces - Create Or Update

URI-paraméterek

Kérelem törzse

Válaszok

Biztonság

azure_auth

Hatókörök

Példák

WorkspacesCreate

Mintakérelem

Mintaválasz

Definíciók

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

További források