次の方法で共有


Assets - Get Delta Details

指定された時間範囲のデルタの一覧を取得します。

POST {endpoint}/assets:getDeltaDetails?api-version=2024-03-01-preview
POST {endpoint}/assets:getDeltaDetails?api-version=2024-03-01-preview&skip={skip}&maxpagesize={maxpagesize}

URI パラメーター

名前 / 必須 説明
endpoint
path True

string

要求されたリソースをホストしているエンドポイント。 たとえば、https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

api-version
query True

string

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

maxpagesize
query

integer

int32

1 ページあたりの結果アイテムの最大数。

skip
query

integer

int32

スキップする結果項目の数。

要求本文

名前 必須 説明
deltaDetailType True

DeltaDetailType

取得するデルタ詳細の種類。

kind True

GlobalAssetType

資産の種類

date

string

想定される形式: yyyy-MM-dd

priorDays

integer

デルタを取得する前の日数。

応答

名前 説明
200 OK

DeltaPageResult

要求は成功しました。

Other Status Codes

Azure.Core.Foundations.ErrorResponse

予期しないエラー応答。

ヘッダー

x-ms-error-code: string

セキュリティ

OAuth2Auth

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
https://easm.defender.microsoft.com/.default

Assets_GetDeltaDetails

要求のサンプル

POST {endpoint}/assets:getDeltaDetails?api-version=2024-03-01-preview

{
  "deltaDetailType": "added",
  "priorDays": 30,
  "kind": "domain",
  "date": "2024-03-17"
}

応答のサンプル

{
  "totalElements": 3,
  "value": [
    {
      "kind": "domain",
      "name": "hondawallofdreams.ca",
      "createdAt": "2024-02-23T18:33:06Z",
      "updatedAt": "2024-02-23T18:33:06Z",
      "state": "confirmed"
    },
    {
      "kind": "domain",
      "name": "hondawallofdreamsfr.ca",
      "createdAt": "2024-02-16T16:14:40Z",
      "updatedAt": "2024-02-16T16:14:40Z",
      "state": "confirmed"
    },
    {
      "kind": "domain",
      "name": "parkerhonda.com",
      "createdAt": "2024-03-02T07:29:01Z",
      "updatedAt": "2024-03-09T09:19:23Z",
      "state": "confirmed"
    }
  ]
}

定義

名前 説明
Azure.Core.Foundations.Error

error オブジェクト。

Azure.Core.Foundations.ErrorResponse

エラーの詳細を含む応答。

Azure.Core.Foundations.InnerError

エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses

DeltaDetailsRequest

デルタの一覧を取得するために使用される要求本文。

DeltaDetailType

デルタ詳細の種類の一覧

DeltaPageResult
DeltaResult

各デルタ詳細応答の結果

GlobalAssetType

グローバル資産の種類の一覧

GlobalInventoryState

グローバル インベントリの状態の一覧。

Azure.Core.Foundations.Error

error オブジェクト。

名前 説明
code

string

サーバー定義のエラー コードのセットの 1 つ。

details

Azure.Core.Foundations.Error[]

この報告されたエラーの原因となった特定のエラーに関する詳細の配列。

innererror

Azure.Core.Foundations.InnerError

エラーに関する現在のオブジェクトよりも具体的な情報を含む オブジェクト。

message

string

エラーの人間が判読できる表現。

target

string

エラーのターゲット。

Azure.Core.Foundations.ErrorResponse

エラーの詳細を含む応答。

名前 説明
error

Azure.Core.Foundations.Error

error オブジェクト。

Azure.Core.Foundations.InnerError

エラーに関するより具体的な情報を含むオブジェクト。 Microsoft One API のガイドラインに従って - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses

名前 説明
code

string

サーバー定義のエラー コードのセットの 1 つ。

innererror

Azure.Core.Foundations.InnerError

内部エラー。

DeltaDetailsRequest

デルタの一覧を取得するために使用される要求本文。

名前 説明
date

string

想定される形式: yyyy-MM-dd

deltaDetailType

DeltaDetailType

取得するデルタ詳細の種類。

kind

GlobalAssetType

資産の種類

priorDays

integer

デルタを取得する前の日数。

DeltaDetailType

デルタ詳細の種類の一覧

名前 説明
added

string

追加

removed

string

削除

DeltaPageResult

名前 説明
nextLink

string

結果の次のページにアクセスするためのリンク。 結果セットの末尾にある場合は設定されません。

totalElements

integer

完全な結果セットで使用できるアイテムの合計数。

value

DeltaResult[]

結果の現在のページ内の項目。

DeltaResult

各デルタ詳細応答の結果

名前 説明
createdAt

string

資産が最初に作成された日付を表示します

kind

GlobalAssetType

資産の種類を表示します

name

string

資産名を表示します

state

GlobalInventoryState

インベントリの状態を表示します

updatedAt

string

資産が最後に更新された日付 (通常は結果を取得しようとしている日付) を表示します

GlobalAssetType

グローバル資産の種類の一覧

名前 説明
as

string

自律システム番号

contact

string

contact

domain

string

domain

host

string

host

ipAddress

string

IP アドレス

ipBlock

string

ip ブロック

mailServer

string

メール サーバー

nameServer

string

ネーム サーバー

page

string

ページ (page)

resource

string

resource

sslCert

string

ssl 証明書

GlobalInventoryState

グローバル インベントリの状態の一覧。

名前 説明
archived

string

アーカイブされました

associated

string

関連付け られた

associatedPartner

string

関連パートナー

associatedThirdParty

string

関連するサード パーティ

autoconfirmed

string

自動確認済み

candidate

string

候補

candidateInvestigate

string

受験者の調査

confirmed

string

confirmed

dismissed

string

却下