Bookmarks - Get

ブックマークを取得します。

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 パラメーター

Name In Required Type Description
bookmarkId
path True
  • string

[ブックマーク ID]

resourceGroupName
path True
  • string

リソース グループの名前。 名前の大文字と小文字は区別されます。

subscriptionId
path True
  • string

ターゲット サブスクリプションの ID。

workspaceName
path True
  • string

ワークスペースの名前。

api-version
query True
  • string

この操作に使用する API バージョン。

応答

Name Type Description
200 OK

OK、操作が正常に完了しました

Other Status Codes

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

OAuth2 FlowをAzure Active Directoryする

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

Scopes

Name Description
user_impersonation ユーザー アカウントを偽装する

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

定義

Bookmark

Azure Security インサイトのブックマークを表します。

CloudError

エラー応答構造。

CloudErrorBody

エラーの詳細。

createdByType

リソースを作成した ID の種類。

IncidentInfo

ブックマークの関連インシデント情報について説明します

IncidentSeverity

インシデントの重大度

systemData

リソースの作成と最後の変更に関連するメタデータ。

UserInfo

何らかのアクションを行ったユーザー情報

Bookmark

Azure Security インサイトのブックマークを表します。

Name Type Description
etag
  • string

Azure リソースの Etag

id
  • string

リソースの完全修飾リソース ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

リソースの名前

properties.created
  • string

ブックマークが作成された時刻

properties.createdBy

ブックマークを作成したユーザーについて説明します

properties.displayName
  • string

ブックマークの表示名

properties.eventTime
  • string

ブックマーク イベントの時刻

properties.incidentInfo

ブックマークに関連するインシデントについて説明します

properties.labels
  • string[]

このブックマークに関連するラベルの一覧

properties.notes
  • string

ブックマークのメモ

properties.query
  • string

ブックマークのクエリ。

properties.queryEndTime
  • string

クエリの終了時刻

properties.queryResult
  • string

ブックマークのクエリ結果。

properties.queryStartTime
  • string

クエリの開始時刻

properties.updated
  • string

ブックマークが最後に更新された時刻

properties.updatedBy

ブックマークを更新したユーザーについて説明します

systemData

createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。

type
  • string

リソースの型。 たとえば、"Microsoft.Compute/virtualMachines" や "Microsoft" などです。Storage/storageAccounts"

CloudError

エラー応答構造。

Name Type Description
error

エラー データ

CloudErrorBody

エラーの詳細。

Name Type Description
code
  • string

エラーの識別子。 コードは不変であり、プログラムによって使用されることを意図しています。

message
  • string

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

createdByType

リソースを作成した ID の種類。

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

IncidentInfo

ブックマークの関連インシデント情報について説明します

Name Type Description
incidentId
  • string

インシデント ID

relationName
  • string

リレーションシップ名

severity

インシデントの重大度

title
  • string

インシデントのタイトル

IncidentSeverity

インシデントの重大度

Name Type Description
High
  • string

重要度レベル****

Informational
  • string

情報の重大度

Low
  • string

重大度: 低

Medium
  • string

重要度レベル****

systemData

リソースの作成と最後の変更に関連するメタデータ。

Name Type Description
createdAt
  • string

リソース作成のタイムスタンプ (UTC)。

createdBy
  • string

リソースを作成した ID。

createdByType

リソースを作成した ID の種類。

lastModifiedAt
  • string

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy
  • string

リソースを最後に変更した ID。

lastModifiedByType

リソースを最後に変更した ID の種類。

UserInfo

何らかのアクションを行ったユーザー情報

Name Type Description
email
  • string

ユーザーの電子メール。

name
  • string

ユーザーの名前です。

objectId
  • string

ユーザーのオブジェクト ID。