Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
API açıklaması
Uç Nokta için Defender'dan cihazı kullanıma alın.
Önkoşullar
Desteklenen işletim sistemleri
| İşletim Sistemi | Desteklenen sürümler |
|---|---|
| Windows istemcisi | Windows 11 ve Windows 10, sürüm 1703 ve sonrası |
| Windows Server | Windows Server 2019 ve sonrası; Windows Server 2012 R2 ve Windows Server 2016, Defender for Endpoint için yeni birleşik ajanı kullanırken |
| macOS | macOS 14 ve sonrası |
| Linux | Desteklenen Linux dağıtımları |
Sınırlamalar
- Bu API için hız sınırlamaları dakikada 100 çağrı ve saatte 1.500 çağrıdır.
- Windows cihazlarında, offboarding API'si çalıştırıldığında sadece sensör hizmeti durdurulur. Onboarding bilgilerini kayıt defterinden çıkarma betikleri gibi 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 200 - Created response döndürür.
Ö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"
}