Dosya bilgileri API'si alma

API açıklaması

Sha1 veya Sha256 tanımlayıcısı ile dosya alır

Sınırlamalar

Bu API için hız sınırlamaları dakikada 100 çağrı ve saatte 1500 çağrıdır.

İzinler

Kullanıcı kimlik bilgilerini kullanarak belirteç alırken:

• Kullanıcının en az şu rol iznine sahip olması gerekir: 'Verileri Görüntüle'. Daha fazla bilgi için bkz. Rolleri oluşturma ve yönetme.

Bu API'yi çağırmak için aşağıdaki izinlerden biri gereklidir. İzinlerin nasıl seçileceği de dahil olmak üzere daha fazla bilgi için bkz. Uç Nokta için Microsoft Defender API'leri kullanma.

İzin türü	İzin	İzin görünen adı
Uygulama	File.Read.All	'Tüm dosya profillerini oku'
Temsilci (iş veya okul hesabı)	File.Read.All	'Tüm dosya profillerini oku'

HTTP isteği

GET /api/files/{id}

İstek üst bilgileri

Name	Tür	Açıklama
İzin	Dize	Taşıyıcı {token}. Gerekli.

İstek gövdesi

Boş

Yanıt

Başarılı ve dosya varsa - gövdedeki dosya varlığıyla 200 Tamam. Dosya yoksa - 404 Bulunamadı.

Örnek

İstek örneği

burada isteğin bir örneği verilmiş.

GET https://api.security.microsoft.com/api/files/4388963aaa83afe2042a46a3c017ad50bdcdafb3

Yanıt örneği

Yanıtın bir örneğini aşağıda bulabilirsiniz.

{
    "@odata.context": "https://api.security.microsoft.com/api/$metadata#Files/$entity",
    "sha1": "4388963aaa83afe2042a46a3c017ad50bdcdafb3",
    "sha256": "413c58c8267d2c8648d8f6384bacc2ae9c929b2b96578b6860b5087cd1bd6462",
    "globalPrevalence": 180022,
    "globalFirstObserved": "2017-09-19T03:51:27.6785431Z",
    "globalLastObserved": "2020-01-06T03:59:21.3229314Z",
    "size": 22139496,
    "fileType": "APP",
    "isPeFile": true,
    "filePublisher": "CHENGDU YIWO Tech Development Co., Ltd.",
    "fileProductName": "EaseUS MobiSaver for Android",
    "signer": "CHENGDU YIWO Tech Development Co., Ltd.",
    "issuer": "VeriSign Class 3 Code Signing 2010 CA",
    "signerHash": "6c3245d4a9bc0244d99dff27af259cbbae2e2d16",
    "isValidCertificate": false,
    "determinationType": "Pua",
    "determinationValue": "PUA:Win32/FusionCore"
}