Documentation de service Web / Catégories / Services de compteur / Modifier le compteur
Mise à jour le 11 mars 2021
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.
22.0
PUT
/meter/(meterId)
Nom du champ | Valeur | Commentaires |
---|---|---|
Autorisation | Basic authentifiant | |
Type de contenu | application/xml |
Oui
Nom du paramètre | Description |
---|---|
meterId | Identifiant du compteur à mettre à jour |
Demande/réponse | Nom de schéma |
---|---|
Demande | meter.xsd |
Réponse | response.xsd |
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>
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>