Bookmarks - Get

Obtiene un marcador.

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

Parámetros de identificador URI

Name In Required Type Description
bookmarkId
path True
  • string

Id. de marcador

resourceGroupName
path True
  • string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True
  • string

Identificador de la suscripción de destino.

workspaceName
path True
  • string

El nombre del área de trabajo.

api-version
query True
  • string

Versión de API que se usará para la operación.

Respuestas

Name Type Description
200 OK

Correcto, operación completada correctamente

Other Status Codes

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Azure Active Directory Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

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

Definiciones

Bookmark

Representa un marcador en azure Security Ideas.

CloudError

Estructura de respuesta de error.

CloudErrorBody

Detalles del error.

createdByType

Tipo de identidad que creó el recurso.

IncidentInfo

Describe información relacionada sobre incidentes para el marcador.

IncidentSeverity

Gravedad del incidente

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

UserInfo

Información del usuario que realizó alguna acción

Bookmark

Representa un marcador en azure Security Ideas.

Name Type Description
etag
  • string

Etag del recurso de Azure

id
  • string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nombre del recurso.

properties.created
  • string

Hora en que se creó el marcador

properties.createdBy

Describe un usuario que creó el marcador.

properties.displayName
  • string

Nombre para mostrar del marcador

properties.eventTime
  • string

Hora del evento de marcador

properties.incidentInfo

Describe un incidente relacionado con el marcador.

properties.labels
  • string[]

Lista de etiquetas relevantes para este marcador

properties.notes
  • string

Notas del marcador

properties.query
  • string

Consulta del marcador.

properties.queryEndTime
  • string

Hora de finalización de la consulta

properties.queryResult
  • string

Resultado de la consulta del marcador.

properties.queryStartTime
  • string

Hora de inicio de la consulta

properties.updated
  • string

La última vez que se actualizó el marcador

properties.updatedBy

Describe un usuario que actualizó el marcador.

systemData

Los metadatos de Azure Resource Manager que contienen información de createdBy y modifiedBy.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft. Storage/storageAccounts"

CloudError

Estructura de respuesta de error.

Name Type Description
error

Datos de error

CloudErrorBody

Detalles del error.

Name Type Description
code
  • string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.

message
  • string

Mensaje que describe el error, diseñado para ser adecuado para su presentación en una interfaz de usuario.

createdByType

Tipo de identidad que creó el recurso.

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

IncidentInfo

Describe información relacionada sobre incidentes para el marcador.

Name Type Description
incidentId
  • string

Identificador de incidente

relationName
  • string

Nombre de relación

severity

Gravedad del incidente

title
  • string

Título del incidente

IncidentSeverity

Gravedad del incidente

Name Type Description
High
  • string

Gravedad alta

Informational
  • string

Gravedad informativa

Low
  • string

Low severity

Medium
  • string

Gravedad media

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.

UserInfo

Información del usuario que realizó alguna acción

Name Type Description
email
  • string

el correo electrónico del usuario.

name
  • string

Nombre del usuario.

objectId
  • string

Identificador de objeto del usuario.