Workspaces - Create Or Update
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=2023-09-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket. |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
workspace
|
path | True |
string |
A munkaterület neve. Regex pattern: |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
location | True |
string |
Az a földrajzi hely, ahol az erőforrás él |
etag |
string |
A munkaterület etagje. |
|
identity |
Az erőforrás identitása. |
||
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.features |
Munkaterületi funkciók. |
||
properties.forceCmkForQuery |
boolean |
Azt jelzi, hogy az ügyfél által felügyelt tároló kötelező-e a lekérdezéskezeléshez. |
|
properties.publicNetworkAccessForIngestion |
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa. |
||
properties.publicNetworkAccessForQuery |
A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa. |
||
properties.retentionInDays |
integer |
A munkaterület adatmegőrzése napokban. Az engedélyezett értékek díjszabási csomagonként vannak megadva. A részletekért tekintse meg a tarifacsomagok dokumentációját. |
|
properties.sku |
A munkaterület termékváltozata. |
||
properties.workspaceCapping |
A betöltés napi kötetkorlátja. |
||
tags |
object |
Erőforráscímkék. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK válaszdefiníció. |
|
201 Created |
Létrehozott válaszdefiníció. |
|
202 Accepted |
Elfogadva |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
WorkspacesCreate
Sample Request
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2023-09-01
{
"properties": {
"sku": {
"name": "PerGB2018"
},
"retentionInDays": 30
},
"location": "australiasoutheast",
"tags": {
"tag1": "val1"
}
}
Sample Response
{
"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"
}
}
Definíciók
Name | Description |
---|---|
Capacity |
A munkaterület kapacitásfoglalási szintje GB-ban, amikor a CapacityReservation termékváltozat van kiválasztva. |
created |
Az erőforrást létrehozó identitás típusa. |
Data |
A munkaterület adatbetöltésének állapota. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Identity |
Az erőforrás identitása. |
Identity |
A felügyeltszolgáltatás-identitás típusa. |
Private |
A privát kapcsolat hatókörének erőforrás-referenciája. |
Public |
A Log Analytics-munkaterületen való üzemeltetés hálózati hozzáférési típusa. Alapértelmezés szerint engedélyezve van |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
User |
Felhasználó által hozzárendelt identitástulajdonságok. |
Workspace |
A munkaterület legfelső szintű erőforrástárolója. |
Workspace |
A betöltés napi kötetkorlátja. |
Workspace |
A munkaterület kiépítési állapota. |
Workspace |
Munkaterületi funkciók. |
Workspace |
A munkaterület termékváltozata (szintje). |
Workspace |
A termékváltozat neve. |
CapacityReservationLevel
A munkaterület kapacitásfoglalási szintje GB-ban, amikor a CapacityReservation termékváltozat van kiválasztva.
Name | Típus | Description |
---|---|---|
100 |
Integer |
|
1000 |
Integer |
|
10000 |
Integer |
|
200 |
Integer |
|
2000 |
Integer |
|
25000 |
Integer |
|
300 |
Integer |
|
400 |
Integer |
|
500 |
Integer |
|
5000 |
Integer |
|
50000 |
Integer |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataIngestionStatus
A munkaterület adatbetöltésének állapota.
Name | Típus | Description |
---|---|---|
ApproachingQuota |
string |
Elérte a napi korlátkvóta 80%-át. |
ForceOff |
string |
A betöltés leállt a szolgáltatásbeállítás módosítása után. |
ForceOn |
string |
A betöltés a szolgáltatásbeállítás módosítását követően kezdődött el. |
OverQuota |
string |
Elérte a napi korlátkvótát, a betöltés leállt. |
RespectQuota |
string |
A betöltés a napi korlátkvóta alaphelyzetbe állítása vagy az előfizetés engedélyezése után engedélyezve van. |
SubscriptionSuspended |
string |
A betöltés felfüggesztett előfizetés után leállt. |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
Identity
Az erőforrás identitása.
Name | Típus | Description |
---|---|---|
principalId |
string |
Az erőforrás-identitás fő azonosítója. |
tenantId |
string |
Az erőforrás bérlőazonosítója. |
type |
A felügyeltszolgáltatás-identitás típusa. |
|
userAssignedIdentities |
<string,
User |
Az erőforráshoz társított felhasználói identitások listája. A felhasználói identitás szótárának kulcshivatkozásai a következő űrlapon található ARM-erőforrás-azonosítók: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". |
IdentityType
A felügyeltszolgáltatás-identitás típusa.
Name | Típus | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
PrivateLinkScopedResource
A privát kapcsolat hatókörének erőforrás-referenciája.
Name | Típus | Description |
---|---|---|
resourceId |
string |
A privát kapcsolat hatókör-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
A Log Analytics-munkaterületen való üzemeltetés hálózati hozzáférési típusa. Alapértelmezés szerint engedélyezve van
Name | Típus | Description |
---|---|---|
Disabled |
string |
Letiltja a Log Analytics nyilvános DNS-kapcsolatát. |
Enabled |
string |
Engedélyezi a Log Analyticshez való csatlakozást a nyilvános DNS-kapcsolaton keresztül. |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az az identitás, amely legutóbb módosította az erőforrást. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
UserIdentityProperties
Felhasználó által hozzárendelt identitástulajdonságok.
Name | Típus | Description |
---|---|---|
clientId |
string |
A felhasználó által hozzárendelt identitás ügyfélazonosítója. |
principalId |
string |
A felhasználó által hozzárendelt identitás egyszerű azonosítója. |
Workspace
A munkaterület legfelső szintű erőforrástárolója.
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
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 |
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 |
Munkaterület létrehozásának dátuma. |
|
properties.customerId |
string |
Ez egy írásvédett 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.features |
Munkaterületi funkciók. |
||
properties.forceCmkForQuery |
boolean |
Azt jelzi, hogy az ügyfél által felügyelt tároló kötelező-e a lekérdezéskezeléshez. |
|
properties.modifiedDate |
string |
Munkaterület módosításának dátuma. |
|
properties.privateLinkScopedResources |
A csatolt privát kapcsolat hatókör-erőforrásainak listája. |
||
properties.provisioningState |
A munkaterület kiépítési állapota. |
||
properties.publicNetworkAccessForIngestion | Enabled |
A Log Analytics-betöltéshez való hozzáférés hálózati hozzáférési típusa. |
|
properties.publicNetworkAccessForQuery | Enabled |
A Log Analytics-lekérdezés elérésének hálózati hozzáférési típusa. |
|
properties.retentionInDays |
integer |
A munkaterület adatmegőrzése napokban. Az engedélyezett értékek díjszabási csomagonként vannak megadva. A részletekért tekintse meg a tarifacsomagok dokumentációját. |
|
properties.sku |
A munkaterület termékváltozata. |
||
properties.workspaceCapping |
A betöltés napi kötetkorlátja. |
||
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. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
WorkspaceCapping
A betöltés napi kötetkorlátja.
Name | Típus | Description |
---|---|---|
dailyQuotaGb |
number |
A munkaterület napi betöltési kvótája. |
dataIngestionStatus |
A munkaterület adatbetöltésének állapota. |
|
quotaNextResetTime |
string |
Az az idő, amikor a kvóta pihen. |
WorkspaceEntityStatus
A munkaterület kiépítési állapota.
Name | Típus | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
ProvisioningAccount |
string |
|
Succeeded |
string |
|
Updating |
string |
WorkspaceFeatures
Munkaterületi funkciók.
Name | Típus | Description |
---|---|---|
clusterResourceId |
string |
Dedikált LA-fürt erőforrásazonosítója, amely a munkaterületekhez van csatolva. |
disableLocalAuth |
boolean |
Tiltsa le a nem AAD-alapú hitelesítést. |
enableDataExport |
boolean |
Jelölő, amely jelzi, hogy exportálni kell-e az adatokat. |
enableLogAccessUsingOnlyResourcePermissions |
boolean |
Megjelölés, amely jelzi, hogy melyik engedélyt használhatja – erőforrást vagy munkaterületet vagy mindkettőt. |
immediatePurgeDataOn30Days |
boolean |
Jelölő, amely leírja, hogy 30 nap elteltével el szeretnénk-e távolítani az adatokat. |
unifiedSentinelBillingOnly |
boolean |
Annak jelzése, hogy a megadott munkaterület csak a Sentinel egyesített számlázási modelljére korlátozódik-e. |
WorkspaceSku
A munkaterület termékváltozata (szintje).
Name | Típus | Description |
---|---|---|
capacityReservationLevel |
A munkaterület kapacitásfoglalási szintje GB-ban, amikor a CapacityReservation termékváltozat van kiválasztva. |
|
lastSkuUpdate |
string |
A termékváltozat utolsó frissítésének időpontja. |
name |
A termékváltozat neve. |
WorkspaceSkuNameEnum
A termékváltozat neve.
Name | Típus | Description |
---|---|---|
CapacityReservation |
string |
|
Free |
string |
|
LACluster |
string |
|
PerGB2018 |
string |
|
PerNode |
string |
|
Premium |
string |
|
Standalone |
string |
|
Standard |
string |