다음을 통해 공유


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 매개 변수

Name In(다음 안에) 필수 형식 Description
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

페이지당 최대 결과 항목 수입니다.

skip
query

integer

int32

건너뛸 결과 항목의 수입니다.

요청 본문

Name 필수 형식 Description
deltaDetailType True

DeltaDetailType

검색할 델타 세부 정보의 형식입니다.

kind True

GlobalAssetType

자산 유형

date

string

예상 형식: yyyy-MM-dd

priorDays

integer

델타를 검색하기 전의 일 수입니다.

응답

Name 형식 Description
200 OK

DeltaPageResult

요청이 성공했습니다.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

예기치 않은 오류 응답입니다.

헤더

x-ms-error-code: string

보안

OAuth2Auth

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
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"
    }
  ]
}

정의

Name Description
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 개체.

Name 형식 Description
code

string

서버 정의 오류 코드 집합 중 하나입니다.

details

Azure.Core.Foundations.Error[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.

innererror

Azure.Core.Foundations.InnerError

오류에 대한 현재 개체보다 더 구체적인 정보를 포함하는 개체입니다.

message

string

사람이 읽을 수 있는 오류 표현입니다.

target

string

오류의 대상입니다.

Azure.Core.Foundations.ErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name 형식 Description
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.

Name 형식 Description
code

string

서버 정의 오류 코드 집합 중 하나입니다.

innererror

Azure.Core.Foundations.InnerError

내부 오류입니다.

DeltaDetailsRequest

델타 목록을 검색하는 데 사용되는 요청 본문입니다.

Name 형식 Description
date

string

예상 형식: yyyy-MM-dd

deltaDetailType

DeltaDetailType

검색할 델타 세부 정보의 형식입니다.

kind

GlobalAssetType

자산 유형

priorDays

integer

델타를 검색하기 전의 일 수입니다.

DeltaDetailType

델타 세부 정보 유형 목록

Name 형식 Description
added

string

added

removed

string

제거

DeltaPageResult

Name 형식 Description
nextLink

string

결과의 다음 페이지에 액세스할 수 있는 링크입니다. 결과 집합의 끝에 있는 경우 설정되지 않습니다.

totalElements

integer

전체 결과 집합에서 사용할 수 있는 총 항목 수입니다.

value

DeltaResult[]

결과의 현재 페이지에 있는 항목입니다.

DeltaResult

각 델타 세부 정보 응답에 대한 결과

Name 형식 Description
createdAt

string

자산이 원래 만들어진 날짜를 표시합니다.

kind

GlobalAssetType

자산 종류 표시

name

string

자산 이름을 표시합니다.

state

GlobalInventoryState

인벤토리 상태 표시

updatedAt

string

자산이 마지막으로 업데이트된 날짜(일반적으로 결과를 끌어오려는 날짜)를 표시합니다.

GlobalAssetType

글로벌 자산 유형 목록

Name 형식 Description
as

string

자치 시스템 번호

contact

string

contact

domain

string

도메인

host

string

호스트

ipAddress

string

ip 주소

ipBlock

string

ip 블록

mailServer

string

메일 서버

nameServer

string

이름 서버

page

string

페이지

resource

string

resource

sslCert

string

ssl 인증서

GlobalInventoryState

전역 인벤토리 상태 목록입니다.

Name 형식 Description
archived

string

보관

associated

string

연결

associatedPartner

string

연결된 파트너

associatedThirdParty

string

연결된 타사

autoconfirmed

string

자동 확인됨

candidate

string

후보

candidateInvestigate

string

후보 조사

confirmed

string

confirmed

dismissed

string

해산