Workspaces - Create Or Update

Referentie

Service:: Log Analytics

API-versie:: 2025-02-01

Een werkruimte maken of bijwerken.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	De naam van de werkruimte.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
etag		string	De etag van de werkruimte.
identity		Identity	De identiteit van de resource.
properties.defaultDataCollectionRuleResourceId		string	De resource-id van de standaardregel voor gegevensverzameling die voor deze werkruimte moet worden gebruikt. Verwachte indeling is - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover		WorkspaceFailoverProperties	eigenschappen van werkruimtefailover.
properties.features		WorkspaceFeatures	Werkruimtefuncties.
properties.forceCmkForQuery		boolean	Geeft aan of door de klant beheerde opslag verplicht is voor querybeheer.
properties.publicNetworkAccessForIngestion		PublicNetworkAccessType	Het netwerktoegangstype voor toegang tot Log Analytics-opname.
properties.publicNetworkAccessForQuery		PublicNetworkAccessType	Het netwerktoegangstype voor toegang tot Log Analytics-query.
properties.replication		WorkspaceReplicationProperties	eigenschappen van werkruimtereplicatie.
properties.retentionInDays		integer (int32)	De gegevensretentie van de werkruimte in dagen. Toegestane waarden zijn per prijsplan. Raadpleeg de documentatie over prijscategorieën voor meer informatie.
properties.sku		WorkspaceSku	De SKU van de werkruimte.
properties.workspaceCapping		WorkspaceCapping	De dagelijkse volumelimiet voor opname.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Workspace	Ok-antwoorddefinitie.
201 Created	Workspace	Antwoorddefinitie gemaakt.
202 Accepted		Geaccepteerd
Other Status Codes	ErrorResponse	Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

WorkspacesCreate

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Statuscode:: 202

Definities

Name	Description
CapacityReservationLevel	Het capaciteitsreserveringsniveau in GB voor deze werkruimte wanneer CapacityReservation-sku is geselecteerd.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DataIngestionStatus	De status van gegevensopname voor deze werkruimte.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
Identity	Identiteit voor de resource.
IdentityType	Type beheerde service-identiteit.
PrivateLinkScopedResource	De resourcereferentie voor het private link-bereik.
PublicNetworkAccessType	Het netwerktoegangstype voor gebruik in de Log Analytics-werkruimte. De functie is standaard ingeschakeld
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UserIdentityProperties	Door de gebruiker toegewezen identiteitseigenschappen.
Workspace	De resourcecontainer van de werkruimte op het hoogste niveau.
WorkspaceCapping	De dagelijkse volumelimiet voor opname.
WorkspaceEntityStatus	De inrichtingsstatus van de werkruimte.
WorkspaceFailoverProperties	De failoverstatus van de replicatie.
WorkspaceFailoverState	De failoverstatus van de replicatie.
WorkspaceFeatures	Werkruimtefuncties.
WorkspaceReplicationProperties	Eigenschappen van werkruimtereplicatie.
WorkspaceReplicationState	De inrichtingsstatus van de replicatie.
WorkspaceSku	De SKU (laag) van een werkruimte.
WorkspaceSkuNameEnum	De naam van de SKU.

CapacityReservationLevel

Inventarisatie

Het capaciteitsreserveringsniveau in GB voor deze werkruimte wanneer CapacityReservation-sku is geselecteerd.

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

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Inventarisatie

De status van gegevensopname voor deze werkruimte.

Waarde	Description
ApproachingQuota	80% van het dagelijkse quotum voor limieten bereikt.
ForceOff	Opname is gestopt na wijziging van de service-instelling.
ForceOn	Opname is gestart na wijziging van de service-instelling.
OverQuota	Het dagelijkse quotum voor het maximum is bereikt, opname is gestopt.
RespectQuota	Opname ingeschakeld na het dagelijks opnieuw instellen van quotumlimieten of het inschakelen van abonnementen.
SubscriptionSuspended	Opname is gestopt na onderbroken abonnement.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

Identity

Object

Identiteit voor de resource.

Name	Type	Description
principalId	string	De principal-id van de resource-id.
tenantId	string	De tenant-id van de resource.
type	IdentityType	Type beheerde service-identiteit.
userAssignedIdentities	<string, UserIdentityProperties>	De lijst met gebruikersidentiteiten die zijn gekoppeld aan de resource. De sleutelverwijzingen voor de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

IdentityType

Inventarisatie

Type beheerde service-identiteit.

Waarde	Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Object

De resourcereferentie voor het private link-bereik.

Name	Type	Description
resourceId	string	De volledige resource-id van de private link-bereikresource.
scopeId	string	De unieke id van het private link-bereik.

PublicNetworkAccessType

Inventarisatie

Het netwerktoegangstype voor gebruik in de Log Analytics-werkruimte. De functie is standaard ingeschakeld

Waarde	Description
Disabled	Hiermee schakelt u openbare connectiviteit met Log Analytics via openbare DNS uit.
Enabled	Maakt connectiviteit met Log Analytics mogelijk via openbare DNS.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UserIdentityProperties

Object

Door de gebruiker toegewezen identiteitseigenschappen.

Name	Type	Description
clientId	string	De client-id van de door de gebruiker toegewezen identiteit.
principalId	string	De principal-id van de door de gebruiker toegewezen identiteit.

Workspace

Object

De resourcecontainer van de werkruimte op het hoogste niveau.

