Dela via


Workspaces - Create Or Update

Skapa eller uppdatera en arbetsyta.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

minLength: 1

ID för målprenumerationen.

workspaceName
path True

string

minLength: 4
maxLength: 63
pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$

Namnet på arbetsytan.

api-version
query True

string

minLength: 1

DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name Obligatorisk Typ Description
location True

string

Den geo-plats där resursen finns

etag

string

Etag för arbetsytan.

identity

Identity

Resursens identitet.

properties.defaultDataCollectionRuleResourceId

string

Resurs-ID för standardregeln för datainsamling som ska användas för den här arbetsytan. Förväntat format är – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

redundansegenskaper för arbetsytan.

properties.features

WorkspaceFeatures

Arbetsytefunktioner.

properties.forceCmkForQuery

boolean

Anger om kundhanterad lagring är obligatorisk för frågehantering.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Nätverksåtkomsttypen för åtkomst till Log Analytics-frågan.

properties.replication

WorkspaceReplicationProperties

replikeringsegenskaper för arbetsytan.

properties.retentionInDays

integer (int32)

Datakvarhållning för arbetsytan i dagar. Tillåtna värden är per prisplan. Mer information finns i dokumentationen om prisnivåer.

properties.sku

WorkspaceSku

Arbetsytans SKU.

properties.workspaceCapping

WorkspaceCapping

Det dagliga volymtaket för inmatning.

tags

object

Resurstaggar.

Svar

Name Typ Description
200 OK

Workspace

OK svarsdefinition.

201 Created

Workspace

Svarsdefinition har skapats.

202 Accepted

Accepterad

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

WorkspacesCreate

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
CapacityReservationLevel

Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs.

createdByType

Den typ av identitet som skapade resursen.

DataIngestionStatus

Status för datainmatning för den här arbetsytan.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

Identity

Identitet för resursen.

IdentityType

Typ av hanterad tjänstidentitet.

PrivateLinkScopedResource

Resursreferensen för private link-omfånget.

PublicNetworkAccessType

Nätverksåtkomsttypen för att fungera på Log Analytics-arbetsytan. Som standard är den aktiverad

systemData

Metadata som rör skapande och senaste ändring av resursen.

UserIdentityProperties

Användartilldelade identitetsegenskaper.

Workspace

Resurscontainern för arbetsytan på den översta nivån.

WorkspaceCapping

Det dagliga volymtaket för inmatning.

WorkspaceEntityStatus

Etableringstillståndet för arbetsytan.

WorkspaceFailoverProperties

Replikeringens redundanstillstånd.

WorkspaceFailoverState

Replikeringens redundanstillstånd.

WorkspaceFeatures

Arbetsytefunktioner.

WorkspaceReplicationProperties

Replikeringsegenskaper för arbetsyta.

WorkspaceReplicationState

Replikeringens etableringstillstånd.

WorkspaceSku

SKU:n (nivån) för en arbetsyta.

WorkspaceSkuNameEnum

Namnet på SKU:n.

CapacityReservationLevel

Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs.

Värde Description
100
1000
10000
200
2000
25000
300
400
500
5000
50000

createdByType

Den typ av identitet som skapade resursen.

Värde Description
Application
Key
ManagedIdentity
User

DataIngestionStatus

Status för datainmatning för den här arbetsytan.

Värde Description
ApproachingQuota

80% av den dagliga kvot som uppnåtts.

ForceOff

Inmatningen stoppades efter ändring av tjänstinställningen.

ForceOn

Inmatningen började efter ändring av tjänstinställningen.

OverQuota

Den dagliga gränskvoten har nåtts och inmatningen har stoppats.

RespectQuota

Inmatning aktiverad efter daglig cap-kvotåterställning eller prenumerationsaktivering.

SubscriptionSuspended

Inmatningen stoppades efter en pausad prenumeration.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

Identity

Identitet för resursen.

Name Typ Description
principalId

string

Huvud-ID för resursidentitet.

tenantId

string

Resursens klientorganisations-ID.

type

IdentityType

Typ av hanterad tjänstidentitet.

userAssignedIdentities

<string,  UserIdentityProperties>

Listan över användaridentiteter som är associerade med resursen. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

IdentityType

Typ av hanterad tjänstidentitet.

Värde Description
None
SystemAssigned
UserAssigned

PrivateLinkScopedResource

Resursreferensen för private link-omfånget.

Name Typ Description
resourceId

string

Det fullständiga resurs-ID:t för den privata länkomfångsresursen.

scopeId

string

Den unika identifieraren för det privata länkomfånget.

PublicNetworkAccessType

Nätverksåtkomsttypen för att fungera på Log Analytics-arbetsytan. Som standard är den aktiverad

Värde Description
Disabled

Inaktiverar offentlig anslutning till Log Analytics via offentlig DNS.

Enabled

Aktiverar anslutning till Log Analytics via offentlig DNS.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

UserIdentityProperties

Användartilldelade identitetsegenskaper.

Name Typ Description
clientId

string

Klient-ID för användartilldelad identitet.

principalId

