Analisar a utilização do Azure Stack com medidores de utilização locais – Modular Data Center (MDC)

Informações sobre as subscrições que utilizam os recursos armazenados numa base de dados de utilização local. Os administradores podem obter estes dados para analisar que utilizadores estão a consumir recursos.

Referência de chamada à API

Pedir

O pedido obtém detalhes de consumo para as subscrições pedidas e para o período de tempo pedido. Não há corpo do pedido.

Esta API de utilização é uma API de fornecedor, pelo que o autor da chamada tem de ter uma função de Proprietário, Contribuidor ou Leitor na subscrição do fornecedor.

Método URI do pedido
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 Description
armendpoint O Azure Resource Manager ponto final do ambiente do Azure Stack. A convenção do Azure Stack é que o nome do ponto final Resource Manager do Azure está no formato https://adminmanagement.{domain-name}.
subId ID da subscrição do utilizador que efetua a chamada.
reportedStartTime Hora de início da consulta. O valor para DateTime deve estar em Hora Universal Coordenada (UTC) e no início da hora; por exemplo, 13:00. Para agregação diária, defina este valor como UTC à meia-noite. O formato escapou do ISO 8601; por exemplo, 2015-06-16T18%3a53%3a11%2b00%3a00Z, para %3a onde os dois pontos são escapados e o sinal de adição é escapado para %2b que seja compatível com URI.
reportedEndTime Hora de fim da consulta. As restrições que se aplicam a reportedStartTime este argumento também se aplicam. O valor para reportedEndTime não pode ser no futuro nem na data atual. Se for, o resultado está definido como "o processamento não está concluído".
aggregationGranularity Parâmetro opcional que tem dois valores potenciais discretos: diariamente e por hora. Como os valores sugerem, um devolve os dados em granularidade diária e o outro é uma resolução por hora. A opção diária é a predefinição.
subscriberId ID da Subscrição. Para obter dados filtrados, é necessário o ID de subscrição de um inquilino direto do fornecedor. Se não for especificado nenhum parâmetro de ID de subscrição, a chamada devolve dados de utilização para todos os inquilinos diretos do fornecedor.
api-version Versão do protocolo utilizado para efetuar este pedido. Este valor está definido como 2015-06-01-preview.
continuationToken Token obtido da última chamada ao fornecedor de API de utilização. Este token é necessário quando uma resposta é superior a 1000 linhas. Funciona como um marcador para o progresso. Se o token não estiver presente, os dados são obtidos a partir do início do dia ou hora, com base na granularidade transmitida.

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 Description
id ID exclusivo da agregação de utilização.
name Nome da agregação de utilização.
type Definição de recurso.
subscriptionId Identificador de subscrição do utilizador do Azure Stack.
usageStartTime Hora de início utc do registo de utilização ao qual esta agregação de utilização pertence.
usageEndTime Hora de fim utc do registo de utilização ao qual esta agregação de utilização pertence.
instanceData Pares chave-valor de detalhes da instância (num novo formato):
resourceUri: ID de recurso completamente qualificado, que inclui os grupos de recursos e o nome da instância.
location: região na qual este serviço foi executado.
tags: etiquetas de recursos especificadas pelo utilizador.
additionalInfo: Mais detalhes sobre o recurso que foi consumido; por exemplo, a versão do SO ou o tipo de imagem.
quantity Quantidade de consumo de recursos que ocorreu neste período de tempo.
meterId ID exclusivo para o recurso que foi consumido (também denominado ResourceID).

Obter informações de utilização

PowerShell

Para gerar os dados de utilização, deve ter recursos que estão em execução e a utilizar ativamente o sistema; por exemplo, uma máquina virtual ativa (VM) ou uma conta de armazenamento que contenha alguns dados. Se não tiver a certeza se tem recursos em execução no marketplace do Azure Stack, implemente uma VM e verifique o painel de monitorização da VM para se certificar de que está em execução. Utilize os seguintes cmdlets do PowerShell para ver os dados de utilização.

  1. Instale o PowerShell para o Azure Stack.

  2. Configure o utilizador do Azure Stack ou o ambiente do PowerShell do operador do Azure Stack .

  3. Para obter os dados de utilização, chame o cmdlet Get-AzsSubscriberUsage do PowerShell:

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

API REST

Pode recolher informações de utilização para subscrições eliminadas ao chamar Microsoft.Commerce. Administração serviço.

Devolver toda a utilização do inquilino para eliminados para utilizadores ativos

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

Devolver a utilização do inquilino eliminado ou ativo

Método URI do pedido
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