Analisar o uso de Azure Stack com medidores de uso local – um Data Center modular (MDC)

Informações sobre quais assinaturas usam quais recursos são armazenados em um banco de dados de uso local. Os administradores podem recuperar esses dados para analisar quais usuários estão consumindo recursos.

Referência de chamada à API

Solicitação

A solicitação Obtém detalhes de consumo para as assinaturas solicitadas e para o período de tempo solicitado. Não há corpo de solicitação.

Essa API de uso é uma API de provedor, portanto, o chamador deve receber uma função de proprietário, colaboradorou leitor na assinatura do provedor.

Método URI da solicitação
GET https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={reportedStartTime}&reportedEndTime={reportedEndTime}&aggregationGranularity={granularity}&subscriberId={sub1.1}&api-version=2015-06-01-preview&continuationToken={token-value}

Argumentos

Argumento Descrição
armendpoint Azure Resource Manager ponto de extremidade de seu ambiente de Azure Stack. A Convenção de Azure Stack é que o nome do ponto de extremidade de Azure Resource Manager está no formato https://adminmanagement.{domain-name} .
subId ID da assinatura do usuário que faz a chamada.
reportedStartTime Hora de início da consulta. O valor de DateTime deve estar em UTC (tempo Universal Coordenado) e no início da hora; por exemplo, 13:00. Para agregação diária, defina esse valor como meia-noite UTC. O formato é ISO 8601 de escape; por exemplo, 2015-06-16T18%3a53%3a11%2b00%3a00Z em que os dois pontos são ignorados %3a e o sinal de mais é ignorado para %2b que seja amigável para URI.
reportedEndTime Hora de término da consulta. As restrições que se aplicam a reportedStartTime também se aplicam a esse argumento. O valor de reportedEndTime não pode ser no futuro ou na data atual. Se for, o resultado será definido como "processamento não concluído".
aggregationGranularity Parâmetro opcional que tem dois valores potenciais discretos: diariamente e por hora. Como os valores sugerem, um retorna os dados na granularidade diária e o outro é uma resolução por hora. A opção diário é o padrão.
subscriberId ID da assinatura. Para obter dados filtrados, é necessária a ID de assinatura de um locatário direto do provedor. Se nenhum parâmetro de ID de assinatura for especificado, a chamada retornará dados de uso para todos os locatários diretos do provedor.
api-version Versão do protocolo usado para fazer esta solicitação. Esse valor é configurado para 2015-06-01-preview.
continuationToken Token recuperado da última chamada para o provedor de API de uso. Esse token é necessário quando uma resposta é maior que 1.000 linhas. Ele atua como um indicador do progresso. Se o token não estiver presente, os dados serão recuperados do início do dia ou da hora, com base na granularidade passada.

Resposta

GET
/subscriptions/sub1/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime=reportedStartTime=2014-05-01T00%3a00%3a00%2b00%3a00&reportedEndTime=2015-06-01T00%3a00%3a00%2b00%3a00&aggregationGranularity=Daily&subscriberId=sub1.1&api-version=1.0
{
"value": [
{

"id":
"/subscriptions/sub1.1/providers/Microsoft.Commerce.Admin/UsageAggregate/sub1.1-

meterID1",
"name": "sub1.1-meterID1",
"type": "Microsoft.Commerce.Admin/UsageAggregate",

"properties": {
"subscriptionId":"sub1.1",
"usageStartTime": "2015-03-03T00:00:00+00:00",
"usageEndTime": "2015-03-04T00:00:00+00:00",
"instanceData":"{\"Microsoft.Resources\":{\"resourceUri\":\"resourceUri1\",\"location\":\"Alaska\",\"tags\":null,\"additionalInfo\":null}}",
"quantity":2.4000000000,
"meterId":"meterID1"

}
},

. . .

Detalhes da resposta

Argumento Descrição
id ID exclusiva da agregação de uso.
name Nome da agregação de uso.
type Definição de recurso.
subscriptionId Identificador de assinatura do usuário Azure Stack.
usageStartTime Hora de início UTC do Bucket de uso ao qual essa agregação de uso pertence.
usageEndTime Hora de término UTC do Bucket de uso ao qual essa agregação de uso pertence.
instanceData Pares de chave-valor dos detalhes da instância (em um novo formato):
resourceUri: ID de recurso totalmente qualificado, que inclui os grupos de recursos e o nome da instância.
location: Região em que este serviço foi executado.
tags: Marcas de recurso que são especificadas pelo usuário.
additionalInfo: Mais detalhes sobre o recurso que foi consumido; por exemplo, a versão do sistema operacional ou o tipo de imagem.
quantity Quantidade de consumo de recursos que ocorreu neste intervalo de tempo.
meterId ID exclusiva para o recurso que foi consumido (também chamado ResourceID ).

Recuperar informações de uso

PowerShell

Para gerar os dados de uso, você deve ter recursos que estão executando e usando ativamente o sistema; por exemplo, uma VM (máquina virtual) ativa ou uma conta de armazenamento que contém alguns dados. Se você não tiver certeza se tem algum recurso em execução no Azure Stack Marketplace, implante uma VM e verifique a folha de monitoramento da VM para verificar se ela está em execução. Use os cmdlets do PowerShell a seguir para exibir os dados de uso.

  1. Instale o PowerShell para Azure Stack.

  2. Configure o Azure Stack usuário ou o ambiente do PowerShell do operador de Azure Stack .

  3. Para recuperar os dados de uso, chame o cmdlet Get-AzsSubscriberUsage do PowerShell:

    Get-AzsSubscriberUsage -ReportedStartTime "2017-09-06T00:00:00Z" -ReportedEndTime "2017-09-07T00:00:00Z"
    

API REST

Você pode coletar informações de uso para assinaturas excluídas chamando o serviço Microsoft. Commerce. admin.

Retornar todo o uso de locatário para excluído para usuários ativos

Método URI da solicitação
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview

Uso de retorno para o locatário excluído ou ativo

Método URI da solicitação
GET https://{armendpoint}/subscriptions/{subId}/providersMicrosoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&subscriberId={subscriber-id}&api-version=2015-06-01-preview