Workspaces - Create Or Update

Služba:: Log Analytics

Verze rozhraní API:: 2025-07-01

Vytvořte nebo aktualizujte pracovní prostor.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string minLength: 1	ID cílového předplatného.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	Název pracovního prostoru.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
parameters	Workspace	Parametry potřebné k vytvoření nebo aktualizaci pracovního prostoru.

Odpovědi

Name	Typ	Description
200 OK	Workspace	Definice odpovědi OK.
201 Created	Workspace	Vytvořená definice odpovědi.
202 Accepted		Přijato
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

WorkspacesCreate

Ukázkový požadavek

HTTP

PUT 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
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Ukázková odpověď

Stavový kó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"
  }
}

Stavový kó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"
  }
}

Stavový kód:: 202

Definice

Name	Description
createdByType	Typ identity, která prostředek vytvořila.
DataIngestionStatus	Stav příjmu dat pro tento pracovní prostor.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
Identity	Identita prostředku
PrivateLinkScopedResource	Seznam propojených prostředků oboru privátního propojení.
PublicNetworkAccessType	Typ síťového přístupu pro přístup k příjmu dat Log Analytics.
ResourceIdentityType	Typ identity.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
Workspace	Kontejner prostředků pracovního prostoru nejvyšší úrovně.
WorkspaceCapping	Denní limit objemu pro příjem dat.
WorkspaceEntityStatus	Stav zřizování pracovního prostoru.
WorkspaceFailoverProperties	vlastnosti převzetí služeb při selhání pracovního prostoru
WorkspaceFailoverState	Stav převzetí služeb při selhání replikace.
WorkspaceFeatures	Funkce pracovního prostoru
WorkspaceReplicationProperties	vlastnosti replikace pracovního prostoru.
WorkspaceReplicationState	Stav zřizování replikace.
WorkspaceSku	Skladová položka pracovního prostoru.
WorkspaceSkuNameEnum	Název skladové položky.

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DataIngestionStatus

Výčet

Stav příjmu dat pro tento pracovní prostor.

Hodnota	Description
RespectQuota	Příjem dat povolený po resetování denní kvóty limitu nebo povolení předplatného.
ForceOn	Příjem dat začal po změně nastavení služby.
ForceOff	Po změně nastavení služby se příjem dat zastavil.
OverQuota	Dosažena denní limitní kvóta, příjem zastaven.
SubscriptionSuspended	Po pozastavení předplatného se příjem dat zastavil.
ApproachingQuota	80% denní stropní kvóty dosaženo.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Identity

Objekt

Identita prostředku

Name	Typ	Description
principalId	string (uuid)	ID objektu zabezpečení identity prostředku. Hodnota musí být UUID.
tenantId	string (uuid)	ID tenanta prostředku. Hodnota musí být UUID.
type	ResourceIdentityType	Typ identity.

PrivateLinkScopedResource

Objekt

Seznam propojených prostředků oboru privátního propojení.

Name	Typ	Description
resourceId	string	Úplné ID prostředku oboru privátního propojení.
scopeId	string	Jedinečný identifikátor rozsahu privátního odkazu.

PublicNetworkAccessType

Výčet

Typ síťového přístupu pro přístup k příjmu dat Log Analytics.

Hodnota	Description
Enabled	Umožňuje připojení k Log Analytics prostřednictvím veřejného DNS.
Disabled	Zakáže veřejné připojení k Log Analytics prostřednictvím veřejného DNS.
SecuredByPerimeter	Prostředek je přístupný pouze z privátních sítí a přístup je schválen perimetrem zabezpečení sítě přidruženým k tomuto prostředku.

ResourceIdentityType

Výčet

Typ identity.

Hodnota	Description
SystemAssigned

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Workspace

Objekt

Kontejner prostředků pracovního prostoru nejvyšší úrovně.

