Tarama aracısı kimliğini alma

Önemli

Bu makaledeki bazı bilgiler önceden yayımlanmış bir ürünle ilgilidir ve ticari olarak piyasaya sürülmeden önce önemli ölçüde değiştirilmiş olabilir. Microsoft, burada sağlanan bilgilerle ilgili olarak açık veya zımni hiçbir garanti vermez.

API açıklaması

Belirtilen aracının ayrıntılarını kimliğine göre alır.

Sınırlamalar

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

İzinler

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

• Verileri görüntülemek için kullanıcının en az aşağıdaki rol iznine sahip olması gerekir: ViewData veya TvmViewData. 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	Machine.Read.All	Tüm tarama bilgilerini okuyun.
Temsilci (iş veya okul hesabı)	Machine.Read.All	Tüm tarama bilgilerini okuyun.

HTTP isteği

GET /api/DeviceAuthenticatedScanAgents

İstek üst bilgileri

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

İstek gövdesi

Boş

Yanıt

Başarılı olursa, bu yöntem belirtilen aracının ayrıntılarını içeren 200 - Tamam yanıt kodunu döndürür.

Örnek istek

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

GET https://api.security.microsoft.com/api/DeviceAuthenticatedScanAgents/7f3d76a6976818553e996875dc91f55df6b26625

Yanıt örneği

{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#DeviceAuthenticatedScanAgents/$entity",
    "value": [
    {
    "id": "47df41a0c-asad-4fd6d3-bbea-a93dbc0bfcaa_4edd75b2407a5b64d704b4e53d74f15",
    "machineId": "4ejh675b240118fbehiuiy5b64d704b4e53d15",
    "lastSeen": "2022-05-08T12:18:41.538203Z",
    "computerDnsName": "TEST_DOMAIN",
    "AssignedApplicationId": "9E0FA0EB-0A51-4357-9C87-C21BFBE07571",
    "ScannerSoftwareVersion": "7.1.1",
    "LastCommandExecutionTimestamp": "2022-05-08T12:18:41.538203Z",
    "mdeClientVersion": "10.8295.22621.1195"
    },
   ]
}