Şirket içi yönetim konsolları için envanter yönetimi API'si başvurusu

Bu makalede IoT şirket içi yönetim konsolları için Microsoft Defender için desteklenen envanter yönetimi REST API'leri listelenir

cihazlar (Tüm cihaz bilgilerini alma)

Bu API, bir şirket içi yönetim konsoluna bağlı Olan IoT için Defender algılayıcıları tarafından algılanan tüm cihazların listesini istemektedir.

URI: /external/v1/devices

GET

İstek

Sorgu parametreleri:

Ad	Açıklama	Örnek	Gerekli / İsteğe Bağlı
Yetkili	Boolean. Cihazın yetkilendirilip yetkilendirilmediğine göre filtreler.	/external/v1/devices?authorized=true /external/v1/devices?authorized=false	İsteğe Bağlı
Siteıd	Uzun tamsayıların virgülle ayrılmış listesi. Belirtilen siteler için cihazları site kimliğine göre filtreleyin.	/external/v1/devices?siteId=1,2	İsteğe Bağlı
zoneId	Uzun tamsayıların virgülle ayrılmış listesi. Belirtilen bölgeler için cihazları bölge kimliğine göre filtreleyin.	/external/v1/devices?zoneId=5,6	İsteğe Bağlı
sensorId	Uzun tamsayıların virgülle ayrılmış listesi. Belirtilen algılayıcılar için cihazları algılayıcı kimliğine göre filtreleyin.	/external/v1/devices?sensorId=8	İsteğe Bağlı

İpucu

Siteniz, bölgeniz veya algılayıcı kimliğiniz yoksa, bu değerleri almak için önce tüm cihazları sorgula.

Response

Tür: JSON

Cihazları temsil eden JSON nesneleri dizisi.

Cihaz alanları

Ad	Tür	Null atanabilir / Boş değer atanamaz	Değer listesi
id	Uzun tamsayı	Null atanamaz	Şirket içi yönetim konsolunda Cihaz Kimliği
sensorId	Uzun tamsayı	Null atanamaz	Algılayıcıdaki cihaz kimliği
zoneId	Uzun tamsayı	Null atanamaz	Cihazın bölge kimliği
Siteıd	Uzun tamsayı	Null atanamaz	Cihazın site kimliği
ipAddresses	Dizelerin JSON dizisi	Null Atanabilir	IP adreslerinin JSON dizisi. İnternet adresleri veya birden çok NIC'ye sahip bir cihaz olması durumunda her cihazın birden çok adresi olabilir.
name	Dize	Null atanamaz	Cihaz adı.
tür	Dize	Null atanamaz	Cihaz türü. Daha fazla bilgi için bkz . Desteklenen type değerler.
macAddresses	Dizelerin JSON dizisi	Null Atanabilir	MAC adreslerinin JSON dizisi. Birden çok NIC'ye sahip cihazların birden çok adresi olabilir.
Operatingsystem	Dize	Null Atanabilir	Cihaz işletim sistemi.
engineeringStation	Boole	Null atanamaz	True veya false
Tarayıcı	Boole	Null atanamaz	True veya false
Yetkili	Boole	Null atanamaz	True veya false
Satıcı	Dize	Null Atanabilir	Cihaz satıcısı.
Protokoller	JSON dizisi	Null Atanabilir	Protokol nesnelerinin JSON dizisi. Daha fazla bilgi için bkz . Protokol alanları.
Firmware	JSON dizisi	Null Atanabilir	Üretici yazılımı nesnelerinin JSON dizisi. Daha fazla bilgi için bkz . Üretici yazılımı alanları.

Protokol alanları

Ad	Tür	Null atanabilir / Boş değer atanamaz	Değer listesi
Ad	Dize	Null atanamaz	Protokol adı
Adresler	Protokol adreslerinin JSON dizisi	Null atanamaz	Master, N/Aveya protokol adresinin sayısal bir gösterimi

Üretici yazılımı alanları

Ad	Tür	Null atanabilir / Boş değer atanamaz	Değer listesi
Seri	Dize	Null atanamaz	N/Aveya üretici yazılımı seri numarası
Modeli	Dize	Null atanamaz	N/Aveya üretici yazılımı modeli
firmwareVersion	Çift	Null atanamaz	N/Aveya üretici yazılımı sürümü
additionalData	Dize	Null atanamaz	N/A veya satıcıya özgü ek üretici yazılımı verileri
moduleAddress	Dize	Null atanamaz	N/Aveya üretici yazılımı modülü adresi
Raf	Dize	Null atanamaz	N/Aveya üretici yazılımı rafı
Yuvası	Dize	Null atanamaz	N/Aveya üretici yazılımı yuvası
Adres	Dize	Null atanamaz	N/Aveya üretici yazılımı adresi

Yanıt örneği

[

    {

    "sensorId": 7,

    "zoneId": 1,

    "siteId": 1,

    "vendor": null,

    "name": "10.4.14.102",

    "firmware": [

    {

        "slot": "N/A",

        "additionalData": "N/A",

        "moduleAddress": "Network: Local network (0), Node: 0, Unit: CPU (0x0)",

        "rack": "N/A",

        "address": "10.4.14.102",

        "model": "AAAAAAAAAA",

        "serial": "N/A",

        "firmwareVersion": "20.55"

    },

    {

        "slot": "N/A",

        "additionalData": "N/A",

        "moduleAddress": "Network: Local network (0), Node: 0, Unit: Unknown (0x3)",

        "rack": "N/A",

        "address": "10.4.14.102",

        "model": "AAAAAAAAAAAAAAAAAAAA",

        "serial": "N/A",

        "firmwareVersion": "20.55"

    },

    {

        "slot": "N/A",

        "additionalData": "N/A",

        "moduleAddress": "Network: Local network (0), Node: 3, Unit: CPU (0x0)",

        "rack": "N/A",

        "address": "10.4.14.102",

        "model": "AAAAAAAAAAAAAAAAAAAA",

        "serial": "N/A",

        "firmwareVersion": "20.55"

    },

    {

        "slot": "N/A",

        "additionalData": "N/A",

        "moduleAddress": "Network: 3, Node: 0, Unit: CPU (0x0)",

        "rack": "N/A",

        "address": "10.4.14.102",

        "model": "AAAAAAAAAAAAAAAAAAAA",

        "serial": "N/A",

        "firmwareVersion": "20.55"

    }

],

"id": 79,

"macAddresses": null,

"authorized": true,

"ipAddresses": [

    "10.4.14.102"

],

"engineeringStation": false,

"type": "PLC",

"operatingSystem": null,

"protocols": [

    {

        "addresses": [],

        "id": 62,

        "name": "Omron FINS"

    }

],

"scanner": false

}

]

cURL komutu

Tür: GET

API'ler:

curl -k -H "Authorization: <AUTH_TOKEN>" 'https://<IP_ADDRESS>/external/v1/devices?siteId=&zoneId=&sensorId=&uthorized='

Örnek:

curl -k -H "Authorization: 1234b734a9244d54ab8d40aedddcabcd" 'https://127.0.0.1/external/v1/devices?siteId=1&zoneId=2&sensorId=5&authorized=true'

Sonraki adımlar

Daha fazla bilgi için bkz. IoT için Defender API başvurusuna genel bakış.