OSID Logo
OSID Specifications
metering package
Version 3.0.0
Release Candidate Preview
Interfaceosid.metering.MeterLookupSession
Implementsosid.OsidSession
Description

This session defines methods for retrieving meters. A Meter represents a statistic.

This lookup session defines several views:

  • comparative view: elements may be silently omitted or re-ordered
  • plenary view: provides a complete result set or is an error condition
  • federated utility view: includes meters in utilities which are children of this utility in the utility hierarchy
  • isolated utility view: restricts lookups to this utility only
MethodgetUtilityId
Description

Gets the Utility Id associated with this session.

Returnosid.id.Idthe Utility Id associated with this session
CompliancemandatoryThis method must be implemented.
MethodgetUtility
Description

Gets the Utility associated with this session.

Returnosid.metering.Utilitythe utility
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodcanLookupMeters
Description

Tests if this user can lookup meters. A return of true does not guarantee successful authorization. A return of false indicates that it is known all methods in this session will result in a PERMISSION_DENIED. This is intended as a hint to an application that may opt not to offer reading operations.

Returnboolean false if lookup methods are not authorized, true otherwise
CompliancemandatoryThis method must be implemented.
MethoduseComparativeMeterView
Description

The returns from the lookup methods may omit or translate elements based on this session, such as authorization, and not result in an error. This view is used when greater interoperability is desired at the expense of precision.

CompliancemandatoryThis method is must be implemented.
MethodusePlenaryMeterView
Description

A complete view of the Meter returns is desired. Methods will return what is requested or result in an error. This view is used when greater precision is desired at the expense of interoperability.

CompliancemandatoryThis method is must be implemented.
MethoduseFederatedUtilityView
Description

Federates the view for methods in this session. A federated view will include meters in utilities which are children of this utility in the utility hierarchy.

CompliancemandatoryThis method is must be implemented.
MethoduseIsolatedUtilityView
Description

Isolates the view for methods in this session. An isolated view restricts retrievals to this utility only.

CompliancemandatoryThis method is must be implemented.
MethodgetMeter
Description

Gets the Meter specified by its Id. In plenary mode, the exact Id is found or a NOT_FOUND results. Otherwise, the returned Meter may have a different Id than requested, such as the case where a duplicate Id was assigned to a Meter and retained for compatibility.

Parametersosid.id.IdmeterIdthe Id of the Meter to retrieve
Returnosid.metering.Meterthe returned Meter
ErrorsNOT_FOUNDno Meter found with the given Id
NULL_ARGUMENT meterId is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMetersByIds
Description

Gets a MeterList corresponding to the given IdList. In plenary mode, the returned list contains all of the meters specified in the Id list, in the order of the list, including duplicates, or an error results if an Id in the supplied list is not found or inaccessible. Otherwise, inaccessible meters may be omitted from the list and may present the elements in any order including returning a unique set.

Parametersosid.id.IdListmeterIdsthe list of Ids to retrieve
Returnosid.metering.MeterListthe returned Meter list
ErrorsNOT_FOUNDan Id was not found
NULL_ARGUMENT meterIds is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMetersByGenusType
Description

Gets a MeterList corresponding to the given meter genus Type which does not include meters of types derived from the specified Type. In plenary mode, the returned list contains all known meters or an error results. Otherwise, the returned list may contain only those meters that are accessible through this session.

Parametersosid.type.TypemeterGenusTypea meter genus type
Returnosid.metering.MeterListthe returned Meter list
ErrorsNULL_ARGUMENT meterGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMetersByParentGenusType
Description

Gets a MeterList corresponding to the given meter genus Type and include meters of types derived from the specified Type. In plenary mode, the returned list contains all known meters or an error results. Otherwise, the returned list may contain only those meters that are accessible through this session.

Parametersosid.type.TypemeterGenusTypea meter genus type
Returnosid.metering.MeterListthe returned Meter list
ErrorsNULL_ARGUMENT meterGenusType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMetersByRecordType
Description

Gets a MeterList containing the given meter record Type. In plenary mode, the returned list contains all known meters or an error results. Otherwise, the returned list may contain only those meters that are accessible through this session.

Parametersosid.type.TypemeterRecordTypea meter record type
Returnosid.metering.MeterListthe returned Meter list
ErrorsNULL_ARGUMENT meterRecordType is null
OPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.
MethodgetMeters
Description

Gets all meters. In plenary mode, the returned list contains all known meters or an error results. Otherwise, the returned list may contain only those meters that are accessible through this session.

Returnosid.metering.MeterLista list of meters
ErrorsOPERATION_FAILEDunable to complete request
PERMISSION_DENIEDauthorization failure
CompliancemandatoryThis method must be implemented.