Assets - Get Delta Details

Hizmet:

Defender EASM (preview)

API Sürümü:

2024-10-01-preview

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

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
endpoint	path	True	string (uri)	İ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 minLength: 1	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 (int32)	için değişiklik alınmadan ö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

HTTP

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

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

Örnek yanıt

Durum kodu:

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

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. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Değişiklik listesini almak için kullanılan istek gövdesi.
DeltaDetailType	Delta ayrıntı türünün 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

Nesne

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 hatalar hakkında bir dizi ayrıntı.
innererror	Azure.Core.Foundations.InnerError	Hatayla ilgili geçerli nesneden daha belirli bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilir bir gösterimi.
target	string	Hatanın hedefi.

Azure.Core.Foundations.ErrorResponse

Nesne

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

Nesne

Hata hakkında daha ayrıntılı bilgi içeren bir nesne. Azure REST API yönergelerine göre - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Name	Tür	Description
code	string	Sunucu tanımlı hata kodları kümesinden biri.
innererror	Azure.Core.Foundations.InnerError	İç hata.

DeltaDetailsRequest

Nesne

Değişiklik 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 (int32)	için değişiklik alınmadan önceki gün sayısı.

DeltaDetailType

Numaralandırma

Delta ayrıntı türünün listesi

Değer	Description
added	eklendi
removed	Kaldırıldı

DeltaPageResult

Nesne

Name	Tür	Description
nextLink	string	Sonuçların sonraki sayfasına erişme bağlantısı. Sonuç kümesinin sonundaysa ayarlanmaz.
totalElements	integer (int64)	Tam sonuç kümesinde kullanılabilen toplam öğe sayısı.
value	DeltaResult[]	Geçerli sonuç sayfasındaki öğeler.

DeltaResult

Nesne

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

Name	Tür	Description
createdAt	string (date-time)	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 (date-time)	Varlığın en son güncelleştirildiği tarihi, genellikle sonuçları almaya çalıştığımız tarihi gösterir

GlobalAssetType

Numaralandırma

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

Değer	Description
page	sayfa
resource	kaynak
mailServer	posta sunucusu
nameServer	ad sunucusu
host	ev sahibi
domain	alan
ipAddress	ip adresi
ipBlock	ip bloğu
as	otonom sistem numarası
contact	temas
sslCert	ssl sertifikası

GlobalInventoryState

Numaralandırma

Genel envanter durumlarının listesi.

Değer	Description
candidate	aday
candidateInvestigate	aday araştırması
confirmed	Doğruladı
associated	Ilişkili
associatedPartner	ilişkili iş ortağı
associatedThirdParty	ilişkili üçüncü taraf
archived	Arşivlenmiş
dismissed	kapatıldı
autoconfirmed	otomatik olarak onaylandı