Aracılığıyla paylaş


Assets - Get Delta Details

Sağlanan zaman aralığı için delta listesini alın.

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 Parametreleri

Name İçinde Gerekli Tür Description
endpoint
path True

string

İstenen kaynağı barındıran uç nokta. Örneğin, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}

api-version
query True

string

Bu işlem için kullanılacak API sürümü.

maxpagesize
query

integer

int32

Sayfa başına en fazla sonuç öğesi sayısı.

skip
query

integer

int32

Atlana sonuç öğelerinin sayısı.

İstek Gövdesi

Name Gerekli Tür Description
deltaDetailType True

DeltaDetailType

Alınacak delta ayrıntısının türü.

kind True

GlobalAssetType

Varlığın türü

date

string

beklenen biçim: yyyy-AA-gg

priorDays

integer

için delta değerlerinin alınmasından önceki gün sayısı.

Yanıtlar

Name Tür Description
200 OK

DeltaPageResult

İstek başarılı oldu.

Other Status Codes

Azure.Core.Foundations.ErrorResponse

Beklenmeyen bir hata yanıtı.

Üst Bilgiler

x-ms-error-code: string

Güvenlik

OAuth2Auth

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
https://easm.defender.microsoft.com/.default

Örnekler

Assets_GetDeltaDetails

Örnek isteği

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

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

Örnek yanıt

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

Tanımlar

Name Description
Azure.Core.Foundations.Error

Hata nesnesi.

Azure.Core.Foundations.ErrorResponse

Hata ayrıntılarını içeren bir yanıt.

Azure.Core.Foundations.InnerError

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Microsoft One API yönergelerine göre - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

DeltaDetailsRequest

Delta listesini almak için kullanılan istek gövdesi.

DeltaDetailType

Delta ayrıntı türü listesi

DeltaPageResult
DeltaResult

Delta ayrıntı yanıtının her biri için sonuç

GlobalAssetType

Genel varlık türünün listesi

GlobalInventoryState

Genel envanter durumlarının listesi.

Azure.Core.Foundations.Error

Hata nesnesi.

Name Tür Description
code

string

Sunucu tanımlı hata kodları kümesinden biri.

details

Azure.Core.Foundations.Error[]

Bu bildirilen hataya yol açan belirli hatalarla ilgili ayrıntılar dizisi.

innererror

Azure.Core.Foundations.InnerError

Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.

message

string

Hatanın insan tarafından okunabilen bir gösterimi.

target

string

Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Hata ayrıntılarını içeren bir yanıt.

Name Tür Description
error

Azure.Core.Foundations.Error

Hata nesnesi.

Azure.Core.Foundations.InnerError

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Microsoft One API yönergelerine göre - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Name Tür Description
code

string

Sunucu tanımlı hata kodları kümesinden biri.

innererror

Azure.Core.Foundations.InnerError

İç hata.

DeltaDetailsRequest

Delta listesini almak için kullanılan istek gövdesi.

Name Tür Description
date

string

beklenen biçim: yyyy-AA-gg

deltaDetailType

DeltaDetailType

Alınacak delta ayrıntısının türü.

kind

GlobalAssetType

Varlığın türü

priorDays

integer

için delta değerlerinin alınmasından önceki gün sayısı.

DeltaDetailType

Delta ayrıntı türü listesi

Name Tür Description
added

string

eklendi

removed

string

Kaldırıldı

DeltaPageResult

Name Tür Description
nextLink

string

Sonuçların sonraki sayfasına erişme bağlantısı. Sonuç kümesinin sonundaysa ayarlanmaz.

totalElements

integer

Tam sonuç kümesinde kullanılabilen toplam öğe sayısı.

value

DeltaResult[]

Geçerli sonuç sayfasındaki öğeler.

DeltaResult

Delta ayrıntı yanıtının her biri için sonuç

Name Tür Description
createdAt

string

Varlığın ilk oluşturulduğu tarihi gösterir

kind

GlobalAssetType

Varlık türünü gösterir

name

string

Varlık adını gösterir

state

GlobalInventoryState

Stok durumunu gösterir

updatedAt

string

Varlığın en son güncelleştirildiği tarihi, genellikle sonuçları almaya çalıştığımız tarihi gösterir

GlobalAssetType

Genel varlık türünün listesi

Name Tür Description
as

string

otonom sistem numarası

contact

string

kişi

domain

string

etki alanı

host

string

konak

ipAddress

string

ip adresi

ipBlock

string

ip bloğu

mailServer

string

posta sunucusu

nameServer

string

ad sunucusu

page

string

sayfa

resource

string

kaynak

sslCert

string

ssl sertifikası

GlobalInventoryState

Genel envanter durumlarının listesi.

Name Tür Description
archived

string

Arşivlenmiş

associated

string

Ilişkili

associatedPartner

string

ilişkili iş ortağı

associatedThirdParty

string

ilişkili üçüncü taraf

autoconfirmed

string

otomatik olarak onaylandı

candidate

string

aday

candidateInvestigate

string

aday araştırma

confirmed

string

Doğruladı

dismissed

string

kapatıldı