Bookmarks - Get

Service:

Sentinel

API Version:

2024-03-01

Könyvjelzőt kap.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/providers/Microsoft.SecurityInsights/bookmarks/{bookmarkId}?api-version=2024-03-01

URI-paraméterek

Name	In	Kötelező	Típus	Description
bookmarkId	path	True	string	Könyvjelző azonosítója
resourceGroupName	path	True	string	Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string	A cél-előfizetés azonosítója.
workspaceName	path	True	string	A munkaterület neve. Regex pattern: ^[A-Za-z0-9][A-Za-z0-9-]+[A-Za-z0-9]$
api-version	query	True	string	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	Bookmark	OK, a művelet sikeresen befejeződött
Other Status Codes	CloudError	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

Get a bookmark.

Sample Request

HTTP

GET https://management.azure.com/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/bookmarks/73e01a99-5cd7-4139-a149-9f2736ff2ab5?api-version=2024-03-01

Sample Response

Status code:

200

{
  "id": "/subscriptions/d0cfe6b2-9ac0-4464-9919-dccaee2e48c0/resourceGroups/myRg/providers/Microsoft.OperationalInsights/workspaces/myWorkspace/providers/Microsoft.SecurityInsights/bookmarks/73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "name": "73e01a99-5cd7-4139-a149-9f2736ff2ab5",
  "type": "Microsoft.SecurityInsights/bookmarks",
  "etag": "\"0300bf09-0000-0000-0000-5c37296e0000\"",
  "properties": {
    "displayName": "My bookmark",
    "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"
    },
    "updated": "2019-01-01T13:15:30Z",
    "created": "2019-01-01T13:15:30Z",
    "notes": "Found a suspicious activity",
    "labels": [
      "Tag1",
      "Tag2"
    ],
    "query": "SecurityEvent | where TimeGenerated > ago(1d) and TimeGenerated < ago(2d)",
    "queryResult": "Security Event query result",
    "incidentInfo": {
      "incidentId": "DDA55F97-170B-40B9-B8ED-CBFD05481E7D",
      "severity": "Low",
      "title": "New case 1",
      "relationName": "4bb36b7b-26ff-4d1c-9cbe-0d8ab3da0018"
    }
  }
}

Definíciók

Name	Description
Bookmark	Egy könyvjelzőt jelöl az Azure Security Insightsban.
CloudError	Hibaválasz-struktúra.
CloudErrorBody	Hiba részletei.
createdByType	Az erőforrást létrehozó identitás típusa.
IncidentInfo	A könyvjelző kapcsolódó incidensadatainak ismertetése
IncidentSeverity	Az incidens súlyossága
systemData	Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
UserInfo	Felhasználói adatok, amelyek valamilyen műveletet hajtottak végre

Bookmark

Egy könyvjelzőt jelöl az Azure Security Insightsban.

Name	Típus	Description
etag	string	Az Azure-erőforrás etagje
id	string	Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Az erőforrás neve
properties.created	string	A könyvjelző létrehozásának időpontja
properties.createdBy	UserInfo	A könyvjelzőt létrehozó felhasználó ismertetése
properties.displayName	string	A könyvjelző megjelenítendő neve
properties.eventTime	string	A könyvjelző eseményideje
properties.incidentInfo	IncidentInfo	A könyvjelzőhöz kapcsolódó incidens leírása
properties.labels	string[]	A könyvjelzőhöz kapcsolódó címkék listája
properties.notes	string	A könyvjelző jegyzetei
properties.query	string	A könyvjelző lekérdezése.
properties.queryEndTime	string	A lekérdezés befejezési időpontja
properties.queryResult	string	A könyvjelző lekérdezési eredménye.
properties.queryStartTime	string	A lekérdezés kezdési időpontja
properties.updated	string	A könyvjelző legutóbbi frissítésének időpontja
properties.updatedBy	UserInfo	A könyvjelzőt frissített felhasználó leírása
systemData	systemData	Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatok.
type	string	Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

CloudError

Hibaválasz-struktúra.

Name	Típus	Description
error	CloudErrorBody	Hibaadatok

CloudErrorBody

Hiba részletei.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.

createdByType

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

Name	Típus	Description
Application	string
Key	string
ManagedIdentity	string
User	string

IncidentInfo

A könyvjelző kapcsolódó incidensadatainak ismertetése

Name	Típus	Description
incidentId	string	Incidens azonosítója
relationName	string	Relációs név
severity	IncidentSeverity	Az incidens súlyossága
title	string	Az incidens címe

IncidentSeverity

Az incidens súlyossága

Name	Típus	Description
High	string	Nagy súlyosság
Informational	string	Információs súlyosság
Low	string	Alacsony súlyosság
Medium	string	Közepes súlyosság

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	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	createdByType	Az erőforrást legutóbb módosító identitás típusa.

UserInfo

Felhasználói adatok, amelyek valamilyen műveletet hajtottak végre

Name	Típus	Description
email	string	A felhasználó e-mail-címe.
name	string	A felhasználó neve.
objectId	string	A felhasználó objektumazonosítója.