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.
Configure o utilizador do Azure Stack ou o ambiente do PowerShell do operador do Azure Stack .
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 |
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários