Dosyayla ilgili makineler API'lerini alma

API açıklaması

Belirli bir dosya karması ile ilgili makine koleksiyonunu 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.
• Yalnızca SHA-1 Karma İşlevi desteklenir (MD5 veya SHA-256 desteklenmez).

İ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.
• Yanıt, cihaz grubu ayarlarına bağlı olarak yalnızca kullanıcının erişimi olan cihazları içerir. Daha fazla bilgi için bkz. Cihaz gruplarını 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 edinmek için bkz. Uç Nokta için Microsoft Defender API'leri kullanma

İzin türü	İzin	İzin görünen adı
Uygulama	Machine.ReadWrite.All	'Tüm makine bilgilerini okuma ve yazma'
Temsilci (iş veya okul hesabı)	Machine.ReadWrite	'Makine bilgilerini okuma ve yazma'

HTTP isteği

GET /api/files/{id}/machines

İ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 makine varlıklarının listesiyle 200 Tamam. Dosya yoksa - Boş bir kümeyle 200 Tamam.

Örnek

İstek

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

GET https://api.security.microsoft.com/api/files/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/machines