Analise o uso da Pilha Azure com medidores de utilização locaisAnalyze Azure Stack usage with local usage meters

Informações sobre quais as assinaturas que utilizam quais os recursos armazenados numa base de dados de utilização local.Information about which subscriptions use which resources is stored in a local usage database. Os administradores podem recuperar estes dados para analisar quais os utilizadores que estão a consumir recursos.Administrators can retrieve this data to analyze which users are consuming resources.

Referência de chamada da APIAPI call reference

PedirRequest

O pedido obtém detalhes de consumo para as subscrições solicitadas e para o prazo solicitado.The request gets consumption details for the requested subscriptions and for the requested time frame. Não há nenhum corpo de pedido.There's no request body.

Esta API de utilização é um fornecedor API, pelo que o chamador deve ser atribuído a um papel de Proprietário, Contribuinte ou Leitor na subscrição do fornecedor.This usage API is a provider API, so the caller must be assigned an Owner , Contributor , or Reader role in the provider's subscription.

MétodoMethod URI do pedidoRequest URI
GETGET 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}

ArgumentosArguments

ArgumentoArgument DescriptionDescription
armendpoint Ponto final do Azure Resource Manager do seu ambiente Azure Stack.Azure Resource Manager endpoint of your Azure Stack environment. A convenção Azure Stack é que o nome do ponto final do Gestor de Recursos Azure está no formato https://adminmanagement.{domain-name} .The Azure Stack convention is that the name of the Azure Resource Manager endpoint is in the format https://adminmanagement.{domain-name}.
subId ID de assinatura do utilizador que faz a chamada.Subscription ID of the user who makes the call.
reportedStartTime Hora de início da consulta.Start time of the query. O valor DateTime para deve ser no Tempo Universal Coordenado (UTC) e no início da hora; por exemplo, às 13:00.The value for DateTime should be in Coordinated Universal Time (UTC) and at the beginning of the hour; for example, 13:00. Para agregação diária, desagreje este valor para a meia-noite da UTC.For daily aggregation, set this value to UTC midnight. O formato é escapado ISO 8601; por 2015-06-16T18%3a53%3a11%2b00%3a00Z exemplo, onde o cólon é escapado %3a e o mais é escapado para que seja %2b uri-friendly.The format is escaped ISO 8601; for example, 2015-06-16T18%3a53%3a11%2b00%3a00Z, where the colon is escaped to %3a and the plus is escaped to %2b so that it's URI-friendly.
reportedEndTime Fim da consulta.End time of the query. Os constrangimentos que se aplicam reportedStartTime também a este argumento.The constraints that apply to reportedStartTime also apply to this argument. O valor para reportedEndTime não pode ser no futuro, ou na data atual.The value for reportedEndTime can't be either in the future, or the current date. Se for, o resultado está definido para "processamento não completo".If it is, the result is set to "processing not complete."
aggregationGranularity Parâmetro opcional que tem dois valores potenciais discretos: diariamente e por hora.Optional parameter that has two discrete potential values: daily and hourly. Como os valores sugerem, um devolve os dados em granularidade diária, e o outro é uma resolução de hora a hora.As the values suggest, one returns the data in daily granularity, and the other is an hourly resolution. A opção diária é o padrão.The daily option is the default.
subscriberId ID de assinatura.Subscription ID. Para obter dados filtrados, é necessário o ID de subscrição de um inquilino direto do fornecedor.To get filtered data, the subscription ID of a direct tenant of the provider is required. Se não for especificado nenhum parâmetro de identificação por subscrição, a chamada devolve os dados de utilização de todos os inquilinos diretos do fornecedor.If no subscription ID parameter is specified, the call returns usage data for all the provider's direct tenants.
api-version Versão do protocolo que é usado para fazer este pedido.Version of the protocol that's used to make this request. Este valor está definido para 2015-06-01-preview .This value is set to 2015-06-01-preview.
continuationToken Token recuperado da última chamada para o fornecedor de API de uso.Token retrieved from the last call to the usage API provider. Este símbolo é necessário quando uma resposta é superior a 1.000 linhas.This token is needed when a response is greater than 1,000 lines. Funciona como um marcador para o progresso.It acts as a bookmark for the progress. Se o símbolo não estiver presente, os dados são recuperados desde o início do dia ou hora, com base na granularidade transmitida.If the token isn't present, the data is retrieved from the beginning of the day or hour, based on the granularity passed in.

