Analizzare l'utilizzo di Azure Stack con i contatori di utilizzo locali

Articolo
07/12/2023

Informazioni sulle sottoscrizioni che usano le risorse archiviate in un database di utilizzo locale. Gli amministratori possono recuperare questi dati per analizzare quali utenti utilizzano le risorse.

Informazioni di riferimento sulle chiamate API

Richiesta

La richiesta ottiene i dettagli sull'utilizzo per le sottoscrizioni richieste e per l'intervallo di tempo richiesto. Non è presente alcun corpo della richiesta.

Questa API di utilizzo è un'API del provider, quindi al chiamante deve essere assegnato un ruolo Proprietario, Collaboratore o Lettore nella sottoscrizione del provider.

Metodo	URI richiesta
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}`

Argomenti

Argomento	Descrizione
`armendpoint`	Azure Resource Manager endpoint dell'ambiente Azure Stack. La convenzione di Azure Stack è che il nome dell'endpoint di Azure Resource Manager è nel formato `https://adminmanagement.{domain-name}`.
`subId`	ID sottoscrizione dell'utente che effettua la chiamata.
`reportedStartTime`	Ora di inizio della query. Il valore per `DateTime` deve essere espresso nel formato UTC (Coordinated Universal Time) e all'inizio dell'ora, ad esempio 13:00. Per l'aggregazione giornaliera, impostare questo valore su mezzanotte ora UTC. Il formato è preceduto da un carattere di escape ISO 8601; ad esempio, `2015-06-16T18%3a53%3a11%2b00%3a00Z`dove i due punti vengono preceduti `%3a` da un carattere di escape e il segno più viene preceduto da un carattere di escape in modo che sia descrittivo `%2b` per l'URI.
`reportedEndTime`	Ora di fine della query. I vincoli applicati a `reportedStartTime` si applicano anche a questo argomento. Il valore per `reportedEndTime` non può essere una data futura o la data corrente. Se lo è, il risultato indica un'elaborazione non completata.
`aggregationGranularity`	Parametro facoltativo con due valori potenziali discreti: giornaliero e orario. Come suggerito dai valori, uno restituisce i dati nella granularità giornaliera e l'altro è una risoluzione oraria. L'opzione giornaliera è l'impostazione predefinita.
`subscriberId`	l'ID sottoscrizione. Per ottenere dati filtrati, è necessario l'ID sottoscrizione di un tenant diretto del provider. Se non viene specificato alcun parametro per l'ID sottoscrizione, la chiamata restituisce i dati di utilizzo per tutti i tenant diretti del provider.
`api-version`	Versione del protocollo usato per effettuare questa richiesta. Questo valore è impostato su `2015-06-01-preview`.
`continuationToken`	Token recuperato dall'ultima chiamata al provider dell'API di utilizzo. Questo token è necessario quando una risposta contiene più di 1.000 righe. Funge da segnalibro per lo stato di avanzamento. Se il token non è presente, i dati vengono recuperati dall'inizio del giorno o dell'ora, in base alla granularità passata.

Risposta

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"

}
},

. . .

Dettagli della risposta

Argomento	Descrizione
`id`	ID univoco dell'aggregazione dell'utilizzo.
`name`	Nome dell'aggregazione dell'utilizzo.
`type`	Definizione della risorsa.
`subscriptionId`	Identificatore della sottoscrizione dell'utente di Azure Stack.
`usageStartTime`	Ora di inizio in formato UTC del bucket di utilizzo a cui appartiene questa aggregazione dell'utilizzo.
`usageEndTime`	Ora di fine in formato UTC del bucket di utilizzo a cui appartiene questa aggregazione dell'utilizzo.
`instanceData`	Coppie chiave-valore dei dettagli dell'istanza (in un nuovo formato): `resourceUri`: ID risorsa completo, che include i gruppi di risorse e il nome dell'istanza. `location`: area in cui è stato eseguito questo servizio. `tags`: tag di risorsa specificati dall'utente. `additionalInfo`: altre informazioni sulla risorsa utilizzata, ad esempio la versione del sistema operativo o il tipo di immagine.
`quantity`	Risorse utilizzate in questo intervallo di tempo.
`meterId`	ID univoco per la risorsa utilizzata (chiamata `ResourceID`anche ).

Recuperare le informazioni sull'utilizzo

PowerShell

Per generare i dati di utilizzo, è necessario disporre di risorse in esecuzione e attivamente che usano il sistema; ad esempio una macchina virtuale attiva o un account di archiviazione contenente alcuni dati. Se non si è certi che siano presenti risorse in esecuzione in Azure Stack Marketplace, distribuire una macchina virtuale e verificare il pannello monitoraggio della macchina virtuale per assicurarsi che sia in esecuzione. Usare i cmdlet di PowerShell seguenti per visualizzare i dati di utilizzo:

Installare PowerShell per Azure Stack.
Configurare l'utente di Azure Stack o l'ambiente PowerShell dell'operatore Azure Stack .

Per recuperare i dati di utilizzo, chiamare il cmdlet Get-AzsSubscriberUsage di PowerShell:

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

API REST

È possibile raccogliere informazioni sull'utilizzo per le sottoscrizioni eliminate chiamando Microsoft.Commerce. Amministrazione servizio.

Restituisce l'utilizzo di tutti i tenant per gli utenti attivi

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

Restituisce l'utilizzo per il tenant eliminato o attivo

Metodo	URI richiesta
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`