Udostępnij za pośrednictwem

Obsługa żądań zatwierdzenia rozliczeń

  • Artykuł

 

Dotyczy: Windows Azure Pack

Gdy dzierżawa Windows Azure Pack tworzy lub usuwa dodatek subskrypcji lub subskrypcji, może być konieczne zatwierdzenie lub odmowa żądania w zależności od praktyk biznesowych dostawcy usług hostingowych. Windows Pakiet Azure Pack definiuje interfejsy REST służące do zatwierdzania subskrypcji i dodawania subskrypcji do tworzenia i usuwania. Są one implementowane przez kartę rozliczeniową i po zarejestrowaniu są wywoływane za każdym razem, gdy dzierżawa tworzy lub usuwa dodatek subskrypcji lub subskrypcji. Kod odpowiedzi HTTP wskazuje, czy żądana operacja jest zatwierdzona, czy nie. Liczba wyższa lub równa 400 jest odrzucana; Akceptowana jest liczba niższa niż 400. Zawartość treści odpowiedzi jest ignorowana.

Punkt końcowy interfejsu API REST zatwierdzania rozliczeń

Poniżej przedstawiono interfejs API REST zatwierdzania rozliczeń, który musi zaimplementować karta rozliczeniowa:

Jeśli zarejestrowano je jako obowiązkowe lub rozliczane, wywołania REST są blokowane i będą wysyłane jako powiadomienia o żądaniach w czasie rzeczywistym do dowolnego rejestrującego ustawienia NotificationSubscribers w usłudze użycia. Stan zdarzenia powiadomienia będzie mieć stan oczekiwania na zatwierdzenie. W zależności od odpowiedzi wszystkich blokujących subskrybentów operacja zostanie zatwierdzona lub odrzucona. Jeśli nie zarejestrowano żadnych blokujących subskrybentów, zdarzenie zostanie automatycznie zatwierdzone i zostanie ustawione na potwierdzony stan i uwidoczniony za pośrednictwem interfejsu API REST usługi użycia. Aby uzyskać więcej informacji na temat typów subskrypcji obowiązkowych i rozliczeniowych, Konfigurowanie Windows usługi Użycia pakietu Azure Pack.

Rzeczywisty sygnał zatwierdzania tych operacji w systemie rozliczeniowym będzie ujawniany w interfejsie API REST, niezależnie od tego, czy jest zarejestrowany jako subskrybent powiadomień, czy nie; nie należy podejmować żadnych działań na żądaniach wysyłanych za pośrednictwem tego interfejsu API, ponieważ są to tylko żądania.

Ważne

Wersja Windows Azure Pack RTM uwidacznia zdarzenia aktualizacji subskrypcji w interfejsie API zatwierdzania rozliczeń w czasie rzeczywistym, a wszystkie rejestry tej usługi będą musiały automatycznie zatwierdzić te zdarzenia.

Aby uzyskać więcej informacji na temat rejestrowania punktu końcowego interfejsu API REST zatwierdzania rozliczeń, zobacz Konfigurowanie Windows usługi Użycia pakietu Azure Pack.

Uwierzytelnianie żądania zatwierdzenia

Interfejs API REST zatwierdzania rozliczeń powinien wymagać co najmniej uwierzytelniania podstawowego.

Przetwarzanie żądania zatwierdzenia

Poniżej przedstawiono przykład żądania utworzenia subskrypcji wysłanego do karty rozliczeniowej. Kod odpowiedzi HTTP wysyłany przez kartę rozliczeń powinien wynosić 204, aby reprezentować zatwierdzenie lub 403, aby reprezentować odmowę żądania.

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

Jeśli karta rozliczeniowa odbierze zdarzenie i zwróci komunikat o błędzie, zdarzenie nie zostanie ukończone pomyślnie w interfejsie API zarządzania usługami. Jeśli nie jest to oczekiwane zachowanie, karta rozliczeniowa musi wysłać z powrotem kod stanu 200 dla każdego powiadomienia o zdarzeniu i powinien rejestrować wszelkie błędy na potrzeby późniejszego przetwarzania. Wszystkie odebrane nieznane zdarzenia powinny spowodować zwrócenie kodu stanu 200.

Zobacz też

Konfigurowanie usługi Windows Użycia pakietu Azure Pack
Implementowanie karty rozliczeniowej