Name	Type	Default value	Description
etag	string		De etag van de werkruimte.
id	string		Volledig gekwalificeerde resource-id voor de resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		De identiteit van de resource.
location	string		De geografische locatie waar de resource zich bevindt
name	string		De naam van de resource
properties.createdDate	string (date-time)		De aanmaakdatum van de werkruimte.
properties.customerId	string		Dit is een alleen-lezen eigenschap. Vertegenwoordigt de id die is gekoppeld aan de werkruimte.
properties.defaultDataCollectionRuleResourceId	string		De resource-id van de standaardregel voor gegevensverzameling die voor deze werkruimte moet worden gebruikt. Verwachte indeling is - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		eigenschappen van werkruimtefailover.
properties.features	WorkspaceFeatures		Werkruimtefuncties.
properties.forceCmkForQuery	boolean		Geeft aan of door de klant beheerde opslag verplicht is voor querybeheer.
properties.modifiedDate	string (date-time)		Datum van het wijzigen van de werkruimte.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		Lijst met resources voor het bereik van gekoppelde privékoppelingen.
properties.provisioningState	WorkspaceEntityStatus		De inrichtingsstatus van de werkruimte.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	Het netwerktoegangstype voor toegang tot Log Analytics-opname.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	Het netwerktoegangstype voor toegang tot Log Analytics-query.
properties.replication	WorkspaceReplicationProperties		eigenschappen van werkruimtereplicatie.
properties.retentionInDays	integer (int32)		De gegevensretentie van de werkruimte in dagen. Toegestane waarden zijn per prijsplan. Raadpleeg de documentatie over prijscategorieën voor meer informatie.
properties.sku	WorkspaceSku		De SKU van de werkruimte.
properties.workspaceCapping	WorkspaceCapping		De dagelijkse volumelimiet voor opname.
systemData	systemData		Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
tags	object		Resourcetags.
type	string		Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

WorkspaceCapping

Object

De dagelijkse volumelimiet voor opname.

Name	Type	Description
dailyQuotaGb	number (double)	Het dagelijkse quotum voor de werkruimte voor opname.
dataIngestionStatus	DataIngestionStatus	De status van gegevensopname voor deze werkruimte.
quotaNextResetTime	string	Het tijdstip waarop het quotum rust.

WorkspaceEntityStatus

Inventarisatie

De inrichtingsstatus van de werkruimte.

Waarde	Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Object

De failoverstatus van de replicatie.

Name	Type	Description
lastModifiedDate	string (date-time)	De laatste keer dat de failoverstatus is bijgewerkt.
state	WorkspaceFailoverState	De failoverstatus van de replicatie.

WorkspaceFailoverState

Inventarisatie

De failoverstatus van de replicatie.

Waarde	Description
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Object

Werkruimtefuncties.

Name	Type	Description
clusterResourceId	string	Toegewezen LA-clusterresourceId die is gekoppeld aan de werkruimten.
disableLocalAuth	boolean	Schakel verificatie op basis van niet-AAD uit.
enableDataExport	boolean	Vlag die aangeeft of gegevens moeten worden geëxporteerd.
enableLogAccessUsingOnlyResourcePermissions	boolean	Vlag die aangeeft welke machtiging moet worden gebruikt: resource of werkruimte of beide.
immediatePurgeDataOn30Days	boolean	Vlag die beschrijft of we de gegevens na 30 dagen willen verwijderen.
unifiedSentinelBillingOnly	boolean	Een indicatie als de opgegeven werkruimte alleen is beperkt tot het geïntegreerde factureringsmodel van Sentinel.

WorkspaceReplicationProperties

Object

Eigenschappen van werkruimtereplicatie.

Name	Type	Description
createdDate	string (date-time)	De laatste keer dat de replicatie is ingeschakeld.
enabled	boolean	Hiermee geeft u op of de replicatie is ingeschakeld of niet. Wanneer waar worden werkruimteconfiguratie en -gegevens gerepliceerd naar de opgegeven locatie. Als replicatie is ingeschakeld, moet de locatie worden opgegeven.
lastModifiedDate	string (date-time)	De laatste keer dat de replicatie is bijgewerkt.
location	string	De locatie van de replicatie.
provisioningState	WorkspaceReplicationState	De inrichtingsstatus van de replicatie.

WorkspaceReplicationState

Inventarisatie

De inrichtingsstatus van de replicatie.

Waarde	Description
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

Object

De SKU (laag) van een werkruimte.

Name	Type	Description
capacityReservationLevel	CapacityReservationLevel (int32)	Het capaciteitsreserveringsniveau in GB voor deze werkruimte wanneer CapacityReservation-sku is geselecteerd.
lastSkuUpdate	string (date-time)	De laatste keer dat de SKU is bijgewerkt.
name	WorkspaceSkuNameEnum	De naam van de SKU.

WorkspaceSkuNameEnum

Inventarisatie

De naam van de SKU.

Waarde	Description
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard

Delen via

Workspaces - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

WorkspacesCreate

Voorbeeldaanvraag

Voorbeeldrespons

Definities

CapacityReservationLevel

createdByType

DataIngestionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Identity

IdentityType

PrivateLinkScopedResource

PublicNetworkAccessType

systemData

UserIdentityProperties

Workspace

WorkspaceCapping

WorkspaceEntityStatus

WorkspaceFailoverProperties

WorkspaceFailoverState

WorkspaceFeatures

WorkspaceReplicationProperties

WorkspaceReplicationState

WorkspaceSku

WorkspaceSkuNameEnum

Aanvullende resources