Workspaces - Create Or Update

Reference

Služba:: Log Analytics

Verze rozhraní API:: 2025-02-01

Vytvoření nebo aktualizace pracovního prostoru

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-02-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	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
etag		string	Etag pracovního prostoru.
identity		Identity	Identita prostředku.
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.publicNetworkAccessForIngestion		PublicNetworkAccessType	Typ síťového přístupu pro přístup k příjmu dat Log Analytics.
properties.publicNetworkAccessForQuery		PublicNetworkAccessType	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)	Uchovávání dat pracovního prostoru ve dnech. Povolené hodnoty jsou pro každý cenový plán. Podrobnosti najdete v dokumentaci k cenám.
properties.sku		WorkspaceSku	Skladová položka pracovního prostoru.
properties.workspaceCapping		WorkspaceCapping	Denní limit objemu pro příjem dat.
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	Workspace	Definice odpovědi OK.
201 Created	Workspace	Byla vytvořena definice odpovědi.
202 Accepted		Přijal
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-02-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
CapacityReservationLevel	Úroveň rezervace kapacity v GB pro tento pracovní prostor, když je vybraná skladová položka CapacityReservation.
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
IdentityType	Typ identity spravované služby
PrivateLinkScopedResource	Referenční informace k rozsahu privátního propojení
PublicNetworkAccessType	Typ síťového přístupu pro provoz v pracovním prostoru služby Log Analytics. Ve výchozím nastavení je povolená.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UserIdentityProperties	Vlastnosti identity přiřazené uživatelem
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	Stav převzetí služeb při selhání replikace.
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 (úroveň) pracovního prostoru.
WorkspaceSkuNameEnum	Název skladové položky.

CapacityReservationLevel

Výčet

Úroveň rezervace kapacity v GB pro tento pracovní prostor, když je vybraná skladová položka CapacityReservation.

Hodnota	Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Výčet

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

Hodnota	Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Výčet

Stav příjmu dat pro tento pracovní prostor

Hodnota	Description
ApproachingQuota	Bylo dosaženo 80% denní kvóty maximálního limitu.
ForceOff	Příjem dat se zastavil po změně nastavení služby.
ForceOn	Příjem dat začal sledovat změnu nastavení služby.
OverQuota	Dosáhli denní kvóty maximálního limitu, příjem dat se zastavil.
RespectQuota	Příjem dat povolený po resetování denní kvóty nebo povolení předplatného
SubscriptionSuspended	Příjem dat přestal sledovat pozastavené předplatné.

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	ID objektu zabezpečení identity prostředku.
tenantId	string	ID tenanta prostředku.
type	IdentityType	Typ identity spravované služby
userAssignedIdentities	<string, UserIdentityProperties>	Seznam identit uživatelů přidružených k prostředku. Odkazy na klíč slovníku identit uživatele budou ID prostředků ARM ve formátu: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

IdentityType

Výčet

Typ identity spravované služby

Hodnota	Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Objekt

Referenční informace k rozsahu privátního propojení

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

PublicNetworkAccessType

Výčet

Typ síťového přístupu pro provoz v pracovním prostoru služby Log Analytics. Ve výchozím nastavení je povolená.

Hodnota	Description
Disabled	Zakáže veřejné připojení ke službě Log Analytics prostřednictvím veřejného DNS.
Enabled	Umožňuje připojení ke službě Log Analytics prostřednictvím veřejného DNS.

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.

UserIdentityProperties

Objekt

Vlastnosti identity přiřazené uživatelem

Name	Typ	Description
clientId	string	ID klienta identity přiřazené uživatelem.
principalId	string	ID objektu zabezpečení identity přiřazené uživatelem.

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 jen 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ích 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)		Uchovávání dat pracovního prostoru ve dnech. Povolené hodnoty jsou pro každý cenový plán. Podrobnosti najdete v dokumentaci k cenám.
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říklad 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, kdy bude kvóta odpočinek.

WorkspaceEntityStatus

Výčet

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

Hodnota	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Objekt

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

Name	Typ	Description
lastModifiedDate	string (date-time)	Čas poslední aktualizace stavu 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
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Objekt

Funkce pracovního prostoru

Name	Typ	Description
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í, jestli je zadaný pracovní prostor omezen pouze na jednotný fakturační model služby Sentinel.

WorkspaceReplicationProperties

Objekt

Vlastnosti replikace pracovního prostoru

Name	Typ	Description
createdDate	string (date-time)	Čas posledního povolení replikace
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 poslední aktualizace replikace
location	string	Umístění replikace.
provisioningState	WorkspaceReplicationState	Stav zřizování replikace.

WorkspaceReplicationState

Výčet

Stav zřizování replikace.

Hodnota	Description
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Objekt

Skladová položka (úroveň) pracovního prostoru.

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

WorkspaceSkuNameEnum

Výčet

Název skladové položky.

Hodnota	Description
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

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

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Další materiály