Workspaces - Create Or Update
Tworzenie lub aktualizowanie obszaru roboczego.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2025-07-01
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
path | True |
string (uuid) |
Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID. |
|
workspace
|
path | True |
string minLength: 4maxLength: 63 pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$ |
Nazwa obszaru roboczego. |
|
api-version
|
query | True |
string minLength: 1 |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| location | True |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
| etag |
string |
Element etag obszaru roboczego. |
|
| identity |
Tożsamość zasobu. |
||
| properties.defaultDataCollectionRuleResourceId |
string |
Identyfikator zasobu domyślnej reguły zbierania danych do użycia w tym obszarze roboczym. Oczekiwany format to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
właściwości trybu failover obszaru roboczego. |
||
| properties.features |
Funkcje obszaru roboczego. |
||
| properties.forceCmkForQuery |
boolean |
Wskazuje, czy magazyn zarządzany przez klienta jest obowiązkowy do zarządzania zapytaniami. |
|
| properties.publicNetworkAccessForIngestion |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics. |
||
| properties.publicNetworkAccessForQuery |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do zapytania usługi Log Analytics. |
||
| properties.replication |
właściwości replikacji obszaru roboczego. |
||
| properties.retentionInDays |
integer (int32) |
Okres przechowywania danych obszaru roboczego w dniach. Dozwolone wartości są według planu cenowego. Aby uzyskać szczegółowe informacje, zobacz dokumentację warstw cenowych. |
|
| properties.sku |
Jednostka SKU obszaru roboczego. |
||
| properties.workspaceCapping |
Dzienny limit ilości na potrzeby pozyskiwania. |
||
| tags |
object |
Tagi zasobów. |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
Operacja aktualizacji zasobu "Obszar roboczy" powiodła się |
|
| 201 Created |
Operacja tworzenia zasobu "Obszar roboczy" powiodła się Nagłówki
|
|
| 202 Accepted |
Zaakceptowano operację zasobu. Nagłówki
|
|
| Other Status Codes |
Nieoczekiwana odpowiedź na błąd. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 w usłudze Azure Active Directory.
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
| Nazwa | Opis |
|---|---|
| user_impersonation | personifikacja konta użytkownika |
Przykłady
WorkspacesCreate
Przykładowe żądanie
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2025-07-01
{
"location": "australiasoutheast",
"properties": {
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
},
"tags": {
"tag1": "val1"
}
}
Przykładowa odpowiedź
{
"name": "AzTest2170",
"type": "Microsoft.OperationalInsights/workspaces",
"id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
"location": "australiasoutheast",
"properties": {
"customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
"provisioningState": "Creating",
"publicNetworkAccessForIngestion": "Enabled",
"publicNetworkAccessForQuery": "Enabled",
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
},
"tags": {
"tag1": "val1"
}
}
{
"name": "AzTest2170",
"type": "Microsoft.OperationalInsights/workspaces",
"id": "/subscriptions/00000000-0000-0000-0000-000000000005/resourcegroups/oiautorest6685/providers/microsoft.operationalinsights/workspaces/aztest2170",
"location": "australiasoutheast",
"properties": {
"customerId": "bc089d7b-485c-4aff-a71e-c00f362d8d2f",
"provisioningState": "Creating",
"publicNetworkAccessForIngestion": "Enabled",
"publicNetworkAccessForQuery": "Enabled",
"retentionInDays": 30,
"sku": {
"name": "PerGB2018"
}
},
"tags": {
"tag1": "val1"
}
}
Definicje
| Nazwa | Opis |
|---|---|
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Data |
Stan pozyskiwania danych dla tego obszaru roboczego. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
| Identity |
Tożsamość zasobu. |
|
Identity |
Typ tożsamości usługi zarządzanej. |
|
Private |
Odwołanie do zasobu zakresu łącza prywatnego. |
|
Public |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics. |
|
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
|
User |
Właściwości tożsamości przypisanej przez użytkownika. |
| Workspace |
Kontener zasobów obszaru roboczego najwyższego poziomu. |
|
Workspace |
Dzienny limit ilości na potrzeby pozyskiwania. |
|
Workspace |
Stan aprowizacji obszaru roboczego. |
|
Workspace |
Stan pracy awaryjnej replikacji. |
|
Workspace |
Stan pracy awaryjnej replikacji. |
|
Workspace |
Funkcje obszaru roboczego. |
|
Workspace |
Właściwości replikacji obszaru roboczego. |
|
Workspace |
Stan aprowizacji replikacji. |
|
Workspace |
Jednostka SKU (warstwa) obszaru roboczego. |
|
Workspace |
Nazwa jednostki SKU. |
createdByType
Typ tożsamości, która utworzyła zasób.
| Wartość | Opis |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DataIngestionStatus
Stan pozyskiwania danych dla tego obszaru roboczego.
| Wartość | Opis |
|---|---|
| RespectQuota |
Pozyskiwanie włączone po zresetowaniu dziennego limitu przydziału lub włączeniu subskrypcji. |
| ForceOn |
Pozyskiwanie rozpoczęło się po zmianie ustawień usługi. |
| ForceOff |
Pozyskiwanie zostało zatrzymane po zmianie ustawień usługi. |
| OverQuota |
Osiągnięto dzienny limit przydziału, przyjmowanie zostało zatrzymane. |
| SubscriptionSuspended |
Pozyskiwanie zostało zatrzymane po zawieszeniu subskrypcji. |
| ApproachingQuota |
Osiągnięto 80% dziennego limitu. |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
| Nazwa | Typ | Opis |
|---|---|---|
| info |
object |
Dodatkowe informacje. |
| type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
| Nazwa | Typ | Opis |
|---|---|---|
| additionalInfo |
Dodatkowe informacje o błędzie. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwa | Typ | Opis |
|---|---|---|
| error |
Obiekt błędu. |
Identity
Tożsamość zasobu.
| Nazwa | Typ | Opis |
|---|---|---|
| principalId |
string |
Identyfikator podmiotu zabezpieczeń tożsamości zasobu. |
| tenantId |
string |
Identyfikator dzierżawy zasobu. |
| type |
Typ tożsamości usługi zarządzanej. |
|
| userAssignedIdentities |
<string,
User |
Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów arm w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
IdentityType
Typ tożsamości usługi zarządzanej.
| Wartość | Opis |
|---|---|
| SystemAssigned |
SystemowoPrzydzielony |
| UserAssigned |
UserAssigned |
| None |
Żadne |
PrivateLinkScopedResource
Odwołanie do zasobu zakresu łącza prywatnego.
| Nazwa | Typ | Opis |
|---|---|---|
| resourceId |
string |
Pełny identyfikator zasobu zakresu łącza prywatnego. |
| scopeId |
string |
Unikatowy identyfikator zakresu łącza prywatnego. |
PublicNetworkAccessType
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics.
| Wartość | Opis |
|---|---|
| Enabled |
Umożliwia łączność z usługą Log Analytics za pośrednictwem publicznego systemu DNS. |
| Disabled |
Wyłącza łączność publiczną z usługą Log Analytics za pośrednictwem publicznego systemu DNS. |
| SecuredByPerimeter |
Zasób jest dostępny tylko z sieci prywatnych i dostępu zatwierdzonego przez obwód zabezpieczeń sieci skojarzony z tym zasobem. |
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
| Nazwa | Typ | Opis |
|---|---|---|
| createdAt |
string (date-time) |
Sygnatura czasowa tworzenia zasobu (UTC). |
| createdBy |
string |
Tożsamość, która utworzyła zasób. |
| createdByType |
Typ tożsamości, która utworzyła zasób. |
|
| lastModifiedAt |
string (date-time) |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
| lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
| lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |
UserIdentityProperties
Właściwości tożsamości przypisanej przez użytkownika.
| Nazwa | Typ | Opis |
|---|---|---|
| clientId |
string |
Identyfikator klienta tożsamości przypisanej przez użytkownika. |
| principalId |
string |
Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. |
Workspace
Kontener zasobów obszaru roboczego najwyższego poziomu.
| Nazwa | Typ | Domyślna wartość | Opis |
|---|---|---|---|
| etag |
string |
Element etag obszaru roboczego. |
|
| id |
string (arm-id) |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
| identity |
Tożsamość zasobu. |
||
| location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
|
| name |
string |
Nazwa zasobu |
|
| properties.createdDate |
string (date-time) |
Data utworzenia obszaru roboczego. |
|
| properties.customerId |
string |
Jest to właściwość tylko do odczytu. Reprezentuje identyfikator skojarzony z obszarem roboczym. |
|
| properties.defaultDataCollectionRuleResourceId |
string |
Identyfikator zasobu domyślnej reguły zbierania danych do użycia w tym obszarze roboczym. Oczekiwany format to /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/dataCollectionRules/{dcrName}. |
|
| properties.failover |
właściwości trybu failover obszaru roboczego. |
||
| properties.features |
Funkcje obszaru roboczego. |
||
| properties.forceCmkForQuery |
boolean |
Wskazuje, czy magazyn zarządzany przez klienta jest obowiązkowy do zarządzania zapytaniami. |
|
| properties.modifiedDate |
string (date-time) |
Data modyfikacji przestrzeni roboczej. |
|
| properties.privateLinkScopedResources |
Lista połączonych zasobów zakresu łącza prywatnego. |
||
| properties.provisioningState |
Stan aprowizacji obszaru roboczego. |
||
| properties.publicNetworkAccessForIngestion | Enabled |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do pozyskiwania usługi Log Analytics. |
|
| properties.publicNetworkAccessForQuery | Enabled |
Typ dostępu do sieci na potrzeby uzyskiwania dostępu do zapytania usługi Log Analytics. |
|
| properties.replication |
właściwości replikacji obszaru roboczego. |
||
| properties.retentionInDays |
integer (int32) |
Okres przechowywania danych obszaru roboczego w dniach. Dozwolone wartości są według planu cenowego. Aby uzyskać szczegółowe informacje, zobacz dokumentację warstw cenowych. |
|
| properties.sku |
Jednostka SKU obszaru roboczego. |
||
| properties.workspaceCapping |
Dzienny limit ilości na potrzeby pozyskiwania. |
||
| systemData |
Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”. |
||
| tags |
object |
Tagi zasobów. |
|
| type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
WorkspaceCapping
Dzienny limit ilości na potrzeby pozyskiwania.
| Nazwa | Typ | Opis |
|---|---|---|
| dailyQuotaGb |
number (double) |
Dzienny limit przydziału obszaru roboczego na potrzeby pozyskiwania. |
| dataIngestionStatus |
Stan pozyskiwania danych dla tego obszaru roboczego. |
|
| quotaNextResetTime |
string |
Czas, w którym limit przydziału będzie spoczynkiem. |
WorkspaceEntityStatus
Stan aprowizacji obszaru roboczego.
| Wartość | Opis |
|---|---|
| Creating |
Tworzenie |
| Succeeded |
Succeeded |
| Failed |
Nie powiodło się |
| Canceled |
Anulowane |
| Deleting |
Usuwanie |
| ProvisioningAccount |
ProvisioningAccount |
| Updating |
Aktualizowanie |
WorkspaceFailoverProperties
Stan pracy awaryjnej replikacji.
| Nazwa | Typ | Opis |
|---|---|---|
| lastModifiedDate |
string (date-time) |
Ostatni czas aktualizacji stanu trybu failover. |
| state |
Stan pracy awaryjnej replikacji. |
WorkspaceFailoverState
Stan pracy awaryjnej replikacji.
| Wartość | Opis |
|---|---|
| Inactive |
Nieaktywna |
| Activating |
Aktywowanie |
| Active |
Aktywne |
| Deactivating |
Dezaktywowanie |
| Failed |
Nie powiodło się |
WorkspaceFeatures
Funkcje obszaru roboczego.
| Nazwa | Typ | Opis |
|---|---|---|
| associations |
string[] |
Lista powiązań dla obszaru roboczego. Wskazuje, czy obszar roboczy jest skojarzony z którymkolwiek z następujących środowisk: MDC, Sentinel, SentinelGraph itp. |
| clusterResourceId |
string |
Dedykowany identyfikator resourceId klastra la połączony z obszarami roboczymi. |
| disableLocalAuth |
boolean |
Wyłącz uwierzytelnianie oparte na usłudze AAD. |
| enableDataExport |
boolean |
Flaga wskazująca, czy dane mają być eksportowane. |
| enableLogAccessUsingOnlyResourcePermissions |
boolean |
Flaga wskazująca, które uprawnienie do użycia — zasób lub obszar roboczy lub oba te elementy. |
| immediatePurgeDataOn30Days |
boolean |
Flaga opisując, czy chcemy usunąć dane po 30 dniach. |
| unifiedSentinelBillingOnly |
boolean |
Wskazanie, czy określony obszar roboczy jest ograniczony tylko do ujednoliconego modelu rozliczeń usługi Sentinel. |
WorkspaceReplicationProperties
Właściwości replikacji obszaru roboczego.
| Nazwa | Typ | Opis |
|---|---|---|
| createdDate |
string (date-time) |
Ostatni raz, kiedy replikacja była włączona. |
| enabled |
boolean |
Określa, czy replikacja jest włączona, czy nie. W przypadku wartości true konfiguracja i dane obszaru roboczego są replikowane do określonej lokalizacji. Jeśli włączono replikację, należy podać lokalizację. |
| lastModifiedDate |
string (date-time) |
Ostatni czas aktualizacji replikacji. |
| location |
string |
Lokalizacja replikacji. |
| provisioningState |
Stan aprowizacji replikacji. |
WorkspaceReplicationState
Stan aprowizacji replikacji.
| Wartość | Opis |
|---|---|
| Succeeded |
Succeeded |
| EnableRequested |
EnableRequested |
| Enabling |
Włączanie |
| DisableRequested |
DisableRequested |
| Disabling |
Wyłączanie |
| RollbackRequested |
RollbackRequests |
| RollingBack |
RollingBack |
| Failed |
Nie powiodło się |
| Canceled |
Anulowane |
WorkspaceSku
Jednostka SKU (warstwa) obszaru roboczego.
| Nazwa | Typ | Opis |
|---|---|---|
| capacityReservationLevel |
integer (int32) |
Poziom rezerwacji pojemności w GB dla tego obszaru roboczego po wybraniu jednostki SKU CapacityReservation. |
| lastSkuUpdate |
string (date-time) |
Ostatni czas aktualizacji jednostki SKU. |
| name |
Nazwa jednostki SKU. |
WorkspaceSkuNameEnum
Nazwa jednostki SKU.
| Wartość | Opis |
|---|---|
| Free |
Bezpłatna |
| Standard |
Standard |
| Premium |
Premium |
| PerNode |
PerNode |
| PerGB2018 |
PerGB2018 |
| Standalone |
Samodzielny |
| CapacityReservation |
Rezerwacja Pojemności |
| LACluster |
LACluster |