Workspaces - Create Or Update

Szolgáltatás:

Log Analytics

API verzió:

2025-07-01

Munkaterület létrehozása vagy frissítése.

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

URI paraméterek

Név	Ban	Szükséges	Típus	Leírás
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
workspaceName	path	True	string minLength: 4 maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$	A munkaterület neve.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Kérő Testület

Név	Típus	Leírás
parameters	Workspace	A munkaterület létrehozásához vagy frissítéséhez szükséges paraméterek.

Válaszok

Név	Típus	Leírás
200 OK	Workspace	OK válasz definíciója.
201 Created	Workspace	Válaszdefiníció létrehozva.
202 Accepted		Elfogadott
Other Status Codes	ErrorResponse	Hibaválasz, amely leírja, hogy miért nem sikerült a művelet.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat

Típus: oauth2
Flow: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Név	Leírás
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

WorkspacesCreate

Mintakérés

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01

{
  "properties": {
    "sku": {
      "name": "PerGB2018"
    },
    "retentionInDays": 30
  },
  "location": "australiasoutheast",
  "tags": {
    "tag1": "val1"
  }
}

Java

import com.azure.resourcemanager.loganalytics.models.WorkspaceSku;
import com.azure.resourcemanager.loganalytics.models.WorkspaceSkuNameEnum;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for Workspaces CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-
     * 07-01/examples/WorkspacesCreate.json
     */
    /**
     * Sample code: WorkspacesCreate.
     * 
     * @param manager Entry point to LogAnalyticsManager.
     */
    public static void workspacesCreate(com.azure.resourcemanager.loganalytics.LogAnalyticsManager manager) {
        manager.workspaces().define("oiautorest6685").withRegion("australiasoutheast")
            .withExistingResourceGroup("oiautorest6685").withTags(mapOf("tag1", "val1"))
            .withSku(new WorkspaceSku().withName(WorkspaceSkuNameEnum.PER_GB2018)).withRetentionInDays(30).create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.loganalytics import LogAnalyticsManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-loganalytics
# USAGE
    python workspaces_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = LogAnalyticsManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-00000000000",
    )

    response = client.workspaces.begin_create_or_update(
        resource_group_name="oiautorest6685",
        workspace_name="oiautorest6685",
        parameters={
            "location": "australiasoutheast",
            "properties": {"retentionInDays": 30, "sku": {"name": "PerGB2018"}},
            "tags": {"tag1": "val1"},
        },
    ).result()
    print(response)