string

Huvud-ID för användartilldelad identitet.

Workspace

Resurscontainern för arbetsytan på den översta nivån.

Name Typ Standardvärde Description
etag

string

Etag för arbetsytan.

id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identity

Resursens identitet.

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.createdDate

string (date-time)

Skapandedatum för arbetsyta.

properties.customerId

string

Det här är en skrivskyddad egenskap. Representerar det ID som är associerat med arbetsytan.

properties.defaultDataCollectionRuleResourceId

string

Resurs-ID för standardregeln för datainsamling som ska användas för den här arbetsytan. Förväntat format är – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.

properties.failover

WorkspaceFailoverProperties

redundansegenskaper för arbetsytan.

properties.features

WorkspaceFeatures

Arbetsytefunktioner.

properties.forceCmkForQuery

boolean

Anger om kundhanterad lagring är obligatorisk för frågehantering.

properties.modifiedDate

string (date-time)

Ändringsdatum för arbetsyta.

properties.privateLinkScopedResources

PrivateLinkScopedResource[]

Lista över resurser för länkat privat länkomfång.

properties.provisioningState

WorkspaceEntityStatus

Etableringstillståndet för arbetsytan.

properties.publicNetworkAccessForIngestion

PublicNetworkAccessType

Enabled

Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning.

properties.publicNetworkAccessForQuery

PublicNetworkAccessType

Enabled

Nätverksåtkomsttypen för åtkomst till Log Analytics-frågan.

properties.replication

WorkspaceReplicationProperties

replikeringsegenskaper för arbetsytan.

properties.retentionInDays

integer (int32)

Datakvarhållning för arbetsytan i dagar. Tillåtna värden är per prisplan. Mer information finns i dokumentationen om prisnivåer.

properties.sku

WorkspaceSku

Arbetsytans SKU.

properties.workspaceCapping

WorkspaceCapping

Det dagliga volymtaket för inmatning.

systemData

systemData

Metadata som rör skapande och senaste ändring av resursen.

tags

object

Resurstaggar.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Det dagliga volymtaket för inmatning.

Name Typ Description
dailyQuotaGb

number (double)

Den dagliga arbetsytans kvot för inmatning.

dataIngestionStatus

DataIngestionStatus

Status för datainmatning för den här arbetsytan.

quotaNextResetTime

string

Tiden då kvoten kommer att vila.

WorkspaceEntityStatus

Etableringstillståndet för arbetsytan.

Värde Description
Canceled
Creating
Deleting
Failed
ProvisioningAccount
Succeeded
Updating

WorkspaceFailoverProperties

Replikeringens redundanstillstånd.

Name Typ Description
lastModifiedDate

string (date-time)

Senaste gången redundanstillståndet uppdaterades.

state

WorkspaceFailoverState

Replikeringens redundanstillstånd.

WorkspaceFailoverState

Replikeringens redundanstillstånd.

Värde Description
Activating
Active
Deactivating
Failed
Inactive

WorkspaceFeatures

Arbetsytefunktioner.

Name Typ Description
clusterResourceId

string

Dedikerad LA-klusterresursId som är länkat till arbetsytorna.

disableLocalAuth

boolean

Inaktivera icke-AAD-baserad autentisering.

enableDataExport

boolean

Flagga som anger om data ska exporteras.

enableLogAccessUsingOnlyResourcePermissions

boolean

Flagga som anger vilken behörighet som ska användas – resurs eller arbetsyta eller både och.

immediatePurgeDataOn30Days

boolean

Flagga som beskriver om vi vill ta bort data efter 30 dagar.

unifiedSentinelBillingOnly

boolean

En indikation om den angiven arbetsytan endast är begränsad till sentinels enhetliga faktureringsmodell.

WorkspaceReplicationProperties

Replikeringsegenskaper för arbetsyta.

Name Typ Description
createdDate

string (date-time)

Senaste gången replikeringen aktiverades.

enabled

boolean

Anger om replikeringen är aktiverad eller inte. När det är sant replikeras konfiguration och data för arbetsytan till den angivna platsen. Om replikering har aktiverats måste platsen anges.

lastModifiedDate

string (date-time)

Senaste gången replikeringen uppdaterades.

location

string

Platsen för replikeringen.

provisioningState

WorkspaceReplicationState

Replikeringens etableringstillstånd.

WorkspaceReplicationState

Replikeringens etableringstillstånd.

Värde Description
Canceled
DisableRequested
Disabling
EnableRequested
Enabling
Failed
RollbackRequested
RollingBack
Succeeded

WorkspaceSku

SKU:n (nivån) för en arbetsyta.

Name Typ Description
capacityReservationLevel

CapacityReservationLevel (int32)

Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs.

lastSkuUpdate

string (date-time)

Senaste gången som sku:n uppdaterades.

name

WorkspaceSkuNameEnum

Namnet på SKU:n.

WorkspaceSkuNameEnum

Namnet på SKU:n.

Värde Description
CapacityReservation
Free
LACluster
PerGB2018
PerNode
Premium
Standalone
Standard