Watchlist Items - Create Or Update
Skapa eller uppdatera ett objekt i visningslistan.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/watchlists/{watchlistAlias}/watchlistItems/{watchlistItemId}?api-version=2024-03-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
subscription
|
path | True |
string |
ID för målprenumerationen. |
watchlist
|
path | True |
string |
Visningslistans alias |
watchlist
|
path | True |
string |
Objekt-ID för visningslistan (GUID) |
workspace
|
path | True |
string |
Namnet på arbetsytan. Reguljärt uttrycksmönster: |
api-version
|
query | True |
string |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
properties.itemsKeyValue | True |
object |
nyckel/värde-par för ett visningslisteobjekt |
etag |
string |
Etag för Azure-resursen |
|
properties.created |
string |
Den tid då visningslisteobjektet skapades |
|
properties.createdBy |
Beskriver en användare som skapade visningslisteobjektet |
||
properties.entityMapping |
object |
nyckel/värde-par för en objektentitetsmappning i visningslistan |
|
properties.isDeleted |
boolean |
En flagga som anger om objektet i visningslistan tas bort eller inte |
|
properties.tenantId |
string |
TenantId som visningslisteobjektet tillhör |
|
properties.updated |
string |
Senaste gången objektet i visningslistan uppdaterades |
|
properties.updatedBy |
Beskriver en användare som har uppdaterat visningslisteobjektet |
||
properties.watchlistItemId |
string |
ID:t (ett GUID) för visningslisteobjektet |
|
properties.watchlistItemType |
string |
Typ av visningslisteobjekt |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
201 Created |
Skapad |
|
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
Create or update a watchlist item.
Exempelbegäran
PUT https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/watchlists/highValueAsset/watchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842?api-version=2024-03-01
{
"etag": "0300bf09-0000-0000-0000-5c37296e0000",
"properties": {
"itemsKeyValue": {
"Gateway subnet": "10.0.255.224/27",
"Web Tier": "10.0.1.0/24",
"Business tier": "10.0.2.0/24",
"Data tier": "10.0.2.0/24",
"Private DMZ in": "10.0.0.0/27",
"Public DMZ out": "10.0.0.96/27"
}
}
}
Exempelsvar
{
"id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Watchlists/highValueAsset/WatchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842",
"etag": "0300bf09-0000-0000-0000-5c37296e0000",
"type": "Microsoft.SecurityInsights/Watchlists/WatchlistItems",
"properties": {
"watchlistItemType": "watchlist-item",
"watchlistItemId": "82ba292c-dc97-4dfc-969d-d4dd9e666842",
"tenantId": "4008512e-1d30-48b2-9ee2-d3612ed9d3ea",
"isDeleted": false,
"created": "2020-11-15T04:58:56.0748363+00:00",
"updated": "2020-11-16T16:05:20+00:00",
"createdBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"updatedBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"itemsKeyValue": {
"Gateway subnet": "10.0.255.224/27",
"Web Tier": "10.0.1.0/24",
"Business tier": "10.0.2.0/24",
"Data tier": "10.0.2.0/24",
"Private DMZ in": "10.0.0.0/27",
"Public DMZ out": "10.0.0.96/27"
}
}
}
{
"id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/Watchlists/highValueAsset/WatchlistItems/82ba292c-dc97-4dfc-969d-d4dd9e666842",
"etag": "0300bf09-0000-0000-0000-5c37296e0000",
"type": "Microsoft.SecurityInsights/Watchlists/WatchlistItems",
"properties": {
"watchlistItemType": "watchlist-item",
"watchlistItemId": "82ba292c-dc97-4dfc-969d-d4dd9e666842",
"tenantId": "4008512e-1d30-48b2-9ee2-d3612ed9d3ea",
"isDeleted": false,
"created": "2020-11-15T04:58:56.0748363+00:00",
"updated": "2020-11-16T16:05:20+00:00",
"createdBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"updatedBy": {
"objectId": "2046feea-040d-4a46-9e2b-91c2941bfa70",
"email": "john@contoso.com",
"name": "john doe"
},
"itemsKeyValue": {
"Gateway subnet": "10.0.255.224/27",
"Web Tier": "10.0.1.0/24",
"Business tier": "10.0.2.0/24",
"Data tier": "10.0.2.0/24",
"Private DMZ in": "10.0.0.0/27",
"Public DMZ out": "10.0.0.96/27"
}
}
}
Definitioner
Name | Description |
---|---|
Cloud |
Felsvarsstruktur. |
Cloud |
Felinformation. |
created |
Den typ av identitet som skapade resursen. |
system |
Metadata som rör skapande och senaste ändring av resursen. |
User |
Användarinformation som har utfört en viss åtgärd |
Watchlist |
Representerar ett visningslisteobjekt i Azure Security Insights. |
CloudError
Felsvarsstruktur.
Name | Typ | Description |
---|---|---|
error |
Feldata |
CloudErrorBody
Felinformation.
Name | Typ | Description |
---|---|---|
code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
message |
string |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
createdByType
Den typ av identitet som skapade resursen.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
systemData
Metadata som rör skapande och senaste ändring av resursen.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Tidsstämpeln för resursskapande (UTC). |
createdBy |
string |
Identiteten som skapade resursen. |
createdByType |
Den typ av identitet som skapade resursen. |
|
lastModifiedAt |
string |
Tidsstämpeln för resursens senaste ändring (UTC) |
lastModifiedBy |
string |
Identiteten som senast ändrade resursen. |
lastModifiedByType |
Den typ av identitet som senast ändrade resursen. |
UserInfo
Användarinformation som har utfört en viss åtgärd
Name | Typ | Description |
---|---|---|
string |
Användarens e-postadress. |
|
name |
string |
Användarens namn. |
objectId |
string |
Användarens objekt-ID. |
WatchlistItem
Representerar ett visningslisteobjekt i Azure Security Insights.
Name | Typ | Description |
---|---|---|
etag |
string |
Etag för Azure-resursen |
id |
string |
Fullständigt kvalificerat resurs-ID för resursen. Exempel – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Namnet på resursen |
properties.created |
string |
Den tid då visningslisteobjektet skapades |
properties.createdBy |
Beskriver en användare som skapade visningslisteobjektet |
|
properties.entityMapping |
object |
nyckel/värde-par för en objektentitetsmappning i visningslistan |
properties.isDeleted |
boolean |
En flagga som anger om objektet i visningslistan tas bort eller inte |
properties.itemsKeyValue |
object |
nyckel/värde-par för ett visningslisteobjekt |
properties.tenantId |
string |
TenantId som visningslisteobjektet tillhör |
properties.updated |
string |
Senaste gången objektet i visningslistan uppdaterades |
properties.updatedBy |
Beskriver en användare som har uppdaterat visningslisteobjektet |
|
properties.watchlistItemId |
string |
ID:t (ett GUID) för visningslisteobjektet |
properties.watchlistItemType |
string |
Typ av visningslisteobjekt |
systemData |
Azure Resource Manager metadata som innehåller createdBy och modifiedBy-information. |
|
type |
string |
Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts" |