announcement

During the current lapse in appropriations, EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. Many services may not be available during this time.

Web Service Documentation / Categories / Meter Services / Associate Meters to a Property Use

Associate Meters to a Property Use

Updated on December 10, 2013

Description

This web service associates a set of meters to a property use based on the set of meters provided in the XML request. All submissions overwrite/replace previous settings.

Version

25.0

HTTP Method

POST

Resource URL

/association/propertyUse/(propertyUseId)/meter

Header

Field Name Value Comments
Authorization Basic credentials
Content-Type application/xml

Authorization Required

Yes

Parameters

Parameter Name Description
propertyUseId Id to the property use

XML Schemas

Request/Response Schema Name
Request association.xsd
Response response.xsd

Example Request

The following example associates 2 meters to the property use that has an id of 1001.

POST  /association/propertyUse/1001/meter

<?xml version="1.0" encoding="UTF-8"?>
<meterPropertyUseAssociationList>
    <meterId>11</meterId>
    <meterId>21</meterId>
</meterPropertyUseAssociationList>

Example Response

The following example indicates that the association was performed successfully.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
    <links>
        <link httpMethod="GET" link="/association/propertyUse/1001/meter" linkDescription="This is the GET url for this property use meter association list."/>
    </links>
</response>
TEST