PUT
/
api
/
utm-network-scans
{
  "id": 123,
  "assetIp": "<string>",
  "assetAddresses": "<string>",
  "assetMac": "<string>",
  "assetOs": "<string>",
  "assetOsArch": "<string>",
  "assetOsMajorVersion": "<string>",
  "assetOsMinorVersion": "<string>",
  "assetOsPlatform": "<string>",
  "assetOsVersion": "<string>",
  "assetName": "<string>",
  "assetAliases": "<string>",
  "assetAlias": "<string>",
  "assetAlive": true,
  "assetStatus": "NEW",
  "assetSeverityMetric": 123,
  "discoveredAt": "2023-11-07T05:31:56Z",
  "modifiedAt": "2023-11-07T05:31:56Z",
  "assetNotes": "<string>",
  "serverName": "<string>",
  "groupId": 123,
  "registeredMode": "CUSTOM",
  "isAgent": true,
  "registerIp": "<string>",
  "updateLevel": "DATASOURCE",
  "assetType": {
    "id": 123,
    "typeName": "<string>"
  },
  "ports": [
    {
      "id": 123,
      "scanId": 123,
      "port": 123,
      "tcp": "<string>",
      "udp": "<string>"
    }
  ],
  "metrics": [
    {
      "id": "<string>",
      "assetName": "<string>",
      "metric": "<string>",
      "amount": 123
    }
  ],
  "dataInputList": [
    {
      "id": "<string>",
      "source": "<string>",
      "dataType": "<string>",
      "timestamp": 123,
      "median": 123,
      "down": true
    }
  ],
  "assetGroup": {
    "id": 123,
    "groupName": "<string>",
    "groupDescription": "<string>",
    "createdDate": "2023-11-07T05:31:56Z",
    "metrics": [
      {
        "id": "<string>",
        "assetName": "<string>",
        "metric": "<string>",
        "amount": 123
      }
    ],
    "assets": [
      {}
    ],
    "collectors": [
      {
        "id": 123,
        "status": "<string>",
        "collectorKey": "<string>",
        "ip": "<string>",
        "hostname": "<string>",
        "version": "<string>",
        "module": "<string>",
        "lastSeen": "2023-11-07T05:31:56Z",
        "groupId": 123,
        "assetGroup": {},
        "active": true
      }
    ],
    "type": "<string>"
  },
  "uuid": 123
}

Authorizations

Authorization
string
header
required

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

Utm-Internal-Key
string
header
required

Body

application/json
id
integer
assetIp
string
Maximum length: 255
assetAddresses
string
assetMac
string
Maximum length: 255
assetOs
string
Maximum length: 255
assetOsArch
string
Maximum length: 100
assetOsMajorVersion
string
Maximum length: 20
assetOsMinorVersion
string
Maximum length: 20
assetOsPlatform
string
Maximum length: 100
assetOsVersion
string
Maximum length: 100
assetName
string
Maximum length: 255
assetAliases
string
Maximum length: 500
assetAlias
string
assetAlive
boolean
assetStatus
enum<string>
Available options:
NEW,
CHECK,
MISSING
assetSeverityMetric
number
discoveredAt
string
modifiedAt
string
assetNotes
string
serverName
string
Maximum length: 255
groupId
integer
registeredMode
enum<string>
Available options:
CUSTOM,
DISCOVERED,
DYNAMIC
isAgent
boolean
registerIp
string
Maximum length: 50
updateLevel
enum<string>
Available options:
DATASOURCE,
SCANNER,
AGENT
assetType
object
ports
object[]
metrics
object[]
dataInputList
object[]
assetGroup
object
uuid
integer

Response

200 - */*
OK
id
integer
assetIp
string
Maximum length: 255
assetAddresses
string
assetMac
string
Maximum length: 255
assetOs
string
Maximum length: 255
assetOsArch
string
Maximum length: 100
assetOsMajorVersion
string
Maximum length: 20
assetOsMinorVersion
string
Maximum length: 20
assetOsPlatform
string
Maximum length: 100
assetOsVersion
string
Maximum length: 100
assetName
string
Maximum length: 255
assetAliases
string
Maximum length: 500
assetAlias
string
assetAlive
boolean
assetStatus
enum<string>
Available options:
NEW,
CHECK,
MISSING
assetSeverityMetric
number
discoveredAt
string
modifiedAt
string
assetNotes
string
serverName
string
Maximum length: 255
groupId
integer
registeredMode
enum<string>
Available options:
CUSTOM,
DISCOVERED,
DYNAMIC
isAgent
boolean
registerIp
string
Maximum length: 50
updateLevel
enum<string>
Available options:
DATASOURCE,
SCANNER,
AGENT
assetType
object
ports
object[]
metrics
object[]
dataInputList
object[]
assetGroup
object
uuid
integer