Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il termine provider si applica all'amministratore del servizio e a qualsiasi provider delegato. 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. Nessun corpo richiesta.
Questa API di utilizzo è un'API del provider, pertanto al chiamante deve essere assegnato un ruolo Proprietario, Collaboratore o Lettore nella sottoscrizione del provider.
| Metodo | URI della richiesta |
|---|---|
| OTTIENI | 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
| Argomentazione | Descrizione |
|---|---|
armendpoint |
Endpoint di Azure Resource Manager dell'ambiente Azure Stack Hub. 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 è codificato secondo lo standard ISO 8601; ad esempio, 2015-06-16T18%3a53%3a11%2b00%3a00Z, dove i due punti sono codificati come %3a e il segno più è codificato come %2b affinché sia compatibile con 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
| Argomentazione | 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 completamente qualificato della risorsa, 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 consumata (chiamata anche ResourceID). |
Recuperare le informazioni sull'utilizzo
PowerShell
Per generare i dati di utilizzo, è necessario disporre di risorse in esecuzione e che usano attivamente il sistema; ad esempio una macchina virtuale attiva o un account di archiviazione contenente alcuni dati. Se non si è certi di avere risorse in esecuzione nel Marketplace dell'hub di Azure Stack, distribuire una macchina virtuale e verificare il pannello di monitoraggio della macchina virtuale 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 dell'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"
REST API (Interfaccia di Programmazione delle Applicazioni REST)
È possibile raccogliere informazioni sull'utilizzo per le sottoscrizioni eliminate chiamando il servizio Microsoft.Commerce.Admin .
Restituisci tutti gli utilizzi del tenant per gli utenti attivi e cancellati.
| Metodo | URI della richiesta |
|---|---|
| OTTIENI | https://{armendpoint}/subscriptions/{subId}/providers/Microsoft.Commerce.Admin/subscriberUsageAggregates?reportedStartTime={start-time}&reportedEndTime={end-endtime}&aggregationGranularity=Hourly&api-version=2015-06-01-preview |
Rendere disponibile l'uso per il cliente eliminato o attivo
| Metodo | URI della richiesta |
|---|---|
| OTTIENI | 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 |