List Exchange Storage History: list_exchange_storage_history

Service name: list_exchange_storage_history

URL

https://SERVER/api/?apikey=yourAPItoken&service=list_exchange_storage_history

&required_parameters=required_parameters

[&optional_parameters=optional_parameters]

Description

Returns the daily (interval=DAY), weekly (interval=WEEK) or monthly (interval=MONTH) Exchange Store Size information for a device. Only available for devices where the (Windows server only) Exchange Store Size Check is configured.

Parameters

Post Variable

Description

Type

Required

Options

Default

describe

Optional. Returns a description of the service.

boolean

true

deviceid

The deviceid must be a valid id.

integer

yes

interval

Interval length:

DAY

WEEK

MONTH

string

yes

DAY

WEEK

MONTH

since

Only obtain data since this date/time (inclusive); otherwise all available data is returned. All UTC, ISO-8601; format depends on interval:

interval	format	e.g.
DAY	[year]-[month]-[day]	2013-10-21
WEEK	[year]W[week number]	2013W43
MONTH	[year]-[month]	2013-10

string

Example Service Call =list_exchange_storage_history

https://SERVER/api/?apikey=yourAPItoken&service=list_exchange_storage_history&deviceid=DEVICEID&interval=INTERVAL&since=SINCE

Example Response

<?xml version="1.0" ?>

<store>

<store_name>an_exchange_store_name</store_name>

<edb_file>C:\a\path\to\edb\file</edb_file>

<slv_file>C:\a\path\to\slv\file</slv_file>

<check_id>17186</check_id> [Check responsible for populating this data]

<data>

<day>2013-08-05</day>[only if interval=DAY. UTC ISO-8601 year month day]

<week>2013W31</week>[only if interval=WEEK. UTC ISO-8601 year week]

<month>2013-08</month>[only if interval=MONTH. UTC ISO-8601 year month]

<store_size>52672</store_size>[megabytes]

</data>

<data>

<store_size>52978</store_size>

</data>

<data>

<store_size>54241</store_size>

</data>

[...more data elements...]

</history>

</store>

[...more store elements (if applicable)...]

</result>

</example>

Fields Description

An exchange_storage element containing store elements (or none if no data available) for each drive which has a corresponding check on the device; each drive element contains:

key

description

store_name

name of monitored Exchange store

edb_file

name of monitored/measured EDB file

slv_file

name of monitored/measured SLV file

check_id

the check which populated this data

history

a list (in XML output these will be data elements), each entry containing:

day	only if interval=DAY	the day this data is for; format: [year]-[month]-[day]
week	only if interval=WEEK	the week this data is for; format: [year]W[week number]
month	only if interval=MONTH	the month this data is for; format: [year]-[month]
store_size		integer; total storage space used for the EDB file and SLV file combined (megabytes)

Notes

Data is available for a maximum of 61 intervals (for each possible interval), if you need data for longer you must store a copy yourself then - for efficiency - provide the since parameter to only request new data