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

安全性

OAuth2Auth

类型: oauth2
流向: implicit
授权 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

对象

错误对象。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
details	Azure.Core.Foundations.Error[]	导致此报告错误的特定错误的详细信息数组。
innererror	Azure.Core.Foundations.InnerError	包含与当前对象有关错误的更具体信息的对象。
message	string	错误的人工可读表示形式。
target	string	错误的目标。

Azure.Core.Foundations.ErrorResponse

对象

包含错误详细信息的响应。

名称	类型	说明
error	Azure.Core.Foundations.Error	错误对象。

Azure.Core.Foundations.InnerError

对象

包含有关错误的更具体信息的对象。 根据 Azure REST API 准则 - https://aka.ms/AzureRestApiGuidelines#handling-errors。

名称	类型	说明
code	string	服务器定义的错误代码集之一。
innererror	Azure.Core.Foundations.InnerError	内部错误。

DeltaDetailsRequest

对象

用于检索增量列表的请求正文。

名称	类型	说明
date	string	预期格式为：yyyy-MM-dd
deltaDetailType	DeltaDetailType	要检索的增量详细信息的类型。
kind	GlobalAssetType	资产的类型
priorDays	integer (int32)	检索其增量之前的天数。

DeltaDetailType

枚举

增量详细信息类型的列表

值	说明
added	添加
removed	删除

DeltaPageResult

对象

名称	类型	说明
nextLink	string	用于访问下一页结果的链接。 如果未在结果集末尾设置。
totalElements	integer (int64)	完整结果集中可用的项总数。
value	DeltaResult[]	结果的当前页中的项。

DeltaResult

对象

每个增量详细信息响应的结果

名称	类型	说明
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	自动确认