# Deep Security Manager REST API

## Name: TenantAggregateHostProtection

A structure containing information about how much time a tenant's hosts have been protected for.

XML Example:
    <TenantAggregateHostProtection>
      <aggregateProtection>xsd:long</aggregateProtection>
      <cumulativeHours>xsd:long</cumulativeHours>
      <cumulativeSeconds>xsd:long</cumulativeSeconds>
      <tenantID>xsd:int</tenantID>
      <tenantName>xsd:string</tenantName>
    </TenantAggregateHostProtection>
| JSON Example:
    {"TenantAggregateHostProtection":
     {
       "aggregateProtection": Number,
       "cumulativeHours": Number,
       "cumulativeSeconds": Number,
       "tenantID": Number,
       "tenantName": String,
     }
    }

Elements
Name | Type | Required | Nillable | Default Value | Description
--- | --- | --- | --- | --- | ---
aggregateProtection | xsd:long | false | false |  | The total amount of protection time received over the requested time period, in seconds.
cumulativeHours | xsd:long | false | false |  | The cumulative number of hours (partial hours rounded up) of protection the tenant has received over the tenant's lifetime Note that this value is stored by Deep Security Manager and is only updated periodically, that is, it is not computed for every API call This means that if the period over which protection information is requested starts before the tenant was created and ends at the current time, this value may be less than the value returned for the aggregate protection time.
cumulativeSeconds | xsd:long | false | false |  | The cumulative number of seconds of protection the tenant has received over the tenant's lifetime Note that this value is stored by Deep Security Manager and is only updated periodically, that is, it is not computed for every API call This means that if the period over which protection information is requested starts before the tenant was created and ends at the current time, this value may be less than the value returned for the aggregate protection time.
tenantID | xsd:int | false | false |  | The internal ID of the tenant.
tenantName | xsd:string | false | false |  | The name of the tenant.

Copyright © 2015 Trend Micro Inc. All Rights Reserved.