Compartilhar via

Manipulando solicitações de aprovação de cobrança

  • Artigo

 

Aplica-se a: Windows Azure Pack

Quando uma Windows locatário do Azure Pack cria ou exclui um complemento de assinatura ou assinatura, pode ser necessário aprovar ou negar a solicitação dependendo das práticas comerciais de cobrança do host. Windows Pacote do Azure define interfaces REST para aprovar a criação e exclusão de complementos de assinatura e assinatura. Eles são implementados por um adaptador de cobrança e, uma vez registrados, são chamados sempre que um locatário cria ou exclui um complemento de assinatura ou assinatura. O código de resposta HTTP indica se a operação solicitada foi aprovada ou não. Um número maior ou igual a 400 é negado; Um número menor que 400 é aceito. O conteúdo do corpo da resposta é ignorado.

Ponto de extremidade da API REST de aprovação de cobrança

Veja a seguir a API REST de Aprovação de Cobrança que um adaptador de cobrança precisa implementar:

Se registrado como Obrigatório ou cobrança, as chamadas REST estão bloqueando e serão enviadas como notificações de solicitação em tempo real para todos os inscritos da configuração De Assinaturas de Notificação no Serviço de Uso. O estado do evento de notificação estará pendente de aprovação. Dependendo das respostas de todos os assinantes de bloqueio, a operação será aprovada ou rejeitada. Se nenhum assinante de bloqueio for registrado, o evento será aprovado automaticamente e será definido como o estado reconhecido e exposto por meio da API REST do Serviço de Uso. Para obter mais informações sobre tipos de assinatura obrigatórios e de cobrança, configure o Windows Serviço de Uso do Azure Pack.

O sinal real para confirmar essas operações no Sistema de Cobrança serão eventos expostos na API REST, registrados como assinante de notificação ou não; nenhuma ação deve ser executada nas solicitações enviadas por meio dessa API, pois elas são apenas solicitações.

Importante

O Windows versão rtm do Azure Pack expõe eventos de atualização de assinatura na API de Aprovação de Cobrança em tempo real e todos os inscritos desse serviço precisarão aprovar esses eventos automaticamente.

Para obter mais informações sobre como registrar o ponto de extremidade da API REST de Aprovação de Cobrança, consulte Configurar o Windows Serviço de Uso do Azure Pack.

Autenticando uma solicitação de aprovação

A API REST de Aprovação de Cobrança deve exigir pelo menos a Autenticação Básica.

Processando uma solicitação de aprovação

Veja a seguir um exemplo de uma solicitação de criação de assinatura enviada a um adaptador de cobrança. O código de resposta HTTP que o adaptador de cobrança envia deve ser 204 para representar a aprovação ou 403 para representar a negação da solicitação.

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 cobrança receber um evento e retornar uma mensagem de erro, o evento não será concluído com êxito na API de Gerenciamento de Serviços. Se esse não for o comportamento esperado, o Adaptador de Cobrança deverá enviar de volta um código de status 200 para cada notificação de evento e registrar todas as falhas para processamento posterior. Todos os eventos desconhecidos recebidos devem resultar no retorno de um código de status 200.

Consulte Também

Configurando o Windows Serviço de Uso do Azure Pack
Implementando um adaptador de cobrança