Sdílet prostřednictvím


Workspaces - Update

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.

Vzor regulárního výrazu: ^[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

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

WorkspacesPatch

Ukázkový požadavek

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
    }
  }
}

Ukázková odpověď

{
  "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 Default value 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

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

Name Typ Default value Description
etag

string

Značka ETag prostředku.

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.

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.

tags

object

Značky prostředků. Nepovinný parametr.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

WorkspaceSku

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

Name Typ Description
capacityReservationLevel

CapacityReservationLevel

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

lastSkuUpdate

string

Čas poslední aktualizace skladové položky.

name

WorkspaceSkuNameEnum

Název skladové položky.

WorkspaceSkuNameEnum

Název skladové položky.

Name Typ Description
CapacityReservation

string

Free

string

LACluster

string

PerGB2018

string

PerNode

string

Premium

string

Standalone

string

Standard

string