v4

latestOpenAPI 3.0.1Apache 2.02026-08-036821,1001.5 MB
Configuration - Policy

Get MAC Object by ID

Get an existing MAC object by the specified ID.

get/mac-object-profiles/{id}

Path parameters

idinteger required

The MAC Object ID

Response

OK

idinteger required

The unique identifier

create_timestring date-time required

The create time in UTC (ISO 8601 format)

update_timestring date-time required

The last update time in UTC (ISO 8601 format)

org_idinteger

The organization identifier, valid when enabling HIQ feature

namestring

The MAC object name

descriptionstring

The MAC object description.

predefinedboolean

Whether the MAC Oui is predefined

valuestring

The MAC octets in hexadecimal format without separators. For MAC_OUI: 6 characters (e.g., '001DA2'). For MAC_ADDRESS or MAC_RANGE: 12 characters (e.g., 'AABBCCDDEEFF').

mac_type'MAC_OUI' | 'MAC_RANGE' | 'MAC_ADDRESS'

The MAC object type e.g, "MAC_OUI", "MAC_RANGE" or "MAC_ADDRESS"

defender_definedboolean

Whether defender is defined

mac_address_endstring

The MAC address end in hexadecimal format without separators (12 characters), only available for "MAC_RANGE".

Example response

{
  "value": "AABBCCDDEEFF",
  "mac_address_end": "FFFFFFFFFFFF"
}