Compartilhar via

Pontos de extremidade do provedor de recursos personalizados

  • Artigo

 

Aplica-se a: Windows Azure Pack

Para integrar com Windows Azure Pack, há quatro pontos de extremidade que um provedor personalizado deve considerar.

Ponto de Extremidade do Administrador

O administrador é o endereço em que o Windows API REST do Gerenciamento de Serviços do Azure Pack envia solicitações da API do administrador. Esse também é o endereço em que a camada de API espera receber respostas às transações de administrador que esperam assinaturas e ofertas; essas transações são enviadas e tratadas pelo Ponto de Extremidade de Notificação.

Ponto de Extremidade do Locatário

O ponto de extremidade do locatário é o endereço em que a camada de API de Gerenciamento de Serviços envia todas as solicitações da API de Locatário. Esse também é o local em que a camada de API de Gerenciamento de Serviços espera receber respostas de transações de locatário.

A camada de API de Gerenciamento de Serviços serve como um proxy para traduzir as URIs de entrada do locatário em um formato que pode ser consumido pelo provedor de recursos personalizado. Durante o registro, o provedor de recursos personalizados tem a opção de especificar o modelo de conversão de origem e de destino para a camada de API de Gerenciamento de Serviços. Um mapeamento típico seria o seguinte:

Modelo de URI de origem do locatário

{subid}/services/sqlservers/{*path}

Modelo de URI de Destino de Locatário

{subid}/{*path}

Como alternativa, o provedor de recursos personalizado pode fornecer apenas o ponto de extremidade de destino e a camada de API de Gerenciamento de Serviços determinará automaticamente um padrão de tradução em regras definidas implicitamente.

Ponto de Extremidade de Notificação

O ponto de extremidade de notificação é usado para assinatura e ofertas relacionadas a transações. Quando um usuário se inscreve para um plano, a camada de API de Gerenciamento de Serviços registra o usuário enviando uma chamada fan-out para os pontos de extremidade de notificação para cada provedor de recursos no plano. Para dar suporte a essa e outras notificações, como a exclusão de uma assinatura, um provedor de recursos do cliente deve implementar a seguinte API REST:

  • Criar Assinatura

  • Obter assinatura

  • Obter resumo de uso da assinatura

  • Atualizar Assinatura

  • Excluir Assinatura

  • Atualizar Cota

  • Validar cota

  • Obter cota padrão

Para obter mais informações, consulte Windows Referência da API REST de Notificação do Provedor de Recursos Personalizado do Azure Pack

Ponto de Extremidade de Uso

O ponto de extremidade de uso é usado por um provedor de recursos para expor os dados de uso coletados pelo Windows Azure Pack para o coletor de uso do servidor Windows. Em seguida, os dados de uso podem ser usados para calcular os custos de cobrança para recursos usados por um cliente. Para obter informações sobre como criar um adaptador de cobrança, consulte Windows Serviço de Uso do Azure Pack.

O coletor de uso envia uma solicitação para o ponto de extremidade de uso em intervalos predeterminados com um identificador de registro específico e uma solicitação de tamanho de lote. Em troca, o provedor de recursos envia seus dados de uso.

O coletor de uso envia uma solicitação para o ponto de extremidade de uso no formato https://< usageendpoint>/uso. Portanto, a implementação do ponto de extremidade de uso deve expor uma pasta /use.

Uma solicitação de coletor de uso de exemplo é a seguinte:

https://<usageendpoint>/usage?lastID=23451&batchSize=100

Para obter mais informações, consulte Windows Referência da API REST de Uso do Provedor de Recursos Personalizado do Azure Pack

Consulte Também

Windows Provedores de Recursos Personalizados do Azure Pack
Windows Referência da API REST de Notificação do Provedor de Recursos Personalizado do Azure Pack
Windows Referência da API REST de Uso do Provedor de Recursos Personalizados do Azure Pack