Recuperar dados de utilização de um fornecedor de recursos
Aplica-se a: Windows Azure Pack
Recupera dados de utilização de um fornecedor de recursos.
Pedir
Substitua <o Ponto de UtilizaçãoEndpoint> pelo endereço de ponto final para o Windows utilização do Fornecedor de Recursos Personalizados Azure Pack REST API.
Método |
URI do pedido |
Versão HTTP |
|---|---|---|
GET |
<https:// UsageEndpoint>/utilização |
HTTP/1.1 |
Parâmetros do URI
A tabela seguinte descreve os parâmetros URI.
Parâmetro URI |
Description |
|---|---|
lastID |
A identificação do último registo recebido pelo colecionador de uso. O último parâmetroID está vazio para o primeiro pedido. Este é um reconhecimento de que o coletor de utilização reconhece os registos anteriores, podendo, portanto, eliminá-los. |
LotSize |
O número de novos registos para enviar ao colecionador de uso. Os novos registos são aqueles que seguem o registo identificado pelo último parâmetroID . O fornecedor de recursos pode enviar um lote menor do que o solicitado, mas não um maior. |
Pedido cabeçalhos
A tabela seguinte descreve os cabeçalhos de pedido necessários e opcionais.
Cabeçalho do pedido |
Description |
|---|---|
Autorização: Portador |
Obrigatório. O sinal do portador da autorização. |
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 |
Description |
|---|---|
EventId |
Obrigatório. Um identificador único que representa cada registo de utilização. Este valor corresponderá ao do último parâmetro URI ID. |
ResourceId |
Opcional. Se o fornecedor de recursos tiver múltiplos recursos para uma única subscrição e a utilização estiver a ser agregada um recurso, este campo pode ser utilizado para especificar o nome do recurso. Se a utilização estiver a ser agregada por ID de assinatura, este elemento não é utilizado. |
StartTime |
Obrigatório. Indica quando a recolha de dados de utilização começou. |
EndTime |
Obrigatório. Indica quando a recolha de dados de utilização terminou. |
ServiceType |
Obrigatório. O nível de serviço consumido. |
SubscriptionId |
Obrigatório. O identificador de subscrição para o qual os dados de utilização foram recolhidos. (GUID). |
Propriedades |
Opcional. Um dicionário de pares de valor-nome usado para passar qualquer informação adicional sobre o uso. |
Recursos |
Obrigatório. Um dicionário de pares de valor-nome que representa os recursos atribuídos ou consumidos. Por exemplo, um fornecedor de recursos SQL pode ter o espaço total e a contagem de bases de dados como as suas métricas. |
Observações
Recuperar dados de utilização de um Fornecedor de Recursos é chamado periodicamente pelo Colecionador de Utilização para recolher as informações de utilização do fornecedor de recursos. Estas informações podem ser usadas para gerar custos de faturação para o uso do fornecedor de recursos. Para mais informações, os pontos finais do fornecedor de recursos personalizados. Para obter mais informações sobre o serviço de utilização do pacote Windows Azure Pack, consulte Windows Serviço de Utilização do Pacote Azure.
Consulte também
Windows Azure Pack Custom Resource Provider Usage API Reference