Interface LegacyPower

All Known Implementing Classes:

LegacyPowerImpl

public interface LegacyPower

Client interface for accessing legacy IBX SmartView power data. Provides methods to retrieve current and trending power consumption measurements at various hierarchy levels within an IBX.

Method Summary

Modifier and Type	Method	Description
PowerData	getCurrent(String accountNo, String ibx, String levelType, String levelValue)	Retrieves the current power data for a specific hierarchy level and value.
TrendingPowerData	getTrending(String accountNo, String ibx, String levelType, String levelValue, String interval, String fromDate, String toDate)	Retrieves trending power data over a specified time range and interval.
List<PowerDataIBX>	postCurrent(PowerCurrentPostRequest requestBody)	Retrieves current power data for all values at the given level type using a typed request body.

Method Details

getCurrent

PowerData getCurrent(String accountNo,
 String ibx,
 String levelType,
 String levelValue)

Retrieves the current power data for a specific hierarchy level and value.

Parameters:

accountNo - the Equinix account number (required; the service answers HTTP 400 without it)

ibx - the IBX code identifying the data center

levelType - the hierarchy level type (e.g., cage, cabinet)

levelValue - the specific value for the hierarchy level

Returns:

the current power data

Throws:

IllegalArgumentException - if a parameter the spec marks required is null or blank

postCurrent

List<PowerDataIBX> postCurrent(PowerCurrentPostRequest requestBody)

Retrieves current power data for all values at the given level type using a typed request body.

Parameters:

requestBody - the typed request body specifying the account, IBX and level type to query

Returns:

a list of current power data entries

getTrending

TrendingPowerData getTrending(String accountNo,
 String ibx,
 String levelType,
 String levelValue,
 String interval,
 String fromDate,
 String toDate)

Retrieves trending power data over a specified time range and interval.

Parameters:

accountNo - the Equinix account number (required; the service answers HTTP 400 without it)

ibx - the IBX code identifying the data center

levelType - the hierarchy level type (e.g., cage, cabinet)

levelValue - the specific value for the hierarchy level

interval - the aggregation interval for trend data

fromDate - the start date of the trend range

toDate - the end date of the trend range

Returns:

the trending power data

Throws:

IllegalArgumentException - if a parameter the spec marks required is null or blank