Zpracování dat událostí využití

Článek
08/24/2015

Platí pro: Windows Azure Pack

V Windows Azure Packu pro fakturační systém Windows Serveru se očekává, že data událostí využití týkající se správy předplatných, plánů a tak dále se použijí k výpočtu fakturačních údajů tenanta. K tomu používá fakturační adaptér fakturačního systému rozhraní REST API využití ke shromažďování dat o událostech využití a vytvoření databáze dat o využití použitelných pro potřeby fakturace.

Získání událostí využití

Koncový bod služby usage zveřejňuje rozhraní REST API pro vrácení fakturačních dat pro plány, doplňky plánu, plán služby, doplňky a předplatná. Pokud chcete například načíst události plánu, provede se volání rozhraní REST API načtení událostí plánu :

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

Text odpovědi vrátí seznam objektů UsageEvent (Usage Metering Object) obsahujících nedávné události plánu. Příklad:

[
  {
    "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"
  }
]

Další informace o dostupném rozhraní REST API využití najdete v tématu Windows referenční informace k rozhraní REST API o využití služby Využití sady Azure Pack.

Zpracování událostí využití

Pokud chcete získat přístup k datům událostí využití, použijte objekt UsageEvent (Usage Metering Object) vrácený rozhraním REST API služby využití. Oznámení událostí odeslaná na fakturační adaptér odpovídají typu – UsageEvent (Usage Metering Object)<T> typem, kde T je nahrazen jedním z následujících objektů.

Plánování
PlanAddon
AdminSubscription
ResourceProviderReference
PlanAddonReference

Objekt UsageEvent obsahuje informace o entitě události, jako je plán a předplatné, typ operace, jako je vytvoření nebo odstranění, a aktuální stav operace. Následující tabulka popisuje, jaké akce se mají provést v fakturačním adaptéru pro každý stav kombinace:

Událost/operace	Vytvoření (POST)	Aktualizace (PUT)	Odstranit
Plány	Zpracování všech událostí	Ignorovat	Ignorovat (ruční)
Plánování doplňků	Zpracování všech událostí	Ignorovat	Ignorovat (ruční)
Plánování služeb	Zpracování všech událostí	Ignorovat	Ignorovat (ruční)
Doplňky	Zpracování všech událostí	Ignorovat	Ignorovat (ruční)
Doplňkové služby	Zpracování všech událostí	Ignorovat	Ignorovat (ruční)
Předplatná	událostí potvrzených událostí	Zpracování událostí Čeká na schválení a Potvrzeno	Zpracování událostí potvrzených
Doplňky předplatného	proces "potvrzené" události, včetně "duplicitních" událostí*	Ignorovat	Zpracování událostí potvrzených

Významné vlastnosti UsageEvent pro zpracování výše uvedené tabulky:

Entita

Obsahuje objekt, na který se pracuje. Například AdminSubscription (objekt správce) pro předplatné.

Metoda

Typ operace, jako je POST, PUT nebo DELETE.

Stav

Aktuální stav operace.

Hodnota	Popis
0	Potvrzeno
1	Zamítnuto
2	Čeká na schválení
3	Schválené

U některých výše uvedených operací může dojít k duplicitním událostem. Například událost "odstranit plán" může nastat dvakrát v řádku se stejnými daty, protože operace může selhat. Pro událost "vytvořit doplněk předplatného" má tenant možnost zakoupit stejný doplněk vícekrát (pokud je nakonfigurovaný tímto způsobem), takže každá událost vytvoření by měla být zpracována tak, aby byla výsledkem vytvoření nové entity v fakturačním systému. U všech ostatních operací vytváření by se duplicitní vytváření nemělo vytvořit ve fakturačním systému (tj. pokud už entita existuje, nevytvořte jinou) a je možné je bezpečně ignorovat.

Mapování entit mezi sadami Azure Pack Windows a fakturačním systémem

Fakturační adaptér by měl vytvořit entity v fakturačním systému s názvy, které odpovídají identifikátoru odeslanému z Windows Azure Packu. Správce tak může korelovat, které entity v Windows Azure Pack odpovídají entitám ve fakturačním systému. Pokud fakturační systém tuto funkci nepodporuje, bude muset fakturační adaptér udržovat informace o mapování, aby přeložil identifikátory používané Windows Azure Pack do identifikátorů používaných fakturačním systémem. Z tohoto důvodu by měl fakturační adaptér mít nějaký mechanismus, který zveřejňuje tyto informace o mapování správci zabezpečeným způsobem, aby bylo možné vyřešit případné nesrovnalosti nebo nejistoty.

Zpracování předplatných

Události předplatného se vytvářejí za následujících okolností:

Když je předplatné aktivované nebo pozastavené.
Při migraci předplatného

Pozastavení předplatného

Důležité

Pozastavení předplatného, jak je popsáno tady, nebude k dispozici až do příští verze aktualizace Windows Azure Packu. V aktuálním buildu RTM není možné prostřednictvím tohoto rozhraní rozpoznat pozastavení předplatného a aktivaci. Z pohledu fakturačního systému by se měly ignorovat události aktualizace předplatného, které se nedají provádět.

Pokud se předplatné pozastaví v Windows Azure Packu a tím zakáže tenantovi zřídit nové prostředky nebo přistupovat k existujícím prostředkům pomocí pozastaveného předplatného, tato změna se rozšíří do fakturačního systému prostřednictvím události aktualizace předplatného. Objekt předplatného AdminSubscription (objekt správce) má vlastnost stavu, která označuje, jestli je předplatné aktivní nebo pozastavené. Pokud správce pozastaví předplatné uživatele, měl by v fakturačním systému provést příslušná opatření, aby se zabránilo nevhodným poplatkům uživateli. Upozorňujeme, že stávající prostředky uživatele, jako jsou databáze, weby a virtuální počítače, se neodstraní; Odebere se přístup pouze k nim tenantovi. Protože uživatelé můžou mít více předplatných, je také možné, že jedno z předplatných uživatele může být pozastaveno, zatímco zbytek zůstane aktivní. Pozastavení na úrovni uživatele by nemělo nastat ve fakturačním systému, pokud nebyla pozastavena všechna předplatná v Windows sadě Azure Pack přidružená k sadě Azure Pack.

Migrace předplatného

Při zahájení migrace předplatného v Windows Azure Packu se událost zobrazí v rozhraní REST API služby Usage Service jako událost aktualizace předplatného, která obsahuje identifikátor plánu nového plánu, na který odkazuje předplatné. Aby bylo možné to zjistit, bude muset fakturační adaptér sledovat identifikátor plánu WAP každého předplatného, aby mohl tuto změnu zjistit a provést příslušnou akci ve fakturačním systému. Kromě toho je potřeba odstranit všechny doplňky předplatného, které byly dříve přidružené k migrovanému předplatnému, v fakturačním systému; tyto doplňky se odeberou v Windows Azure Packu a jejich navýšení kvóty se integruje do kvót nového plánu.

Viz také

Windows referenční informace k rozhraní REST API využití sady Azure Pack

Sdílet prostřednictvím