Vai al contenuto principale
PUT
/
v1
/
monitoring
/
arps
/
{siteId}
/
{arpEntryId}
Aggiorna Voce 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": "TV del Soggiorno"
}'
{
  "id": "0c8526584284b025f3c328904724cf48a1a3848b",
  "mac": "00:1A:2B:3C:4D:5E",
  "ip_address": "192.168.88.254",
  "interface": "bridge",
  "last_seen": "5 minuti fa",
  "group": "<string>",
  "hostname": "my-laptop.local",
  "manufacturer": "Apple, Inc.",
  "site_id": "d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8",
  "range": "192.168.88.0/24",
  "alias": "Server Principale",
  "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

L'identificatore univoco per il sito.

Example:

"d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"

​
arpEntryId
string
required

L'identificatore univoco per la voce ARP (un hash SHA1 dell'ID del sito e dell'indirizzo MAC).

Example:

"0c8526584284b025f3c328904724cf48a1a3848b"

Body

application/json
​
group
string<uuid> | null

L'UUID di un gruppo ARP esistente a cui assegnare questa voce.

​
alias
string | null

Un nome personalizzato e leggibile per il dispositivo.

Example:

"TV del Soggiorno"

Response

L'oggetto della voce ARP aggiornata.

​
id
string

L'identificatore univoco per la voce ARP (un hash SHA1 dell'ID del sito e dell'indirizzo MAC).

Example:

"0c8526584284b025f3c328904724cf48a1a3848b"

​
mac
string

L'indirizzo MAC del dispositivo.

Example:

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

​
ip_address
string<ipv4>

L'indirizzo IP del dispositivo.

Example:

"192.168.88.254"

​
interface
string

L'interfaccia di rete su cui è stato visto il dispositivo.

Example:

"bridge"

​
last_seen
string

Stringa leggibile che indica quando il dispositivo è stato visto l'ultima volta.

Example:

"5 minuti fa"

​
group
string | null

Il gruppo ARP a cui questo dispositivo appartiene, se presente.

​
hostname
string

L'hostname del dispositivo, se rilevato.

Example:

"my-laptop.local"

​
manufacturer
string

Il produttore del dispositivo, derivato dall'indirizzo MAC.

Example:

"Apple, Inc."

​
site_id
string<uuid>

Il sito in cui questo dispositivo è stato scoperto.

Example:

"d8f8f8f8-f8f8-f8f8-f8f8-f8f8f8f8f8f8"

​
range
string | null

L'intervallo di sottorete IP a cui appartiene il dispositivo.

Example:

"192.168.88.0/24"

​
alias
string | null

Un alias definito dall'utente per il dispositivo.

Example:

"Server Principale"

​
serial
string | null

Il numero di serie del dispositivo, se scoperto tramite SNMP.