# Deep Security Manager REST API

## Name: host

Representation of a DSM-managed Host, used for communication between the DSM and REST API users.

JSON Example:
    {"host":
     {
       "agentReportedVersion": String,
       "created": Number,
       "description": String,
       "displayname": String,
       "externalId": String,
       "hostGroupId": Number,
       "hostname": String,
       "id": Number,
       "instanceId": String,
       "lastIpUsed": String,
       "lastModified": Number,
       "lastUpdateAttempt": String,
       "platform": String,
       "policy": PolicySummaryInfo,
     }
    }

Elements
Name | Type | Required | Default Value | Description
--- | --- | --- | --- | ---
agentReportedVersion | String | No | `` | The version of the agent.
created | Number | No | `` | The time in milliseconds since Unix epoch when the host was created.
description | String | No | `` | A description of the host.
displayname | String | No | `` | The display name set for the host.
externalId | String | No | `` | The identifier assigned by the DSM administrator, if any.
hostGroupId | Number | No | `` | The primary key ID of the host's host group.
hostname | String | No | `` | The hostname used to connect to the host.
id | Number | No | `` | The Host ID assigned by the DSM.
instanceId | String | No | `` | The identifier assigned by the cloud provider, if any.
lastIpUsed | String | No | `` | The last IP used to communicate with the host.
lastModified | Number | No | `` | The time in milliseconds since Unix epoch when the host was last modified.
lastUpdateAttempt | String | No | `` | The last date and time an update was attempted on the host.
platform | String | No | `` | The platform on which the host is running.
policy | PolicySummaryInfo | No | `` | Summary information about the policy assigned to this host.

Copyright © 2017 Trend Micro Inc. All Rights Reserved.