Recuperar o resumo de uso de uma assinatura

Artigo
08/24/2015

Aplica-se a: Windows Azure Pack

Chamado pela API de Gerenciamento de Serviços para recuperar um resumo dos dados de uso da assinatura gerados por um provedor de recursos. Essas informações podem ser usadas por um adaptador de cobrança para calcular os custos de cobrança. Para obter mais informações, consulte Windows Serviço de Uso do Azure Pack.

Solicitação

Substitua <NotificationEndpoint> pelo endereço do ponto de extremidade do Windows API REST de Notificação do Provedor de Recursos Personalizado do Azure Pack. Substitua <a ID> pelo identificador do resumo de uso a ser recuperado.

Método	URI da solicitação	Versão HTTP
GET	<http:// NotificationEndpoint>/subscriptions/<Id>/usagesummary	HTTP/1.1

Parâmetros de URI

Nenhum.

Cabeçalhos de solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Autorização: Básico	Obrigatórios. O token de autorização básico.
x-ms-principal-id	Obrigatórios. O identificador principal.
x-ms-client-request-id	Opcional. O identificador de solicitação do cliente.
x-ms-client-session-id	Opcional. O identificador de sessão do cliente.
x-ms-principal-liveid	Opcional. O principal identificador ao vivo.

Corpo da solicitação

Nenhum.

Resposta

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

Código de status

Uma operação bem-sucedida retorna o código de status 200 (OK).

Para obter informações sobre códigos de status, consulte Status e Códigos de Erro (Windows Gerenciamento de Serviços do Azure Pack).

Cabeçalhos de resposta

A resposta para essa operação inclui cabeçalhos HTTP padrão. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Corpo da resposta

A tabela a seguir descreve os principais elementos do corpo da resposta:

Nome do elemento	Descrição
ServiceUsageSummary	O resumo de uso recuperado. Para obter mais informações, consulte ServiceUsageSummary (Objeto de Ponto de Extremidade de Notificação).

Exemplo

O exemplo de código a seguir mostra uma solicitação Obter Resumo de Uso da Assinatura .

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 obter resumo de uso da assinatura .

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

  ]
}

Comentários

Ao chamar o TBD, a API de Gerenciamento de Serviço aguarda um minuto por uma resposta. Se nenhuma resposta for recebida, a assinatura será marcada como fora de sincronização.

Consulte Também

Windows referência da API REST de Notificação do Provedor de Recursos Personalizado do Azure Pack

Compartilhar via