Tratamento de Pedidos de Aprovação de Faturação
Aplica-se a: Windows Azure Pack
Quando um inquilino Windows Azure Pack cria ou elimina um complemento de subscrição ou subscrição, pode ser necessário aprovar ou negar o pedido dependendo das práticas comerciais de faturação do anfitrião. Windows Azure Pack define interfaces REST para aprovação de subscrição e subscrição de criação e eliminação. Estes são implementados por um adaptador de faturação e uma vez registados são chamados sempre que um inquilino cria ou elimina um complemento de subscrição ou subscrição. O código resposta HTTP indica se a operação solicitada é ou não aprovada. Um número superior ou igual a 400 é negado; Um número inferior a 400 é aceite. O conteúdo do corpo de resposta é ignorado.
Aprovação de faturação REST API Endpoint
Segue-se a API DE APROVAÇÃO de Faturação que um adaptador de faturação precisa de implementar:
Se registadas como Obrigatórias ou Como Faturação, as chamadas REST estão a bloquear e serão enviadas como notificações de pedido em tempo real a qualquer registo da definição de Subscrições de Notificações no Serviço de Utilização. O estado do evento de notificação estará pendente de aprovação. Dependendo da resposta(s) de quaisquer assinantes que bloqueiem, a operação será aprovada ou rejeitada. Se não houver assinantes que bloqueiem, o evento será aprovado automaticamente e será definido para o estado reconhecido e exposto através da API do Serviço de Utilização. Para obter mais informações sobre os tipos de subscrição obrigatória e de faturação, configurar o serviço de utilização do pacote Windows Azure.
O sinal real para a entrega destas operações ao Sistema de Faturação serão os eventos expostos na API REST, registados ou não como assinante de notificação; não devem ser tomadas medidas em cima dos pedidos enviados através desta API, uma vez que são apenas pedidos.
Importante
O Windows versão Azure Pack RTM expõe eventos de atualização de subscrição na API de aprovação de faturação em tempo real e quaisquer registradores desse serviço terão de aprovar esses eventos automaticamente.
Para obter mais informações sobre o registo do ponto final da API de aprovação de faturação, consulte configurar o serviço de utilização do pacote Windows Azure.
Autenticação de um Pedido de Aprovação
A API de Aprovação de Faturação deve exigir pelo menos a autenticação básica.
Processamento de um Pedido de Aprovação
Segue-se um exemplo de um pedido de subscrição de criação enviado a um adaptador de faturação. O código de resposta HTTP que o adaptador de faturação envia deve ser 204 para representar a aprovação ou 403 para representar a negação do pedido.
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"
}
Se o adaptador de faturação receber um evento e devolver uma mensagem de erro, o evento não será concluído com sucesso na API de Gestão de Serviços. Se este não for o comportamento esperado, o Adaptador de Faturação deve enviar de volta um código de estado de 200 para cada notificação do evento e deve registar quaisquer falhas para posterior processamento. Quaisquer eventos desconhecidos que sejam recebidos devem resultar na devolvição de um código de estado de 200.
Consulte também
Configurar o serviço de utilização do pacote Windows Azure Pack
Implementação de um adaptador de faturação