Kode kesalahan REST API Microsoft Defender XDR umum

  • Berlaku untuk: Microsoft Defender XDR

Note

Coba API baru kami menggunakan API keamanan MS Graph. Cari tahu lebih lanjut di: Menggunakan API keamanan Microsoft Graph - Microsoft Graph | Microsoft Learn.

Penting

Beberapa informasi berkaitan dengan produk yang telah dirilis sebelumnya yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersurat maupun tersirat, sehubungan dengan informasi yang diberikan di sini.

Kode kesalahan dapat dikembalikan oleh operasi pada salah satu API Microsoft Defender. Setiap respons kesalahan berisi pesan kesalahan, yang dapat membantu mengatasi masalah. Kolom pesan kesalahan di bagian tabel menyediakan beberapa contoh pesan. Konten pesan aktual bervariasi berdasarkan faktor-faktor yang memicu respons. Konten variabel ditunjukkan oleh tanda kurung sudut (< >) dalam tabel berikut:

Kode kesalahan

Kode kesalahan Kode Status HTTP Message
BadRequest BadRequest (400) Pesan kesalahan Permintaan Buruk Umum.
ODataError BadRequest (400) Kueri <URI OData tidak valid, kesalahan spesifik ditentukan>.
MasukanTidakValid BadRequest (400) Input input <tidak valid>.
InvalidRequestBody BadRequest (400) Isi permintaan tidak valid.
InvalidHashValue BadRequest (400) Nilai <hash hash> yang tidak valid tidak valid.
InvalidDomainName BadRequest (400) Nama domain <domain yang tidak> valid tidak valid.
InvalidIpAddress BadRequest (400) Alamat <IP IP yang tidak> valid tidak valid.
InvalidUrl BadRequest (400) URL <URL> yang tidak valid tidak valid.
MaximumBatchSizeExceeded BadRequest (400) Ukuran batch maksimum terlampaui. Diterima: <ukuran batch diterima>, diizinkan: {ukuran batch diizinkan}.
MissingRequiredParameter BadRequest (400) Parameter <parameter> yang hilang hilang.
OsPlatformNotSupported BadRequest (400) Platform OS platform <> OS klien tidak didukung untuk tindakan ini.
ClientVersionNotSupported BadRequest (400) <Tindakan> yang diminta didukung pada versi klien yang <didukung versi klien dan yang> lebih baru.
Tidak diizinkan Tidak diizinkan (401) Sah

Kesalahan ini biasanya disebabkan oleh header otorisasi yang tidak valid atau kedaluwarsa.
Dilarang Terlarang (403) Terlarang

Kesalahan ini dapat terjadi dengan token yang valid tetapi tidak cukup izin untuk tindakan tersebut.
DisabledFeature Terlarang (403) Fitur penyewa tidak diaktifkan.
DisallowedOperation Terlarang (403) <operasi yang tidak diizinkan dan alasannya>.
Tidak Ditemukan Tidak Ditemukan(404) Pesan kesalahan Umum Tidak Ditemukan.
SumberTidakDitemukan Tidak Ditemukan(404) Sumber daya <sumber daya> yang diminta tidak ditemukan.
InternalServerError Kesalahan Server Internal (500) Jika tidak ada pesan kesalahan, coba lagi operasi. Hubungi Microsoft jika tidak diselesaikan.

Examples

{
    "error": {
        "code": "ResourceNotFound",
        "message": "Machine 123123123 was not found",
        "target": "43f4cb08-8fac-4b65-9db1-745c2ae65f3a"
    }
}

{
    "error": {
        "code": "InvalidRequestBody",
        "message": "Request body is incorrect",
        "target": "1fa66c0f-18bd-4133-b378-36d76f3a2ba0"
    }
}

Parameter isi

Penting

Parameter isi peka huruf besar/kecil.

Jika Anda mengalami kesalahan InvalidRequestBody atau MissingRequiredParameter , itu mungkin disebabkan oleh kesalahan ketik. Tinjau dokumentasi API dan periksa apakah parameter yang dikirimkan cocok dengan contoh yang relevan.

ID Pelacakan

Setiap respons kesalahan berisi parameter ID unik untuk pelacakan. Nama properti parameter ini adalah target. Jika Anda menghubungi Microsoft tentang kesalahan, melampirkan ID pelacakan Anda membantu Microsoft menemukan akar penyebab masalah.

Tip

Apakah Anda ingin mempelajari lebih lanjut? Terlibatlah dengan komunitas Microsoft Security di Komunitas Teknologi kami: Microsoft Defender XDR Tech Community.

  • Last updated on