Makine API'sini çıkarma

API açıklaması

Uç Nokta için Defender'dan cihazı kullanıma alın.

Önkoşullar

Desteklenen işletim sistemleri

• Bu API Windows 11, Windows 10, sürüm 1703 ve sonraki sürümlerde desteklenir; Windows Server 2019 ve üzeri; Uç Nokta için Defender için yeni, birleşik aracı kullanılırken R2 ve Windows Server 2016 Windows Server 2012.

Sınırlamalar

• Bu API için hız sınırlamaları dakikada 100 çağrı ve saatte 1.500 çağrıdır.
• Bu API macOS veya Linux cihazlarda desteklenmez.
• Çıkarma API'sinin çalıştırılması yalnızca algılayıcı hizmetinin çalışmasını durdurur, ancak ekleme betiğinin yaptığı gibi kayıt defterinden ekleme bilgilerini kaldırmaz.

İzinler

Microsoft, rolleri en az izinle kullanmanızı önerir. Bu, kuruluşunuzun güvenliğini artırmaya yardımcı olur. Genel Yönetici, mevcut bir rolü kullanamıyorsanız acil durum senaryolarıyla sınırlı olması gereken yüksek ayrıcalıklı bir roldür.

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

• Kullanıcıya uygun bir rol atanmış olmalıdır. Daha fazla bilgi için bkz. İzin seçenekleri.

• Kullanıcının cihaz grubu ayarlarına bağlı olarak cihaza erişimi olmalıdır. 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 API'leri için Defender'ı kullanma

İzin türü	İzin	İzin görünen adı
Uygulama	Machine.Offboard	Offboard machine
Temsilci (iş veya okul hesabı)	Machine.Offboard	Offboard machine

HTTP isteği

POST https://api.security.microsoft.com/api/machines/{id}/offboard

Makine kimliği, cihazı seçtiğinizde URL'de bulunabilir. Genellikle, URL'de bulunabilen 40 basamaklı alfasayısal bir sayıdır.

İstek üst bilgileri

Name	Tür	Açıklama
Yetkilendirme	Dize	Taşıyıcı {token}. Gerekli.
İçerik Türü	dize	application/json. Gerekli.

İstek gövdesi

İstek gövdesinde aşağıdaki parametreleri içeren bir JSON nesnesi sağlayın:

Parametre	Tür	Açıklama
Açıklama ekleme	Dize	Eylemle ilişkilendirilecek açıklama. Gerekli.

Yanıt

Başarılı olursa, bu yöntem yanıt gövdesinde kod ve Makine Eylemi döndürür200 - Created response.

Örnek

Istek

burada isteğin bir örneği verilmiş. JSON açıklaması eklenmediyse koduyla 400hata oluşur.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/offboard

{
  "Comment": "Offboard machine by automation"
}