announcement

There has been a lapse in Environmental Protection Agency appropriations. EPA intends to keep the ENERGY STAR website, tools, and resources available, however they will not be updated regularly. If you submit a question, application, or request to EPA, it may not be processed during this period.

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

Associate Meter to a Property Use

Updated on August 3, 2015

Description

This web service associates a single meter to a property use. You must have any of the following sharing permissions:

- full access on the property and read only access on the meter
- read only access on the property and full access on the meter
- full access for both the property and meter

Any other meters currently associated to the property use are unaffected.

Version

25.0

HTTP Method

POST

Resource URL

/association/propertyUse/(propertyUseId)/meter/(meterId)

Header

Field Name Value Comments
Authorization Basic credentials

Authorization Required

Yes

Parameters

Parameter Name Description
meterId Id to the meter
propertyId Id to the property use

XML Schemas

Request/Response Schema Name
Request None
Response response.xsd

Example Request

The following example associates a meter with an id of 1321 to the property use that has an id of 1100.

POST  /association/propertyUse/1100/meter/1321

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/1100/meter" linkDescription="This is the GET url for this property use meter association list."/>
    </links>
</response>
TEST