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 |
---|---|---|---|---|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
subscription
|
path | True |
string minLength: 1 |
ID för målprenumerationen. |
workspace
|
path | True |
string minLength: 4maxLength: 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 |
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 |
redundansegenskaper för arbetsytan. |
||
properties.features |
Arbetsytefunktioner. |
||
properties.forceCmkForQuery |
boolean |
Anger om kundhanterad lagring är obligatorisk för frågehantering. |
|
properties.publicNetworkAccessForIngestion |
Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning. |
||
properties.publicNetworkAccessForQuery |
Nätverksåtkomsttypen för åtkomst till Log Analytics-frågan. |
||
properties.replication |
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 |
Arbetsytans SKU. |
||
properties.workspaceCapping |
Det dagliga volymtaket för inmatning. |
||
tags |
object |
Resurstaggar. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK svarsdefinition. |
|
201 Created |
Svarsdefinition har skapats. |
|
202 Accepted |
Accepterad |
|
Other Status Codes |
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 |
---|---|
Capacity |
Kapacitetsreservationsnivån i GB för den här arbetsytan, när CapacityReservation sku väljs. |
created |
Den typ av identitet som skapade resursen. |
Data |
Status för datainmatning för den här arbetsytan. |
Error |
Ytterligare information om resurshanteringsfelet. |
Error |
Felinformationen. |
Error |
Felsvar |
Identity |
Identitet för resursen. |
Identity |
Typ av hanterad tjänstidentitet. |
Private |
Resursreferensen för private link-omfånget. |
Public |
Nätverksåtkomsttypen för att fungera på Log Analytics-arbetsytan. Som standard är den aktiverad |
system |
Metadata som rör skapande och senaste ändring av resursen. |
User |
Användartilldelade identitetsegenskaper. |
Workspace |
Resurscontainern för arbetsytan på den översta nivån. |
Workspace |
Det dagliga volymtaket för inmatning. |
Workspace |
Etableringstillståndet för arbetsytan. |
Workspace |
Replikeringens redundanstillstånd. |
Workspace |
Replikeringens redundanstillstånd. |
Workspace |
Arbetsytefunktioner. |
Workspace |
Replikeringsegenskaper för arbetsyta. |
Workspace |
Replikeringens etableringstillstånd. |
Workspace |
SKU:n (nivån) för en arbetsyta. |
Workspace |
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 |
Ytterligare information om felet. |
|
code |
string |
Felkoden. |
details |
Felinformationen. |
|
message |
string |
Felmeddelandet. |
target |
string |
Felmålet. |
ErrorResponse
Felsvar
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |
Identity
Identitet för resursen.
Name | Typ | Description |
---|---|---|
principalId |
string |
Huvud-ID för resursidentitet. |
tenantId |
string |
Resursens klientorganisations-ID. |
type |
Typ av hanterad tjänstidentitet. |
|
userAssignedIdentities |
<string,
User |
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 |
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 |
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 |
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 |
redundansegenskaper för arbetsytan. |
||
properties.features |
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 |
Lista över resurser för länkat privat länkomfång. |
||
properties.provisioningState |
Etableringstillståndet för arbetsytan. |
||
properties.publicNetworkAccessForIngestion | Enabled |
Nätverksåtkomsttypen för åtkomst till Log Analytics-inmatning. |
|
properties.publicNetworkAccessForQuery | Enabled |
Nätverksåtkomsttypen för åtkomst till Log Analytics-frågan. |
|
properties.replication |
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 |
Arbetsytans SKU. |
||
properties.workspaceCapping |
Det dagliga volymtaket för inmatning. |
||
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 |
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 |
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 |
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 |
Capacity |
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 |
Namnet på SKU:n. |
WorkspaceSkuNameEnum
Namnet på SKU:n.
Värde | Description |
---|---|
CapacityReservation | |
Free | |
LACluster | |
PerGB2018 | |
PerNode | |
Premium | |
Standalone | |
Standard |