الانتقال إلى المحتوى الرئيسي
PUT
/
v1
/
monitoring
/
arps
/
{siteId}
/
{arpEntryId}
تحديث إدخال ARP
curl --request PUT \
  --url https://api.altostrat.io/v1/monitoring/arps/{siteId}/{arpEntryId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "group": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "alias": "تلفزيون غرفة المعيشة"
}'
{
  "id": "0c8526584284b025f3c328904724cf48a1a3848b",
  "mac": "00:1A:2B:3C:4D:5E",
  "ip_address": "192.168.88.254",
  "interface": "bridge",
  "last_seen": "منذ 5 دقائق",
  "group": "<string>",
  "hostname": "my-laptop.local",
  "manufacturer": "Apple, Inc.",
  "site_id": "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "range": "192.168.88.0/24",
  "alias": "الخادم الرئيسي",
  "serial": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
siteId
string<uuid>
required

المعرّف الفريد للموقع.

Example:

"d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"

​
arpEntryId
string
required

المعرّف الفريد لإدخال ARP (تجزئة SHA1 لمعرّف الموقع وعنوان MAC).

Example:

"0c8526584284b025f3c328904724cf48a1a3848b"

Body

application/json
​
group
string<uuid> | null

مُعرّف UUID لمجموعة ARP موجودة لتعيين هذا الإدخال إليها.

​
alias
string | null

اسم مخصص ومقروء بشريًا للجهاز.

Example:

"تلفزيون غرفة المعيشة"

Response

كائن إدخال ARP المحدث.

​
id
string

المعرّف الفريد لإدخال ARP (تجزئة SHA1 لمعرّف الموقع وعنوان MAC).

Example:

"0c8526584284b025f3c328904724cf48a1a3848b"

​
mac
string

عنوان MAC للجهاز.

Example:

"00:1A:2B:3C:4D:5E"

​
ip_address
string<ipv4>

عنوان IP للجهاز.

Example:

"192.168.88.254"

​
interface
string

واجهة الشبكة التي شوهد عليها الجهاز.

Example:

"bridge"

​
last_seen
string

نص مقروء بشريًا يشير إلى آخر مرة شوهد فيها الجهاز.

Example:

"منذ 5 دقائق"

​
group
string | null

مجموعة ARP التي ينتمي إليها هذا الجهاز، إن وجدت.

​
hostname
string

اسم مضيف الجهاز، إذا تم اكتشافه.

Example:

"my-laptop.local"

​
manufacturer
string

الشركة المصنعة للجهاز، مشتقة من عنوان MAC.

Example:

"Apple, Inc."

​
site_id
string<uuid>

الموقع الذي تم اكتشاف هذا الجهاز فيه.

Example:

"d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"

​
range
string | null

نطاق الشبكة الفرعية IP الذي ينتمي إليه الجهاز.

Example:

"192.168.88.0/24"

​
alias
string | null

اسم مستعار يحدده المستخدم للجهاز.

Example:

"الخادم الرئيسي"

​
serial
string | null

الرقم التسلسلي للجهاز، إذا تم اكتشافه عبر SNMP.