Partager via


Gestion des demandes d’approbation de facturation

 

S’applique à : Windows Azure Pack

Lorsqu’un locataire Azure Pack Windows crée ou supprime un abonnement ou un module complémentaire d’abonnement, il peut être nécessaire d’approuver ou de refuser la demande en fonction des pratiques commerciales de facturation de l’hôte. Windows Azure Pack définit des interfaces REST pour approuver la création et la suppression d’un abonnement et d’un module complémentaire d’abonnement. Ceux-ci sont implémentés par un adaptateur de facturation et une fois inscrits, ils sont appelés chaque fois qu’un locataire crée ou supprime un abonnement ou un module complémentaire d’abonnement. Le code de réponse HTTP indique si l’opération demandée est approuvée ou non. Un nombre supérieur ou égal à 400 est refusé ; Un nombre inférieur à 400 est accepté. Le contenu du corps de la réponse est ignoré.

Point de terminaison de l’API REST d’approbation de facturation

Voici l’API REST d’approbation de facturation qu’un adaptateur de facturation doit implémenter :

S’il est inscrit en tant que facturation ou obligatoire, les appels REST bloquent et sont envoyés en tant que notifications de demande en temps réel à tous les inscrits du paramètre NotificationSubscribers dans le service d’utilisation. L’état de l’événement de notification est en attente d’approbation. Selon la ou les réponses des abonnés bloquants, l’opération sera approuvée ou rejetée. Si aucun abonné bloquant n’est inscrit, l’événement est approuvé automatiquement et est défini sur l’état reconnu et exposé via l’API REST du service d’utilisation. Pour plus d’informations sur les types d’abonnements obligatoires et de facturation, configurez le service d’utilisation Windows Azure Pack.

Le signal réel pour valider ces opérations dans le système de facturation sera des événements exposés dans l’API REST, qu’ils soient inscrits en tant qu’abonnés de notification ou non; aucune action ne doit être effectuée sur les demandes envoyées via cette API, car elles ne sont que des requêtes.

Important

La version Windows Azure Pack RTM expose les événements de mise à jour d’abonnement sur l’API d’approbation de facturation en temps réel et tous les inscrits de ce service devront approuver automatiquement ces événements.

Pour plus d’informations sur l’inscription du point de terminaison de l’API REST d’approbation de facturation, consultez Configuration du service d’utilisation d’Azure Pack Windows.

Authentification d’une demande d’approbation

L’API REST d’approbation de facturation doit nécessiter au moins l’authentification de base.

Traitement d’une demande d’approbation

Voici un exemple de demande de création d’abonnement envoyée à un adaptateur de facturation. Le code de réponse HTTP envoyé par l’adaptateur de facturation doit être 204 pour représenter l’approbation ou 403 pour représenter le refus de la demande.

POST /usage/subscriptions HTTP/1.1
Content-Type: application/json; charset=utf-8
Host: 10.121.217.127:8888
Content-Length: 564
Expect: 100-continue
{
  "EventId": 6530,
  "State": 2,
  "Method": "POST",
  "Entity": {
    "SubscriptionID": "0a53e53d-1334-424e-8c63-ade05c361be2",
    "SubscriptionName": "ExamplePlan",
    "AccountAdminLiveEmailId": "user@example.com",
    "ServiceAdminLiveEmailId": null,
    "CoAdminNames": [

    ],
    "AddOnReferences": [

    ],
    "AddOns": [

    ],
    "State": 0,
    "QuotaSyncState": 0,
    "ActivationSyncState": 0,
    "PlanId": "Examphlztfpgi",
    "Services": [

    ],
    "LastErrorMessage": null,
    "Features": null,
    "OfferFriendlyName": null,
    "OfferCategory": null,
    "Created": "0001-01-01T00:00:00Z"
  },
  "EntityParentId": null,
  "NotificationEventTimeCreated": "2013-09-25T00:32:08.8724845Z"
}

Si l’adaptateur de facturation reçoit un événement et retourne un message d’erreur, l’événement n’est pas terminé avec succès dans l’API Gestion des services. Si ce n’est pas le comportement attendu, l’adaptateur de facturation doit renvoyer un code d’état 200 pour chaque notification d’événement et consigner les échecs pour un traitement ultérieur. Tous les événements inconnus reçus doivent entraîner le retour d’un code d’état 200.

Voir aussi

Configuration du service d’utilisation d’Azure Pack Windows
Implémentation d’un adaptateur de facturation