Recuperar o Resumo de Utilização para uma Subscrição

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Chamado pela API de Gestão de Serviços para recuperar um resumo dos dados de utilização da subscrição gerados por um fornecedor de recursos. Estas informações podem ser utilizadas por um adaptador de faturação para calcular os custos de faturação. Para mais informações, consulte Windows Serviço de Utilização do Pacote Azure.

Pedir

Substitua <o Ponto de NotificaçãoEndpoint> pelo endereço de ponto final para o Windows Azure Pack Custom Resource Provider Notification REST API. Substitua <o ID> pelo identificador do resumo de utilização a recuperar.

Método	URI do pedido	Versão HTTP
GET	<http:// NotificationEndpoint>/subscrições/<Id>/usagesummary	HTTP/1.1

Parâmetros do URI

Nenhum.

Pedido cabeçalhos

A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.

Cabeçalho do pedido	Description
Autorização: Básico	Obrigatório. O sinal de autorização básica.
x-ms-principal-id	Obrigatório. O identificador principal.
x-ms-cliente-pedido-id	Opcional. O identificador de pedido do cliente.
x-ms-cliente-sessão-id	Opcional. O identificador da sessão do cliente.
x-ms-principal-liveid	Opcional. O principal identificador ao vivo.

Corpo do Pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Código de Estado

Uma operação bem sucedida devolve o código de estado 200 (OK).

Para obter informações sobre códigos de estado, consulte Códigos de Estado e de Erro (Windows Gestão de Serviços de Pacote Azure).

Cabeçalhos de Resposta

A resposta para esta operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos standard estão de acordo com a especificação do protocolo HTTP/1.1.

Corpo de Resposta

A tabela a seguir descreve os elementos-chave do organismo de resposta:

Nome do elemento	Descrição
ServiçoUsageSummary	O resumo de utilização recuperado. Para mais informações, consulte ServiceUsageSummary (Notification Endpoint Object).

Exemplo

O seguinte exemplo de código mostra um pedido de Utilização de Assinatura Obter .

GET https://<NotificationEndpoint>/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummary HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummaries
Accept: application/json
Accept-Language: en-US
x-ms-client-request-id: 82610bdb-14d6-4e2a-99a0-9930d879b300-2013-07-25 06:14:56Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 37739ad5c7ab4654b6bb5d5e211f974e.2013-07-25T06:14:57.7649169Z
Authorization: Basic <encoded username and password>
Host: <Computer>:30010

O exemplo de código a seguir mostra uma resposta JSON do Resumo do Uso da Subscrição .

{
  "ServiceName": "SqlServer",
  "ServiceDisplayName": "Sql Server",
  "RetrievedSuccessfully": false,
  "ErrorMessage": null,
  "Usages": [

  ]
}

Observações

Ao ligar para a TBD, a API de Gestão de Serviços aguarda um minuto para obter uma resposta. Se não for recebida qualquer resposta, a subscrição está marcada como estando fora de sincronização.

Consulte também

Windows Azure Pack Custom Resource Provider Notification API Reference

Partilhar via