Workspaces - Update

Reference

Service:: Log Analytics

API Version:: 2023-09-01

Aktualizace pracovního prostoru.

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

Parametry identifikátoru URI

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

Text požadavku

Name	Typ	Description
identity	Identity	Identita prostředku.
properties.defaultDataCollectionRuleResourceId	string	ID prostředku výchozího pravidla shromažďování dat, které se má pro tento pracovní prostor použít. Očekávaný formát je - /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.features	WorkspaceFeatures	Funkce pracovního prostoru.
properties.forceCmkForQuery	boolean	Určuje, jestli je úložiště spravované zákazníkem povinné pro správu dotazů.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Typ síťového přístupu pro přístup k příjmu dat v Log Analytics.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Typ síťového přístupu pro přístup k dotazu Log Analytics.
properties.retentionInDays	integer	Uchovávání dat pracovního prostoru ve dnech. Povolené hodnoty jsou pro 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ů. Nepovinný parametr.

Odpovědi

Name	Typ	Description
200 OK	Workspace	Existující pracovní prostor se úspěšně aktualizoval. Zkontrolujte provisioningStatus a podívejte se na podrobný stav.
Other Status Codes	ErrorResponse	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Příklady

WorkspacesPatch

Sample Request

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2023-09-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "workspaceCapping": {
      "dailyQuotaGb": -1
    }
  }
}

Sample Response

Status code:: 200

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30,
    "publicNetworkAccessForQuery": "Enabled",
    "publicNetworkAccessForIngestion": "Enabled",
    "workspaceCapping": {
      "dailyQuotaGb": -1,
      "quotaNextResetTime": "Mon, 16 Nov 2020 15:00:00 GMT",
      "dataIngestionStatus": "RespectQuota"
    }
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Definice

Name	Description
CapacityReservationLevel	Úroveň rezervace kapacity v GB pro tento pracovní prostor, pokud 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 prostředku oboru 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 povoleno.
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.
WorkspaceFeatures	Funkce pracovního prostoru.
WorkspacePatch	Kontejner prostředků pracovního prostoru nejvyšší úrovně.
WorkspaceSku	Skladová položka (úroveň) pracovního prostoru.
WorkspaceSkuNameEnum	Název skladové položky.

CapacityReservationLevel

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

Name	Typ	Description
100	Integer
1000	Integer
10000	Integer
200	Integer
2000	Integer
25000	Integer
300	Integer
400	Integer
500	Integer
5000	Integer
50000	Integer

createdByType

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

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DataIngestionStatus

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

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

ErrorAdditionalInfo

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

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

ErrorDetail

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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Identity

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íče slovníku identit uživatelů budou ID prostředků ARM ve formátu//subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

IdentityType

Typ identity spravované služby

Name	Typ	Description
None	string
SystemAssigned	string
UserAssigned	string

PrivateLinkScopedResource

Referenční informace k prostředku 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 oboru 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 povoleno.

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

systemData

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

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

UserIdentityProperties

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

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

Name	Typ	Výchozí hodnota	Description
etag	string		Značka etag pracovního prostoru
id	string		Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}
identity	Identity		Identita prostředku.
location	string		Geografické umístění, kde se prostředek nachází
name	string		Název prostředku
properties.createdDate	string		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á pro tento pracovní prostor použít. Očekávaný formát je - /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.features	WorkspaceFeatures		Funkce pracovního prostoru.
properties.forceCmkForQuery	boolean		Určuje, jestli je úložiště spravované zákazníkem povinné pro správu dotazů.
properties.modifiedDate	string		Datum změny pracovního prostoru.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Seznam prostředků propojeného 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 v Log Analytics.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Typ síťového přístupu pro přístup k dotazu Log Analytics.
properties.retentionInDays	integer		Uchovávání dat pracovního prostoru ve dnech. Povolené hodnoty jsou pro 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

Denní limit objemu pro příjem dat.

Name	Typ	Description
dailyQuotaGb	number	Denní kvóta pracovního prostoru pro příjem dat.
dataIngestionStatus	DataIngestionStatus	Stav příjmu dat pro tento pracovní prostor.
quotaNextResetTime	string	Čas, kdy bude kvóta odpočinutá.

WorkspaceEntityStatus

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

Name	Typ	Description
Canceled	string
Creating	string
Deleting	string
Failed	string
ProvisioningAccount	string
Succeeded	string
Updating	string

WorkspaceFeatures

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í jiného než AAD.
enableDataExport	boolean	Příznak, který označuje, jestli se mají data exportovat.
enableLogAccessUsingOnlyResourcePermissions	boolean	Příznak označující, které oprávnění se má použít – prostředek, pracovní prostor nebo obojí
immediatePurgeDataOn30Days	boolean	Příznak, který popisuje, jestli chceme data po 30 dnech odebrat.
unifiedSentinelBillingOnly	boolean	Informace o tom, jestli je zadaný pracovní prostor omezen pouze na model sjednocené fakturace služby Sentinel.

WorkspacePatch