# x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesCreate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armoperationalinsights_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/operationalinsights/armoperationalinsights/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/53d56e4ec74156c450d1e51745a971d3f2031dd7/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesCreate.json
func ExampleWorkspacesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armoperationalinsights.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewWorkspacesClient().BeginCreateOrUpdate(ctx, "oiautorest6685", "oiautorest6685", armoperationalinsights.Workspace{
		Location: to.Ptr("australiasoutheast"),
		Tags: map[string]*string{
			"tag1": to.Ptr("val1"),
		},
		Properties: &armoperationalinsights.WorkspaceProperties{
			RetentionInDays: to.Ptr[int32](30),
			SKU: &armoperationalinsights.WorkspaceSKU{
				Name: to.Ptr(armoperationalinsights.WorkspaceSKUNameEnumPerGB2018),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Workspace = armoperationalinsights.Workspace{
	// 	Name: to.Ptr("AzTest2170"),
	// 	Type: to.Ptr("Microsoft.OperationalInsights/workspaces"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170"),
	// 	Location: to.Ptr("australiasoutheast"),
	// 	Tags: map[string]*string{
	// 		"tag1": to.Ptr("val1"),
	// 	},
	// 	Properties: &armoperationalinsights.WorkspaceProperties{
	// 		CustomerID: to.Ptr("bc089d7b-485c-4aff-a71e-c00f362d8d2f"),
	// 		ProvisioningState: to.Ptr(armoperationalinsights.WorkspaceEntityStatusSucceeded),
	// 		PublicNetworkAccessForIngestion: to.Ptr(armoperationalinsights.PublicNetworkAccessTypeEnabled),
	// 		PublicNetworkAccessForQuery: to.Ptr(armoperationalinsights.PublicNetworkAccessTypeEnabled),
	// 		RetentionInDays: to.Ptr[int32](30),
	// 		SKU: &armoperationalinsights.WorkspaceSKU{
	// 			Name: to.Ptr(armoperationalinsights.WorkspaceSKUNameEnumPerGB2018),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { OperationalInsightsManagementClient } = require("@azure/arm-operationalinsights");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Create or update a workspace.
 *
 * @summary Create or update a workspace.
 * x-ms-original-file: specification/operationalinsights/resource-manager/Microsoft.OperationalInsights/OperationalInsights/stable/2025-07-01/examples/WorkspacesCreate.json
 */
async function workspacesCreate() {
  const subscriptionId =
    process.env["OPERATIONALINSIGHTS_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-00000000000";
  const resourceGroupName = process.env["OPERATIONALINSIGHTS_RESOURCE_GROUP"] || "oiautorest6685";
  const workspaceName = "oiautorest6685";
  const parameters = {
    location: "australiasoutheast",
    retentionInDays: 30,
    sku: { name: "PerGB2018" },
    tags: { tag1: "val1" },
  };
  const credential = new DefaultAzureCredential();
  const client = new OperationalInsightsManagementClient(credential, subscriptionId);
  const result = await client.workspaces.beginCreateOrUpdateAndWait(
    resourceGroupName,
    workspaceName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Mintaválasz

Állapotkód:

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

Állapotkód:

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

Állapotkód:

202

Meghatározások

Név	Leírás
createdByType	Az erőforrást létrehozó identitás típusa.
DataIngestionStatus	A munkaterület adatbetöltésének állapota.
ErrorAdditionalInfo	Az erőforrás-kezelési hiba további információi.
ErrorDetail	A hiba részletei.
ErrorResponse	Hibaválasz
Identity	Az erőforrás identitása.
PrivateLinkScopedResource	A csatolt privát kapcsolati hatókör erőforrásainak listája.
PublicNetworkAccessType	A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.
ResourceIdentityType	Az identitás típusa.
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Workspace	A legfelső szintű munkaterület-erőforrás-tároló.
WorkspaceCapping	A betöltés napi kötetkorlátja.
WorkspaceEntityStatus	A munkaterület kiépítési állapota.
WorkspaceFailoverProperties	munkaterület feladatátvételi tulajdonságai.
WorkspaceFailoverState	A replikáció feladatátvételi állapota.
WorkspaceFeatures	Munkaterületi funkciók.
WorkspaceReplicationProperties	munkaterület replikációs tulajdonságai.
WorkspaceReplicationState	A replikáció kiépítési állapota.
WorkspaceSku	A munkaterület termékváltozata.
WorkspaceSkuNameEnum	Az termékváltozat neve.

createdByType

Felsorolás

Az erőforrást létrehozó identitás típusa.

Érték	Leírás
User
Application
ManagedIdentity
Key

DataIngestionStatus

Felsorolás

A munkaterület adatbetöltésének állapota.

Érték	Leírás
RespectQuota	A betöltés engedélyezve a napi felső kvóta alaphelyzetbe állítása vagy az előfizetés engedélyezése után.
ForceOn	A betöltés a szolgáltatásbeállítás módosítását követően kezdődött.
ForceOff	A betöltés leállt a szolgáltatásbeállítás módosítása után.
OverQuota	Elérte a napi felső kvótát, a betöltés leállt.
SubscriptionSuspended	A felfüggesztett előfizetés után leállt a betöltés.
ApproachingQuota	A napi felső korlát 80% kvótáját érte el.

ErrorAdditionalInfo

Tárgy

Az erőforrás-kezelési hiba további információi.

Név	Típus	Leírás
info	object	A további információk.
type	string	A további információtípus.

ErrorDetail

Tárgy

A hiba részletei.

Név	Típus	Leírás
additionalInfo	ErrorAdditionalInfo[]	A hiba további információi.
code	string	A hibakód.
details	ErrorDetail[]	A hiba részletei.
message	string	A hibaüzenet.
target	string	A hibacél.

ErrorResponse

Tárgy

Hibaválasz

Név	Típus	Leírás
error	ErrorDetail	A hibaobjektum.

Identity

Tárgy

Az erőforrás identitása.

Név	Típus	Leírás
principalId	string (uuid)	Az erőforrás-identitás egyszerű azonosítója. Az értéknek UUID-nek kell lennie.
tenantId	string (uuid)	Az erőforrás bérlőazonosítója. Az értéknek UUID-nek kell lennie.
type	ResourceIdentityType	Az identitás típusa.

PrivateLinkScopedResource

Tárgy

A csatolt privát kapcsolati hatókör erőforrásainak listája.

Név	Típus	Leírás
resourceId	string	A privát kapcsolat hatókörének erőforrásának teljes erőforrás-azonosítója.
scopeId	string	A privát kapcsolat hatókörének egyedi azonosítója.

PublicNetworkAccessType

Felsorolás

A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.

Érték	Leírás
Enabled	Lehetővé teszi a Log Analyticshez való csatlakozást nyilvános DNS-en keresztül.
Disabled	Letiltja a nyilvános kapcsolatot a Log Analyticshez nyilvános DNS-en keresztül.
SecuredByPerimeter	Az erőforrás csak magánhálózatokról érhető el, és az erőforráshoz társított hálózati biztonsági szegélyhálózat által jóváhagyott hozzáférés.

ResourceIdentityType

Felsorolás

Az identitás típusa.

Érték	Leírás
SystemAssigned

systemData

Tárgy

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Név	Típus	Leírás
createdAt	string (date-time)	Az erőforrás-létrehozás időbélyege (UTC).
createdBy	string	Az erőforrást létrehozó identitás.
createdByType	createdByType	Az erőforrást létrehozó identitás típusa.
lastModifiedAt	string (date-time)	Az erőforrás utolsó módosításának időbélyege (UTC)
lastModifiedBy	string	Az erőforrást legutóbb módosító identitás.
lastModifiedByType	createdByType	Az erőforrást legutóbb módosító identitás típusa.

Workspace

Tárgy

A legfelső szintű munkaterület-erőforrás-tároló.

Név	Típus	Alapértelmezett érték	Leírás
etag	string		A munkaterület etagje.
id	string		Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	Identity		Az erőforrás identitása.
location	string		Az a földrajzi hely, ahol az erőforrás él
name	string		Az erőforrás neve
properties.createdDate	string (date-time)		Munkaterület létrehozásának dátuma.
properties.customerId	string		Ez egy csak olvasható tulajdonság. A munkaterülethez társított azonosítót jelöli.
properties.defaultDataCollectionRuleResourceId	string		A munkaterülethez használandó alapértelmezett adatgyűjtési szabály erőforrás-azonosítója. A várt formátum : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}.
properties.failover	WorkspaceFailoverProperties		munkaterület feladatátvételi tulajdonságai.
properties.features	WorkspaceFeatures		Munkaterületi funkciók.
properties.forceCmkForQuery	boolean		Azt jelzi, hogy az ügyfél által felügyelt tárolás kötelező-e a lekérdezéskezeléshez.
properties.modifiedDate	string (date-time)		Munkaterület módosításának dátuma.
properties.privateLinkScopedResources	PrivateLinkScopedResource[]		A csatolt privát kapcsolati hatókör erőforrásainak listája.
properties.provisioningState	WorkspaceEntityStatus		A munkaterület kiépítési állapota.
properties.publicNetworkAccessForIngestion	PublicNetworkAccessType	Enabled	A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa.
properties.publicNetworkAccessForQuery	PublicNetworkAccessType	Enabled	A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa.
properties.replication	WorkspaceReplicationProperties		munkaterület replikációs tulajdonságai.
properties.retentionInDays	integer (int32)		A munkaterület adatmegőrzési ideje napokban. Az engedélyezett értékek tarifacsomagonként vannak megadva. Részletekért tekintse meg a tarifacsomagok dokumentációját.
properties.sku	WorkspaceSku		A munkaterület termékváltozata.
properties.workspaceCapping	WorkspaceCapping		A betöltés napi kötetkorlátja.
systemData	systemData		Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
tags	object		Erőforráscímkék.
type	string		Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

WorkspaceCapping

Tárgy

A betöltés napi kötetkorlátja.

Név	Típus	Leírás
dailyQuotaGb	number (double)	A munkaterület napi betöltési kvótája.
dataIngestionStatus	DataIngestionStatus	A munkaterület adatbetöltésének állapota.
quotaNextResetTime	string	Az az idő, amikor a kvóta nyugalmi állapotban lesz.

WorkspaceEntityStatus

Felsorolás

A munkaterület kiépítési állapota.

Érték	Leírás
Creating
Succeeded
Failed
Canceled
Deleting
ProvisioningAccount
Updating

WorkspaceFailoverProperties

Tárgy

munkaterület feladatátvételi tulajdonságai.

Név	Típus	Leírás
lastModifiedDate	string (date-time)	A feladatátvételi állapot utolsó frissítése.
state	WorkspaceFailoverState	A replikáció feladatátvételi állapota.

WorkspaceFailoverState

Felsorolás

A replikáció feladatátvételi állapota.

Érték	Leírás
Inactive
Activating
Active
Deactivating
Failed

WorkspaceFeatures

Tárgy

Munkaterületi funkciók.

Név	Típus	Leírás
associations	string[]	A munkaterület társításainak listája. Azt jelzi, hogy a munkaterület társítva van-e a következő élmények valamelyikéhez: MDC, Sentinel, SentinelGraph stb.
clusterResourceId	string	Dedikált LA-fürt resourceId azonosítója, amely a munkaterületekhez van csatolva.
disableLocalAuth	boolean	Tiltsa le a nem AAD-alapú hitelesítést.
enableDataExport	boolean	Az adatok exportálását jelző jelző.
enableLogAccessUsingOnlyResourcePermissions	boolean	A használati engedélyt jelző jelölő – erőforrás vagy munkaterület vagy mindkettő.
immediatePurgeDataOn30Days	boolean	Jelölő, amely leírja, hogy 30 nap után el szeretnénk-e távolítani az adatokat.
unifiedSentinelBillingOnly	boolean	Annak jelzése, hogy a megadott munkaterület csak a sentinel egységes számlázási modelljére korlátozódik-e.

WorkspaceReplicationProperties

Tárgy

munkaterület replikációs tulajdonságai.

Név	Típus	Leírás
createdDate	string (date-time)	A replikáció utolsó engedélyezése.
enabled	boolean	Megadja, hogy a replikáció engedélyezve van-e. Ha igaz, a munkaterület konfigurációja és adatai a megadott helyre replikálódnak. Ha a replikáció engedélyezve van, meg kell adni a helyet.
lastModifiedDate	string (date-time)	A replikáció utolsó frissítése.
location	string	A replikáció helye.
provisioningState	WorkspaceReplicationState	A replikáció kiépítési állapota.

WorkspaceReplicationState

Felsorolás

A replikáció kiépítési állapota.

Érték	Leírás
Succeeded
EnableRequested
Enabling
DisableRequested
Disabling
RollbackRequested
RollingBack
Failed
Canceled

WorkspaceSku

Tárgy

A munkaterület termékváltozata.

Név	Típus	Leírás
capacityReservationLevel	integer (int32)	A kapacitásfoglalás szintje GB-ban ezen a munkaterületen, amikor a CapacityReservation termékváltozat ki van választva.
lastSkuUpdate	string (date-time)	Az utolsó alkalom, amikor a termékváltozat frissült.
name	WorkspaceSkuNameEnum	Az termékváltozat neve.

WorkspaceSkuNameEnum

Felsorolás

Az termékváltozat neve.

Érték	Leírás
Free
Standard
Premium
PerNode
PerGB2018
Standalone
CapacityReservation
LACluster