Name	Typ	Default value	Description
etag	string		Etag pracovního prostoru.
id	string		Plně kvalifikované ID prostředku pro prostředek. Příklad : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Identita prostředku.
location	string		Geografické umístění, ve kterém se nachází zdroj
name	string		Název prostředku
properties.createdDate	string (date-time)		Datum vytvoření pracovního prostoru.
properties.customerId	string		Toto je vlastnost pouze pro čtení. Představuje ID přidružené k pracovnímu prostoru.
properties.defaultDataCollectionRuleResourceId	string		ID prostředku výchozího pravidla shromažďování dat, které se má použít pro tento pracovní prostor. Očekávaný formát je – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		vlastnosti převzetí služeb při selhání pracovního prostoru
properties.features	WorkspaceFeatures		Funkce pracovního prostoru
properties.forceCmkForQuery	boolean		Určuje, jestli je spravované úložiště zákazníka povinné pro správu dotazů.
properties.modifiedDate	string (date-time)		Datum změny pracovního prostoru.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Seznam propojených prostředků oboru privátního propojení.
properties.provisioningState	WorkspaceEntityStatus		Stav zřizování pracovního prostoru.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Typ síťového přístupu pro přístup k příjmu dat Log Analytics.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Typ síťového přístupu pro přístup k dotazu Log Analytics.
properties.replication	WorkspaceReplicationProperties		vlastnosti replikace pracovního prostoru.
properties.retentionInDays	integer (int32)		Doba uchování dat pracovního prostoru v dnech. Povolené hodnoty jsou určeny podle cenového plánu. Podrobnosti najdete v dokumentaci k úrovním cen.
properties.sku	WorkspaceSku		Skladová položka pracovního prostoru.
properties.workspaceCapping	WorkspaceCapping		Denní limit objemu pro příjem dat.
systemData	systemData		Metadata týkající se vytvoření a poslední změny prostředku.
tags	object		Značky prostředků
type	string		Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Objekt

Denní limit objemu pro příjem dat.

Name	Typ	Description
dailyQuotaGb	number (double)	Denní kvóta pracovního prostoru pro příjem dat.
dataIngestionStatus	DataIngestionStatus	Stav příjmu dat pro tento pracovní prostor.
quotaNextResetTime	string	Doba, po kterou bude kvóta klidová.

WorkspaceEntityStatus

Výčet

Stav zřizování pracovního prostoru.

Hodnota	Description
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Objekt

vlastnosti převzetí služeb při selhání pracovního prostoru

Name	Typ	Description
lastModifiedDate	string (date-time)	Čas, kdy byl naposledy aktualizován stav převzetí služeb při selhání.
state	WorkspaceFailoverState	Stav převzetí služeb při selhání replikace.

WorkspaceFailoverState

Výčet

Stav převzetí služeb při selhání replikace.

Hodnota	Description
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Objekt

Funkce pracovního prostoru

Name	Typ	Description
associations	string[]	Seznam přidružení pro pracovní prostor. Označuje, jestli je pracovní prostor přidružený k některému z následujících prostředí: MDC, Sentinel, SentinelGraph atd.
clusterResourceId	string	Id prostředku vyhrazeného clusteru LA, který je propojený s pracovními prostory.
disableLocalAuth	boolean	Zakažte ověřování založené na AAD.
enableDataExport	boolean	Příznak označující, jestli se mají exportovat data
enableLogAccessUsingOnlyResourcePermissions	boolean	Příznak označující, které oprávnění použít – prostředek nebo pracovní prostor nebo obojí
immediatePurgeDataOn30Days	boolean	Příznak, který popisuje, jestli chceme data po 30 dnech odebrat.
unifiedSentinelBillingOnly	boolean	Označení, zda je určený pracovní prostor omezen pouze na jednotný model účtování služby sentinel.

WorkspaceReplicationProperties

Objekt

vlastnosti replikace pracovního prostoru.

Name	Typ	Description
createdDate	string (date-time)	Čas, kdy byla replikace naposledy povolena.
enabled	boolean	Určuje, jestli je replikace povolená nebo ne. Pokud je hodnota true, konfigurace a data pracovního prostoru se replikují do zadaného umístění. Pokud je povolená replikace, musí být zadáno umístění.
lastModifiedDate	string (date-time)	Čas, kdy byla replikace naposledy aktualizována.
location	string	Umístění replikace.
provisioningState	WorkspaceReplicationState	Stav zřizování replikace.

WorkspaceReplicationState

Výčet

Stav zřizování replikace.

Hodnota	Description
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Objekt

Skladová položka pracovního prostoru.

Name	Typ	Description
capacityReservationLevel	integer (int32)	Úroveň rezervace kapacity v GB pro tento pracovní prostor, když je vybraná skladová položka CapacityReservation.
lastSkuUpdate	string (date-time)	Čas, kdy byla naposledy aktualizována skladová položka.
name	WorkspaceSkuNameEnum	Název skladové položky.

WorkspaceSkuNameEnum

Výčet

Název skladové položky.

Hodnota	Description
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster

Sdílet prostřednictvím

Workspaces - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

WorkspacesCreate

Ukázkový požadavek

Ukázková odpověď

Definice

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

PrivateLinkScopedResource

PublicNetworkAccessType

ResourceIdentityType

systemData

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum