Goedkeuringsaanvragen voor facturering verwerken

 

Van toepassing op: Windows Azure Pack

Wanneer een Windows Azure Pack-tenant een abonnement of abonnementsinvoegtoepassing maakt of verwijdert, kan het nodig zijn om de aanvraag goed te keuren of te weigeren, afhankelijk van de bedrijfsprocedures voor facturering van de hoster. Windows Azure Pack definieert REST-interfaces voor het goedkeuren van de invoegtoepassing voor het maken en verwijderen van abonnementen. Deze worden geïmplementeerd door een factureringsadapter en zodra deze zijn geregistreerd, worden aangeroepen wanneer een tenant een abonnement of abonnementsinvoegtoepassing maakt of verwijdert. De HTTP-antwoordcode geeft aan of de aangevraagde bewerking is goedgekeurd of niet. Een getal hoger of gelijk aan 400 wordt geweigerd; Een getal lager dan 400 wordt geaccepteerd. De inhoud van de antwoordtekst wordt genegeerd.

REST API-eindpunt voor factureringsgoedkeuring

Hieronder ziet u de REST API voor factureringsgoedkeuring die een factureringsadapter moet implementeren:

• Melding voor goedkeuring van abonnement maken

• Melding van goedkeuring van abonnement verwijderen

• Melding van goedkeuringsgebeurtenis voor abonnementsinvoegtoepassing maken

• Melding van goedkeuringsgebeurtenis van abonnementsinvoegtoepassing verwijderen

Als deze is geregistreerd als verplicht of facturering, worden de REST-aanroepen geblokkeerd en worden ze in realtime verzonden als aanvraagmeldingen naar alle eventuele registraties van de instelling NotificationSubscribers in de Usage Service. De status van de meldings gebeurtenis wordt in behandeling. Afhankelijk van de reacties van eventuele blokkerende abonnees, wordt de bewerking goedgekeurd of geweigerd. Als er geen blokkerende abonnees zijn geregistreerd, wordt de gebeurtenis automatisch goedgekeurd en wordt deze ingesteld op de erkende status en beschikbaar gemaakt via de REST API van de Usage Service. Voor meer informatie over typen verplichte en factureringsabonnementen configureert u de Windows Azure Pack Usage Service.

Het werkelijke signaal voor het doorvoeren van deze bewerkingen in het factureringssysteem zijn gebeurtenissen die worden weergegeven in de REST API, ongeacht of ze zijn geregistreerd als meldingsabonnee of niet; Er mag geen actie worden ondernomen op de aanvragen die via deze API worden verzonden, omdat dit alleen aanvragen zijn.

Belangrijk

De Windows Azure Pack RTM-release bevat updategebeurtenissen voor abonnementen in de realtime-API voor factureringsgoedkeuring en alle eventuele registraties van die service moeten deze gebeurtenissen automatisch goedkeuren.

Zie De Windows Azure Pack Usage Service configureren voor meer informatie over het registreren van het REST API-eindpunt voor factureringsgoedkeuring.

Een goedkeuringsaanvraag verifiëren

Voor de REST API voor factureringsgoedkeuring moet ten minste basisverificatie zijn vereist.

Een goedkeuringsaanvraag verwerken

Hier volgt een voorbeeld van een abonnementsaanvraag maken die naar een factureringsadapter wordt verzonden. De HTTP-antwoordcode die de factureringsadapter verzendt, moet 204 zijn om goedkeuring te vertegenwoordigen of 403 om weigering van de aanvraag aan te geven.

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"
}

Als de factureringsadapter een gebeurtenis ontvangt en een foutbericht retourneert, wordt de gebeurtenis niet voltooid in de Service Management-API. Als dit niet het verwachte gedrag is, moet de factureringsadapter een statuscode van 200 terugsturen voor elke gebeurtenismelding en eventuele fouten registreren voor latere verwerking. Onbekende gebeurtenissen die worden ontvangen, moeten resulteren in een 200-statuscode die wordt geretourneerd.

Zie ook

De Windows Azure Pack Usage Service configureren
Een factureringsadapter implementeren