Gestion des données d’événements d’utilisation

Article
08/24/2015

S’applique à : Windows Azure Pack

Dans un Windows Azure Pack pour Windows système de facturation serveur, les données des événements d’utilisation sur la gestion des abonnements, des plans et ainsi de suite sont censées être utilisées pour calculer les informations de facturation du locataire. Pour ce faire, l’adaptateur de facturation du système de facturation utilise l’API REST d’utilisation pour collecter les données d’événement d’utilisation et créer une base de données d’utilisation applicable aux besoins de facturation.

Obtention d’événements d’utilisation

Le point de terminaison du service d’utilisation expose l’API REST pour renvoyer les données de facturation pour les plans, les modules complémentaires, le service de plan, les modules complémentaires et les abonnements. Par exemple, pour récupérer les événements de plan, l’appel de l’API REST Des événements de plan de récupération est effectué :

https://<Computer>:30022/billing/plans?startId=0&batchSize=1 HTTP/1.1
Accept: application/json
Authorization: basic <Token>
Host: <Computer>:30022
Connection: Keep-Alive

Le corps de la réponse retourne une liste d’objets UsageEvent (Objet Usage Metering) contenant les événements de plan récents. Par exemple :

[
  {
    "EventId": 1,
    "State": 0,
    "Method": "0",
    "Entity": {
      "Id": "Idjt711xf",
      "DisplayName": "TheDisplayName",
      "State": 0,
      "ConfigState": 0,
      "QuotaSyncState": 2,
      "LastErrorMessage": null,
      "Advertisements": [
        {
          "LanguageCode": "en-us",
          "DisplayName": "TheDisplayName",
          "Description": null
        }
      ],
      "ServiceQuotas": [
        {
          "ServiceName": "webspaces",
          "ServiceInstanceId": "4576E3B4-881D-4B9F-87F4-E72206FB11D6",
          "ServiceDisplayName": "Web Site Cloud",
          "ServiceInstanceDisplayName": null,
          "ConfigState": 0,
          "QuotaSyncState": 2,
          "Settings": [

          ]
        },
        {
          "ServiceName": "sqlservers",
          "ServiceInstanceId": "2FBED6DE-5195-4F95-98DC-B67829621025",
          "ServiceDisplayName": "SQL Servers",
          "ServiceInstanceDisplayName": null,
          "ConfigState": 0,
          "QuotaSyncState": 2,
          "Settings": [

          ]
        },
        {
          "ServiceName": "mysqlservers",
          "ServiceInstanceId": "0C18772C-3596-4E2A-BD60-21230C186D17",
          "ServiceDisplayName": "MySQL Servers",
          "ServiceInstanceDisplayName": null,
          "ConfigState": 0,
          "QuotaSyncState": 2,
          "Settings": [

          ]
        },
        {
          "ServiceName": "servicebus",
          "ServiceInstanceId": "B40CC649-1ACE-4134-ADC9-1E610B64F400",
          "ServiceDisplayName": "Service Bus",
          "ServiceInstanceDisplayName": null,
          "ConfigState": 0,
          "QuotaSyncState": 2,
          "Settings": [

          ]
        }
      ],
      "SubscriptionCount": 0,
      "MaxSubscriptionsPerAccount": 1,
      "AddOnReferences": [

      ],
      "AddOns": [

      ],
      "InvitationCode": null,
      "Price": null
    },
    "EntityParentId": null,
    "NotificationEventTimeCreated": "2013-07-31T23:56:20.05"
  }
]

Pour plus d’informations sur l’API REST d’utilisation disponible, consultez Windows informations de référence sur l’API REST d’utilisation d’Azure Pack Usage Service.

Traitement des événements d’utilisation

Pour accéder aux données d’événement d’utilisation, utilisez l’objet UsageEvent (Objet Usage Metering) retourné par l’API REST Du service d’utilisation. Les notifications d’événements envoyées à l’adaptateur de facturation adhèrent au type - UsageEvent (Objet Usage Metering)<T> où T est remplacé par l’un des objets suivants.

Plan
PlanAddon
AdminSubscription
ResourceProviderReference
PlanAddonReference

L’objet UsageEvent contient des informations sur l’entité d’événement telle que Plan et Abonnement, le type d’opération telle que la création ou la suppression, et l’état actuel de l’opération. Le tableau suivant décrit les actions à effectuer dans un adaptateur de facturation pour chaque état de combinaison :

Événement/opération	Création (POST)	Mise à jour (PUT)	Supprimer
Plans	Traiter tous les événements	Ignorer	Ignorer (manuel)
Planifier des modules complémentaires	Traiter tous les événements	Ignorer	Ignorer (manuel)
Planifier les services	Traiter tous les événements	Ignorer	Ignorer (manuel)
Modules complémentaires	Traiter tous les événements	Ignorer	Ignorer (manuel)
Services complémentaires	Traiter tous les événements	Ignorer	Ignorer (manuel)
Abonnements	traiter les événements « Reconnus »	Traiter les événements « Approbation en attente » et « Reconnu »	Traiter les événements « Reconnus »
Modules complémentaires d'abonnement	traiter les événements « Reconnus », y compris les événements « dupliqués » *	Ignorer	Traiter les événements « Reconnus »