RespostaResponse

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 respostaResponse details

ArgumentoArgument DescriptionDescription
id ID único do agregado de uso.Unique ID of the usage aggregate.
name Nome do agregado de uso.Name of the usage aggregate.
type Definição de recursos.Resource definition.
subscriptionId Identificador de assinatura do utilizador Azure Stack.Subscription identifier of the Azure Stack user.
usageStartTime UTC hora de início do balde de uso ao qual este agregado de uso pertence.UTC start time of the usage bucket to which this usage aggregate belongs.
usageEndTime UTC fim de tempo do balde de uso ao qual este agregado de uso pertence.UTC end time of the usage bucket to which this usage aggregate belongs.
instanceData Pares de detalhes de exemplo de valor-chave (num novo formato):Key-value pairs of instance details (in a new format):
resourceUri: ID de recursos totalmente qualificado, que inclui os grupos de recursos e o nome da instância.resourceUri: Fully qualified resource ID, which includes the resource groups and the instance name.
location: Região em que este serviço foi gerido.location: Region in which this service was run.
tags: Etiquetas de recursos especificadas pelo utilizador.tags: Resource tags that are specified by the user.
additionalInfo: Mais detalhes sobre o recurso que foi consumido; por exemplo, a versão SO ou tipo de imagem.additionalInfo: More details about the resource that was consumed; for example, the OS version or image type.
quantity Quantidade de consumo de recursos que ocorreu neste período de tempo.Amount of resource consumption that occurred in this time frame.
meterId ID único para o recurso que foi consumido (também ResourceID chamado).Unique ID for the resource that was consumed (also called ResourceID).

Recuperar informações de utilizaçãoRetrieve usage information

PowerShellPowerShell

Para gerar os dados de utilização, deve ter recursos que estão a executar e a utilizar ativamente o sistema; por exemplo, uma máquina virtual ativa (VM), ou uma conta de armazenamento contendo alguns dados.To generate the usage data, you should have resources that are running and actively using the system; for example, an active virtual machine (VM), or a storage account containing some data. Se não tem a certeza se tem algum recursos a decorrer no mercado Azure Stack, implante um VM e verifique a lâmina de monitorização VM para se certificar de que está em funcionamento.If you're not sure whether you have any resources running in the Azure Stack marketplace, deploy a VM, and verify the VM monitoring blade to make sure it's running. Utilize os seguintes cmdlets PowerShell para visualizar os dados de utilização:Use the following PowerShell cmdlets to view the usage data:

  1. Instale o PowerShell para a pilha de Azure.Install PowerShell for Azure Stack.

  2. Configure o utilizador Azure Stack ou o ambiente PowerShell do operador Azure Stack.Configure the Azure Stack user or the Azure Stack operator PowerShell environment.

  3. Para recuperar os dados de utilização, ligue para o cmdlet Get-AzsSubscriberUsage PowerShell:To retrieve the usage data, call the Get-AzsSubscriberUsage PowerShell cmdlet:

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

API RESTREST API

Pode recolher informações de utilização para subscrições eliminadas, ligando para o serviço Microsoft.Commerce.Admin.You can collect usage information for deleted subscriptions by calling the Microsoft.Commerce.Admin service.

Devolva todo o uso do inquilino para eliminado para utilizadores ativosReturn all tenant usage for deleted for active users

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

Utilização de devolução para inquilino apagado ou ativoReturn usage for deleted or active tenant

MétodoMethod URI do pedidoRequest URI
GETGET 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