Sdílet prostřednictvím

Zpracování žádostí o schválení fakturace

  • Článek

 

Platí pro: Windows Azure Pack

Když tenant sady Azure Pack Windows vytvoří nebo odstraní doplněk předplatného nebo předplatného, může být potřeba žádost schválit nebo odepřít v závislosti na obchodních postupech fakturace hostitele. Windows Azure Pack definuje rozhraní REST pro schvalování vytváření a odstraňování doplňků předplatného a předplatného. Jsou implementovány fakturačním adaptérem a po registraci se volají pokaždé, když tenant vytvoří nebo odstraní doplněk předplatného nebo předplatného. Kód odpovědi HTTP označuje, jestli je požadovaná operace schválena, nebo ne. Číslo vyšší nebo rovno 400 je odepřeno; Akceptuje se číslo nižší než 400. Obsah textu odpovědi se ignoruje.

Koncový bod rozhraní REST API pro schválení fakturace

Následuje rozhraní REST API pro schválení fakturace, které musí fakturační adaptér implementovat:

Pokud jsou zaregistrovaná jako povinná nebo fakturační, volání REST se blokují a budou odeslána jako oznámení o žádostech v reálném čase všem registrátorům nastavení NotificationSubscribers ve službě využití. Stav události oznámení bude čekající na schválení. V závislosti na odpovědích všech blokujících odběratelů bude operace schválena nebo odmítnuta. Pokud nejsou zaregistrovaní žádní blokující odběratelé, událost se automaticky schválí a nastaví se na potvrzený stav a zobrazí se prostřednictvím rozhraní REST API služby využití. Další informace o typech povinných a fakturačních předplatných najdete v tématu Konfigurace služby Windows využití sady Azure Pack.

Skutečný signál k potvrzení těchto operací do fakturačního systému bude vystavený v rozhraní REST API bez ohledu na to, jestli je zaregistrovaný jako odběratel oznámení, nebo ne; Na žádostech odeslaných přes toto rozhraní API by se neměla provádět žádná akce, protože se jedná pouze o žádosti.

Důležité

Verze Windows Azure Pack RTM zveřejňuje události aktualizace předplatného v rozhraní API pro schvalování fakturace v reálném čase a všechny registry této služby budou muset tyto události automaticky schválit.

Další informace o registraci koncového bodu rozhraní REST API pro schválení fakturace najdete v tématu Konfigurace služby využití sady Azure Pack Windows.

Ověřování žádosti o schválení

Rozhraní REST API pro schvalování fakturace by mělo vyžadovat alespoň základní ověřování.

Zpracování žádosti o schválení

Následuje příklad žádosti o vytvoření předplatného odeslané na fakturační adaptér. Kód odpovědi HTTP, který fakturační adaptér odesílá, by měl být 204, aby představoval schválení nebo 403, aby představoval odepření požadavku.

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

Pokud fakturační adaptér obdrží událost a vrátí chybovou zprávu, událost nebude úspěšně dokončena v rozhraní API pro správu služeb. Pokud se nejedná o očekávané chování, musí fakturační adaptér odeslat zpět stavový kód 200 pro každé oznámení událostí a protokolovat případné chyby pro pozdější zpracování. Všechny přijaté neznámé události by měly mít za následek vrácení stavového kódu 200.

Viz také

Konfigurace služby Windows využití sady Azure Pack
Implementace fakturačního adaptéru