Assets - Get Delta Details

Layanan:

Defender EASM (preview)

Versi API:

2024-10-01-preview

Ambil daftar delta untuk rentang waktu yang disediakan.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string (uri)	Titik akhir yang menghosting sumber daya yang diminta. Misalnya, https://{region}.easm.defender.microsoft.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/workspaces/{workspaceName}
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.
maxpagesize	query		integer (int32)	Jumlah maksimum item hasil per halaman.
skip	query		integer (int32)	Jumlah item hasil yang akan dilewati.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
deltaDetailType	True	DeltaDetailType	Jenis detail delta yang akan diambil.
kind	True	GlobalAssetType	Jenis aset
date		string	format yang diharapkan menjadi: yyyy-MM-dd
priorDays		integer (int32)	Jumlah hari sebelum mengambil delta.

Respons

Nama	Jenis	Deskripsi
200 OK	DeltaPageResult	Permintaan telah berhasil.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Respons kesalahan tak terduga. Header x-ms-error-code: string

Keamanan

OAuth2Auth

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
https://easm.defender.microsoft.com/.default

Contoh

Assets_GetDeltaDetails

Permintaan sampel

HTTP

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

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

Respon sampel

Kode status:

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

Definisi

Nama	Deskripsi
Azure.Core.Foundations.Error	Objek kesalahan.
Azure.Core.Foundations.ErrorResponse	Respons yang berisi detail kesalahan.
Azure.Core.Foundations.InnerError	Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai pedoman Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.
DeltaDetailsRequest	Isi permintaan yang digunakan untuk mengambil daftar delta.
DeltaDetailType	Daftar jenis detail delta
DeltaPageResult
DeltaResult	Hasil untuk setiap respons detail delta
GlobalAssetType	Daftar jenis aset global
GlobalInventoryState	Daftar status inventaris global.

Azure.Core.Foundations.Error

Objek

Objek kesalahan.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
details	Azure.Core.Foundations.Error[]	Array detail tentang kesalahan tertentu yang menyebabkan kesalahan yang dilaporkan ini.
innererror	Azure.Core.Foundations.InnerError	Objek yang berisi informasi yang lebih spesifik daripada objek saat ini tentang kesalahan.
message	string	Representasi kesalahan yang dapat dibaca manusia.
target	string	Target kesalahan.

Azure.Core.Foundations.ErrorResponse

Objek

Respons yang berisi detail kesalahan.

Nama	Jenis	Deskripsi
error	Azure.Core.Foundations.Error	Objek kesalahan.

Azure.Core.Foundations.InnerError

Objek

Objek yang berisi informasi yang lebih spesifik tentang kesalahan. Sesuai pedoman Azure REST API - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nama	Jenis	Deskripsi
code	string	Salah satu sekumpulan kode kesalahan yang ditentukan server.
innererror	Azure.Core.Foundations.InnerError	Kesalahan dalam.

DeltaDetailsRequest

Objek

Isi permintaan yang digunakan untuk mengambil daftar delta.

Nama	Jenis	Deskripsi
date	string	format yang diharapkan menjadi: yyyy-MM-dd
deltaDetailType	DeltaDetailType	Jenis detail delta yang akan diambil.
kind	GlobalAssetType	Jenis aset
priorDays	integer (int32)	Jumlah hari sebelum mengambil delta.

DeltaDetailType

Enumerasi

Daftar jenis detail delta

Nilai	Deskripsi
added	Ditambahkan
removed	Dihapus

DeltaPageResult

Objek

Nama	Jenis	Deskripsi
nextLink	string	Tautan untuk mengakses halaman hasil berikutnya. Tidak diatur jika di akhir tataan hasil.
totalElements	integer (int64)	Jumlah total item yang tersedia dalam tataan hasil lengkap.
value	DeltaResult[]	Item di halaman hasil saat ini.

DeltaResult

Objek

Hasil untuk setiap respons detail delta

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Memperlihatkan tanggal saat aset awalnya dibuat
kind	GlobalAssetType	Menampilkan jenis aset
name	string	Memperlihatkan nama aset
state	GlobalInventoryState	Menampilkan status inventarisi
updatedAt	string (date-time)	Menunjukkan tanggal kapan aset terakhir diperbarui, biasanya tanggal kami mencoba untuk menarik hasilnya

GlobalAssetType

Enumerasi

Daftar jenis aset global

Nilai	Deskripsi
page	halaman
resource	Sumber daya
mailServer	server email
nameServer	server nama
host	host
domain	domain
ipAddress	alamat ip
ipBlock	blok ip
as	nomor sistem otonom
contact	kontak
sslCert	sertifikat ssl

GlobalInventoryState

Enumerasi

Daftar status inventaris global.

Nilai	Deskripsi
candidate	calon
candidateInvestigate	kandidat menyelidiki
confirmed	Dikonfirmasi
associated	Terkait
associatedPartner	mitra terkait
associatedThirdParty	pihak ketiga terkait
archived	Diarsipkan
dismissed	Diberhentikan
autoconfirmed	dikonfirmasi secara otomatis