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 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