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.
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:
Configurare l'utente dell'hub di Azure Stack o l'ambiente PowerShell dell'operatore hub di 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 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 |