Documentation de service Web / Catégories / Services de compteur / Obtenir les modifications apportées à la liste d’utilisations de propriété

Obtenir les modifications apportées à la liste d’utilisations de propriété

Mise à jour le 26 février 2024

Description

Ce service Web renvoie une liste des compteurs d’une propriété précise qui ont été modifiés depuis une date précisée par l’utilisateur. La liste des compteurs renvoyés est propre à la propriété. Elle ne contient que les compteurs que vous êtes autorisé à consulter. Les résultats sont renvoyés par ensembles de 1 000. Les actions qui entraînent l’inclusion d’un compteur dans la liste peuvent avoir été effectuées par tout utilisateur ayant accès au compteur. Une liste des actions des utilisateurs qui entraînent l’inclusion d’un compteur dans la liste renvoyée est disponible ici.

Pour en savoir plus sur la façon dont ce service Web utilise les mesures de dernière modification et sur la différence entre les renseignements d’audit fournis par des appels comme Get-Property, Get-Meter, Get-Property-Use, etc., consultez Get What Changed Property List.

Version

27.0

Méthode HTTP

GET

URL de la ressource

/property/(propertyId)/meter/whatChanged?date=(YYYY-MM-DD)

En-tête

Nom du champ Valeur Commentaires
Authorization Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
date Indique la date de début de la période visée. Doit être une date valide dans le format YYYY-MM-DD. La date de fin de la période visée correspond à la date actuelle. La date de fin ne peut pas être modifiée.
nextPageKey Facultatif. Cet élément sert de référence pour la détermination des résultats à inclure à la prochaine page. Il n'est pas un numéro de page. Il n'est généralement pas inclus dans l'appel initial et est fourni si les résultats sont paginés.
previousPageKey Facultatif. Cet élément sert de référence pour la détermination des résultats à inclure à la page précédente. Il n'est pas un numéro de page. Il n'est généralement pas inclus dans l'appel initial et est fourni si les résultats sont paginés.
propertyId Identifiant de la propriété

Schémas XML

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

Exemple de demande

L’exemple suivant permet d’extraire la deuxième page d’une liste d’utilisations de propriété qui ont changé depuis le 31 juillet 2010. Ces utilisations de propriété sont destinées au client qui a un identifiant de 100.

GET  /property/100/meter/whatChanged?nextPageKey=3000&date=2010-07-31

Exemple de réponses

L'exemple qui suit récupère une liste de compteurs appartenant à un propriété est 100 qui ont été modifiés depuis le 31 juillet 2010. La liste contient des liens vers des services Web dont vous pouvez vous servir pour récupérer des informations sur chaque compteur.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
     <links>
          <link id="861" httpMethod="GET" link="/meter/861" linkDescription="This is the GET url for this Meter." hint="Electric Meter"/>
          <link id="341" httpMethod="GET" link="/meter/341" linkDescription="This is the GET url for this Meter." hint="NG Meter"/>
          <link httpMethod="GET" link="/property/100/meter/whatChanged?nextPageKey=4000&date=2010-07-31" linkDescription="next page"/>
          <link httpMethod="GET" link="/property/100/meter/whatChanged?previousPageKey=3000&date=2010-07-31" linkDescription="previous page"/>
     </links>
</response>

Une liste sans compteurs est affichée. Aucun compteur a été modifié.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok">
     <links/>
</response>
ENVIRONNEMENT D'ESSAI