Bookmarks - Get

Ruft eine Textmarke ab.

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

URI-Parameter

Name In Required Type Description
bookmarkId
path True
  • string

Lesezeichen-ID

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True
  • string

Hierbei handelt es sich um die ID des Zielabonnements.

workspaceName
path True
  • string

Den Namen des Arbeitsbereichs

api-version
query True
  • string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Type Description
200 OK

OK, Vorgang erfolgreich abgeschlossen

Other Status Codes

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

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 Identitätswechsel Ihres Benutzerkontos

Beispiele

Get a bookmark.

Sample Request

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=2021-10-01

Sample Response

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

Definitionen

Bookmark

Stellt eine Textmarke in Azure Security Insights dar.

CloudError

Fehlerantwortstruktur.

CloudErrorBody

Fehlerdetails.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

IncidentInfo

Beschreibt verwandte Vorfallinformationen für die Textmarke

IncidentSeverity

Der Schweregrad des Vorfalls

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

UserInfo

Benutzerinformationen, die einige Aktionen ausgeführt haben

Bookmark

Stellt eine Textmarke in Azure Security Insights dar.

Name Type Description
etag
  • string

Etag der Azure-Ressource

id
  • string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptionId}/resourceGroups/{resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Der Name der Ressource

properties.created
  • string

Die Zeit, zu der die Textmarke erstellt wurde

properties.createdBy

Beschreibt einen Benutzer, der die Textmarke erstellt hat

properties.displayName
  • string

Der Anzeigename der Textmarke

properties.eventTime
  • string

Die Zeit des Lesezeichenereignisses

properties.incidentInfo

Beschreibt einen Vorfall, der sich auf textmarke bezieht

properties.labels
  • string[]

Liste der Bezeichnungen, die für diese Textmarke relevant sind

properties.notes
  • string

Die Notizen der Textmarke

properties.query
  • string

Die Abfrage der Textmarke.

properties.queryEndTime
  • string

Die Endzeit für die Abfrage

properties.queryResult
  • string

Das Abfrageergebnis der Textmarke.

properties.queryStartTime
  • string

Die Startzeit für die Abfrage

properties.updated
  • string

Das letzte Mal, wenn die Textmarke aktualisiert wurde

properties.updatedBy

Beschreibt einen Benutzer, der die Textmarke aktualisiert hat

systemData

Azure Resource Manager Metadaten, die "createdBy" und "modifiedBy"-Informationen enthalten.

type
  • string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft. Storage/storageAccounts"

CloudError

Fehlerantwortstruktur.

Name Type Description
error

Fehlerdaten

CloudErrorBody

Fehlerdetails.

Name Type Description
code
  • string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden.

message
  • string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige auf einer Benutzeroberfläche geeignet ist.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

IncidentInfo

Beschreibt verwandte Vorfallinformationen für die Textmarke

Name Type Description
incidentId
  • string

Vorfall-ID

relationName
  • string

Beziehungsname

severity

Der Schweregrad des Vorfalls

title
  • string

Der Titel des Vorfalls

IncidentSeverity

Der Schweregrad des Vorfalls

Name Type Description
High
  • string

Hoher Schweregrad

Informational
  • string

Informationsschweregrad

Low
  • string

Niedriger Schweregrad

Medium
  • string

Mittlerer Schweregrad

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Type Description
createdAt
  • string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy
  • string

Die Identität, die die Ressource erstellt hat.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt
  • string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy
  • string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserInfo

Benutzerinformationen, die einige Aktionen ausgeführt haben

Name Type Description
email
  • string

Die E-Mail-Adresse des Benutzers.

name
  • string

Der Name des Benutzers.

objectId
  • string

Die Objekt-ID des Benutzers.