Propriétés UsageEvent significatives pour le traitement du tableau ci-dessus étant :

Entité

Contient l’objet en cours d’exploitation. Par exemple, AdminSubscription (objet Administrateur) pour un abonnement.

Méthode

Type d’opération tel que POST, PUT ou DELETE.

State

État actuel de l’opération.

Valeur	Description
0	Reconnu
1	Rejeté
2	Approbation en attente
3	Approved

Les événements en double peuvent se produire pour certaines des opérations ci-dessus. Par exemple, un événement « supprimer un plan » peut se produire deux fois dans une ligne avec les mêmes données, car l’opération peut échouer. Pour l’événement « créer un complément d’abonnement », un locataire a la possibilité d’acheter le même complément plusieurs fois (s’il est configuré de cette façon) afin que chaque événement de création soit traité de telle sorte qu’il entraîne une création d’entité dans le système de facturation. Pour toutes les autres opérations de création, les créations en double ne doivent pas être créées dans le système de facturation (c’est-à-dire si l’entité existe déjà, ne créez pas d’autre) et elles peuvent être ignorées en toute sécurité.

Mappage d’entités entre Windows Azure Pack et un système de facturation

L’adaptateur de facturation doit créer des entités dans le système de facturation avec des noms qui correspondent à l’identificateur envoyé à partir de Windows Azure Pack. De cette façon, un administrateur peut mettre en corrélation les entités dans Windows Azure Pack correspondant aux entités du système de facturation. Si le système de facturation ne prend pas en charge cela, l’adaptateur de facturation doit conserver les informations de mappage pour traduire les identificateurs utilisés par Windows Azure Pack en identificateurs utilisés par le système de facturation. Pour cette raison, un adaptateur de facturation doit disposer d’un mécanisme qui expose ces informations de mappage à un administrateur de manière sécurisée, afin que toutes les différences ou incertitudes puissent être résolues.

Gestion des abonnements

Les événements d’abonnement sont créés dans les circonstances suivantes :

Lorsqu’un abonnement est activé ou suspendu.
Lors de la migration d’un abonnement.

Suspension d’abonnement

Important

La suspension de l’abonnement comme décrit ici n’est pas disponible tant que la prochaine mise à jour de Windows Azure Pack n’est pas disponible. Dans la build RTM actuelle, la suspension et l’activation des abonnements ne sont pas détectables via cette interface. Il y aura des événements de mise à jour d’abonnement qui ne sont pas actionnables du point de vue du système de facturation et qui doivent être ignorés.

Si un abonnement devient suspendu dans Windows Azure Pack dissoue donc un locataire de provisionner de nouvelles ressources ou d’accéder à des ressources existantes à l’aide de l’abonnement suspendu, cette modification se propage dans le système de facturation via un événement de mise à jour d’abonnement. L’objet d’abonnement, AdminSubscription (objet Administrateur) a une propriété d’état qui indique si l’abonnement est actif ou suspendu. Si un administrateur suspend l’abonnement d’un utilisateur, il doit prendre les dispositions appropriées dans son système de facturation pour éviter les frais inappropriés pour l’utilisateur. Notez que les ressources existantes d’un utilisateur, comme les bases de données, les sites web et les machines virtuelles, ne sont pas supprimées ; seul l’accès du locataire à ces derniers est supprimé. En outre, étant donné que les utilisateurs peuvent avoir plusieurs abonnements, il est possible que l’un des abonnements d’un utilisateur soit suspendu pendant que le reste reste reste actif. Une suspension au niveau de l’utilisateur ne doit pas se produire dans le système de facturation, sauf si tous les abonnements dans Windows Azure Pack associé à cet utilisateur ont été suspendus.

Migration d’abonnement

Lorsqu’une migration d’abonnement est lancée dans Windows Azure Pack, un événement est exposé dans l’API REST Du service d’utilisation en tant qu’événement de mise à jour d’abonnement qui contient l’identificateur de plan du nouveau plan que les références d’abonnement. Pour détecter cela, un adaptateur de facturation doit suivre l’identificateur de plan WAP de chaque abonnement afin qu’il puisse détecter cette modification et prendre les mesures appropriées dans le système de facturation. En outre, tous les modules complémentaires d’abonnement précédemment associés à l’abonnement migré doivent être supprimés dans le système de facturation ; ces modules complémentaires sont supprimés dans Windows Azure Pack et leurs augmentations de quota sont intégrées aux quotas du nouveau plan.

Voir aussi

Windows informations de référence sur l’API REST d’utilisation du service d’utilisation d’Azure Pack

Partager via