Documentation de service Web / Catégories / Services de compteur / Supprimer toutes les données de consommation

Supprimer toutes les données de consommation

Mise à jour le 28 juin 2021

Description

Ce service Web supprime toutes les données de consommation d'un compteur spécifique. Le compteur doit déjà être partagé avec vous et vous devez y avoir l'accès en écriture. Ce service Web prend en charge les types de compteur suivants : énergie, eau, énergie TI d'un centre de traitement des données, débit d'eau potable ou usée. La suppression des données de consommation est permanente et irreversible.

REMARQUE: si vous avez mal orthographié le paramètre "startDate" ou "endDate", le comportement résultant est équivalent à celui qui aurait été obtenu si le paramètre avait été omis. Par exemple, si vous exécutez ce service Web et que vous avez mal orthographié les deux paramètres de plage de dates, toutes les données de consommation pour ce compteur seront supprimées, ce qui est le comportement par défaut.

Version

22.0

Méthode HTTP

DELETE

URL de la ressource

/meter/(meterId)/consumptionData?startDate=(YYYY-MM-DD)&endDate=(YYYY-MM-DD)

En-tête

Nom du champ Valeur Commentaires
Autorisation Basic authentifiant

Autorisation requise

Oui

Paramètres

Nom du paramètre Description
endDate Facultatif. Indique la date de fin d'une gamme de dates personnalisée pour supprimer les données de consommation. Doit être une date valide, dans le format AAAA-MM-JJ.
meterId Identifiant du compteur
startDate Facultatif. Indique la date de début d'une gamme de dates personnalisée pour supprimer les données de consommation. Doit être une date valide, dans le format AAAA-MM-JJ.

Schémas XML

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

Exemples de demande

L'exemple suivant montre la suppression de toutes les données de consommation du compteur dont l'identifiant correspond à 500.

DELETE  /meter/500/consumptionData

L'exemple suivant supprime les données de consommation du compteur dont l'identifiant est 500 et qui couvrent une période allant du 1er janvier 2011 au 31 décembre.

DELETE  /meter/500/consumptionData?startDate=2011-01-01&endDate=2011-12-31

Exemple de réponse

L'exemple suivant indique que la suppression des données de consommation du compteur dont l'identifiant correspond à 500 a été réussie avec succès.

<?xml version="1.0" encoding="UTF-8"?>
<response status="Ok"/>
ENVIRONNEMENT DE PRODUCTION