Assets - Get Delta Details

サービス:: Defender EASM (preview)

API バージョン:: 2024-10-01-preview

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

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

省略可能なパラメーターを含む:

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

URI パラメーター

名前	/	必須	型	説明
endpoint	path	True	string (uri)	要求されたリソースをホストしているエンドポイント。たとえば、https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。
maxpagesize	query		integer (int32)	ページあたりの結果項目の最大数。
skip	query		integer (int32)	スキップする結果項目の数。

要求本文

名前	必須	型	説明
deltaDetailType	True	DeltaDetailType	取得するデルタ詳細の種類。
kind	True	GlobalAssetType	資産の種類
date		string	想定される形式: yyyy-MM-dd
priorDays		integer (int32)	差分を取得する前の日数。

応答

名前	型	説明
200 OK	DeltaPageResult	要求は成功しました。
Other Status Codes	Azure.Core.Foundations.ErrorResponse	予期しないエラー応答。ヘッダー x-ms-error-code: string

名前

型

説明

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

要求のサンプル

HTTP

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

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

応答のサンプル

状態コード:: 200

{
  "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	エラーオブジェクト。
Azure.Core.Foundations.ErrorResponse	エラーの詳細を含む応答。
Azure.Core.Foundations.InnerError	エラーに関するより具体的な情報を含むオブジェクト。 Azure REST API ガイドライン - https://aka.ms/AzureRestApiGuidelines#handling-errorsに準拠。
DeltaDetailsRequest	デルタの一覧を取得するために使用される要求本文。
DeltaDetailType	デルタ詳細の種類の一覧
DeltaPageResult
DeltaResult	各デルタ詳細応答の結果
GlobalAssetType	グローバル資産の種類の一覧
GlobalInventoryState	グローバルインベントリの状態の一覧。

Azure.Core.Foundations.Error

Object

エラーオブジェクト。

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
details	Azure.Core.Foundations.Error[]	この報告されたエラーの原因となった特定のエラーに関する詳細の配列。
innererror	Azure.Core.Foundations.InnerError	エラーに関する現在のオブジェクトよりも具体的な情報を含むオブジェクト。
message	string	エラーの人間が判読できる表現。
target	string	エラーのターゲット。

Azure.Core.Foundations.ErrorResponse

Object

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

名前	型	説明
error	Azure.Core.Foundations.Error	エラーオブジェクト。

Azure.Core.Foundations.InnerError

Object

エラーに関するより具体的な情報を含むオブジェクト。 Azure REST API ガイドライン - https://aka.ms/AzureRestApiGuidelines#handling-errorsに準拠。

名前	型	説明
code	string	サーバー定義の一連のエラーコードの 1 つ。
innererror	Azure.Core.Foundations.InnerError	内部エラー。

DeltaDetailsRequest

Object

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

名前	型	説明
date	string	想定される形式: yyyy-MM-dd
deltaDetailType	DeltaDetailType	取得するデルタ詳細の種類。
kind	GlobalAssetType	資産の種類
priorDays	integer (int32)	差分を取得する前の日数。

DeltaDetailType

列挙

デルタ詳細の種類の一覧

値	説明
added	追加
removed	削除

DeltaPageResult

Object

名前	型	説明
nextLink	string	結果の次のページにアクセスするためのリンク。結果セットの末尾にある場合は設定されません。
totalElements	integer (int64)	結果セット全体で使用できるアイテムの合計数。
value	DeltaResult[]	結果の現在のページ内の項目。

DeltaResult

Object

各デルタ詳細応答の結果

名前	型	説明
createdAt	string (date-time)	資産が最初に作成された日付を表示します
kind	GlobalAssetType	資産の種類を表示します
name	string	資産名を表示します
state	GlobalInventoryState	インベントリの状態を表示します
updatedAt	string (date-time)	資産が最後に更新された日付 (通常は結果を取得しようとしている日付) を表示します。

GlobalAssetType

列挙

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

値	説明
page	ページ
resource	リソース
mailServer	メールサーバー
nameServer	ネームサーバー
host	ホスティング
domain	ドメイン
ipAddress	IPアドレス
ipBlock	ip ブロック
as	自律システム番号
contact	接触
sslCert	ssl 証明書

GlobalInventoryState

列挙

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

値	説明
candidate	候補者
candidateInvestigate	候補の調査
confirmed	確認
associated	関連付けられた
associatedPartner	関連付けられているパートナー
associatedThirdParty	関連するサードパーティ
archived	アーカイブ
dismissed	却下
autoconfirmed	自動確認済み