Condividi tramite


API di utilizzo delle risorse dei provider

Il provider di termini si applica all'amministratore del servizio e a tutti i provider delegati. Gli operatori dell'hub di Azure Stack e i provider delegati possono usare l'API di utilizzo del provider per visualizzare l'utilizzo dei tenant diretti. Ad esempio, come illustrato nel diagramma seguente, P0 può chiamare l'API del provider per ottenere informazioni sull'utilizzo diretto per P1 e P2, mentre P1 può chiamarlo per informazioni sull'utilizzo per P3 e P4.

Modello concettuale della gerarchia del provider

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 esiste alcun corpo della richiesta.

Questa API di utilizzo è un'API provider, quindi il chiamante deve essere assegnato a 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 Endpoint di Azure Resource Manager dell'ambiente dell'hub di Azure Stack. Secondo la convenzione dell'hub di Azure Stack il formato del nome dell'endpoint di Resource Manager di Azure è https://adminmanagement.{domain-name}. Ad esempio, per Azure Stack Development Kit (ASDK), se il nome di dominio è local.azurestack.external, l'endpoint di Resource Manager è https://adminmanagement.local.azurestack.external.
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 è escape ISO 8601; ad esempio, 2015-06-16T18%3a53%3a11%2b00%3a00Zdove i due punti vengono eliminati e il segno più viene eseguito %3a in %2b modo che sia descrittivo 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 oraria. 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 dell'hub 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 ResourceIDanche ).

Recuperare le informazioni sull'utilizzo

PowerShell

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

  1. Installare PowerShell per l'hub di Azure Stack.

  2. Configurare l'utente dell'hub di Azure Stack o l'ambiente PowerShell dell'operatore hub di Azure Stack .

  3. 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 il servizio Microsoft.Commerce.Amministrazione.

Restituisce tutto l'utilizzo del tenant per gli utenti attivi

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

Utilizzo restituito per il tenant eliminato o attivo

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

Passaggi successivi