Bookmarks - Get

Pobiera zakładkę.

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

Parametry identyfikatora URI

Name In Required Type Description
bookmarkId
path True
  • string

Identyfikator zakładki

resourceGroupName
path True
  • string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

subscriptionId
path True
  • string

Identyfikator subskrypcji docelowej.

workspaceName
path True
  • string

Nazwa obszaru roboczego.

api-version
query True
  • string

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Name Type Description
200 OK

OK, Operacja została pomyślnie ukończona

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

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 personifikacja konta użytkownika

Przykłady

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

Definicje

Bookmark

Reprezentuje zakładkę w usłudze Azure Security Szczegółowe informacje.

CloudError

Struktura odpowiedzi na błędy.

CloudErrorBody

Szczegóły błędu.

createdByType

Typ tożsamości, która utworzyła zasób.

IncidentInfo

Opisuje powiązane informacje o zdarzeniu dla zakładki

IncidentSeverity

Ważność zdarzenia

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UserInfo

Informacje o użytkowniku, które wykonały jakąś akcję

Bookmark

Reprezentuje zakładkę w usłudze Azure Security Szczegółowe informacje.

Name Type Description
etag
  • string

Etag zasobu platformy Azure

id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nazwa zasobu

properties.created
  • string

Godzina utworzenia zakładki

properties.createdBy

Opisuje użytkownika, który utworzył zakładkę

properties.displayName
  • string

Nazwa wyświetlana zakładki

properties.eventTime
  • string

Godzina zdarzenia zakładki

properties.incidentInfo

Opisuje zdarzenie związane z zakładką

properties.labels
  • string[]

Lista etykiet istotnych dla tej zakładki

properties.notes
  • string

Notatki zakładki

properties.query
  • string

Zapytanie zakładki.

properties.queryEndTime
  • string

Godzina zakończenia zapytania

properties.queryResult
  • string

Wynik zapytania zakładki.

properties.queryStartTime
  • string

Godzina rozpoczęcia zapytania

properties.updated
  • string

Czas ostatniej aktualizacji zakładki

properties.updatedBy

Opisuje użytkownika, który zaktualizował zakładkę

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type
  • string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

CloudError

Struktura odpowiedzi na błędy.

Name Type Description
error

Dane o błędach

CloudErrorBody

Szczegóły błędu.

Name Type Description
code
  • string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

message
  • string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

createdByType

Typ tożsamości, która utworzyła zasób.

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

IncidentInfo

Opisuje powiązane informacje o zdarzeniu dla zakładki

Name Type Description
incidentId
  • string

Identyfikator zdarzenia

relationName
  • string

Nazwa relacji

severity

Ważność zdarzenia

title
  • string

Tytuł zdarzenia

IncidentSeverity

Ważność zdarzenia

Name Type Description
High
  • string

Wysoka ważność

Informational
  • string

Ważność informacyjna

Low
  • string

Niska ważność

Medium
  • string

Średnia ważność

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Name Type Description
createdAt
  • string

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

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.

UserInfo

Informacje o użytkowniku, które wykonały jakąś akcję

Name Type Description
email
  • string

adres e-mail użytkownika.

name
  • string

Nazwa użytkownika.

objectId
  • string

Identyfikator obiektu użytkownika.