Documentation de service Web / Catégories / Services de compteur / Modifier le compteur

Modifier le compteur

Mise à jour le 11 mars 2021

Description

Ce service Web effectue la mise à jour d'un compteur spécifié en fonction de l'information fournie dans la demande XML, et il établit toutes les autres permissions de partage de compteur nécessaires entre vous et l'utilisateur Portfolio Manager. Il retourne l'identifiant unique au compteur et un lien vers le service Web correspondant pour le récupérer. Le compteur correspondant doit déjà être partagé avec vous et vous devez avoir l'accès en écriture pour ce compteur.

Version

22.0

Méthode HTTP

PUT

URL de la ressource

/meter/(meterId)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant
Type de contenu application/xml

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
meterId Identifiant du compteur à mettre à jour

Schémas XML

Demande/réponse Nom de schéma
Demande meter.xsd
Réponse response.xsd

Exemples de demande

L'exemple suivant montre la mise à jour d'un compteur dont l'identifiant correspond à 543.

PUT  /meter/543

<?xml version="1.0" encoding="UTF-8"?>
<meter>
    <type>Electric</type>
    <name>Electric Main Meter - REVISED</name>
    <unitOfMeasure>kBtu (thousand Btu)</unitOfMeasure>
    <firstBillDate>2010-01-01</firstBillDate>
    <inUse>true</inUse>
</meter>

L'exemple suivant montre la mise à jour d'un compteur d'énergie entrante d'une unité de distribution électrique de centre de données dont l'identifiant correspond à 544.

PUT  /meter/544

<?xml version="1.0" encoding="UTF-8"?>
<meter>
    <type>Power Distribution Unit (PDU) Input Energy</type>
    <name>PDU IT Data Center - REVISED</name>
    <unitOfMeasure>kBtu (thousand Btu)</unitOfMeasure>
    <firstBillDate>2010-01-01</firstBillDate>
    <inUse>true</inUse>
</meter>

L'exemple suivant montre la mise à jour d'un compteur de débit dont l'identifiant correspond à 545.

PUT  /meter/545

<?xml version="1.0" encoding="UTF-8"?>
<meter>
    <type>Average Flow</type>
    <name>Waste water average flow meter - REVISED</name>
    <unitOfMeasure>MGal (US)</unitOfMeasure>
    <firstBillDate>2010-01-01</firstBillDate>
    <inUse>true</inUse>
</meter>

L'exemple suivant montre la mise à jour d'un compteur de papier ramassé irrégulièrement dont l'identifiant correspond à 546.

PUT  /meter/546

<?xml version="1.0" encoding="UTF-8"?>
<wasteMeter>
    <name>Disposed - Paper (REVISED)</name>
    <type>Disposed - Paper - Books</type>
    <unitOfMeasure>Gallons (US)</unitOfMeasure>
    <dataEntryMethod>intermittent</dataEntryMethod>
    <inUse>true</inUse>
</wasteMeter>

Dans l’exemple suivant, on met à jour un compteur pour indiquer qu'il s'agit d'un compteur agrégé.

PUT  /compteur/543

<?xml version="1.0" encoding="UTF-8"?>
<meter>
     <type>Electric</type>
     <name>Electric Main Meter - REVISED</name>
     <unitOfMeasure>kBtu (thousand Btu)</unitOfMeasure>
     <firstBillDate>2010-01-01</firstBillDate>
     <inUse>true</inUse>
     <aggregateMeter>true</aggregateMeter>
</meter>

Exemple de réponse

L'exemple suivant indique que la mise à jour du compteur a été réussi avec succès. Il indique aussi l'identifiant unique du compteur et un lien Internet vers le service Web correspondant pour le récupérer.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
    <id>543</id>
    <links>
        <link httpMethod="GET" link="/meter/543" linkDescription="This is the GET url for this Meter."/>
    </links>
</response>
ENVIRONNEMENT D'ESSAI