Ottenere tutte le informazioni sull'analisi dell'utilizzo di Azure

Articolo
05/28/2024

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud for US Government

Come ottenere tutte le informazioni sull'analisi dell'utilizzo di Azure per i clienti.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione solo con credenziali utente.

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Parametri URI

Parametro	Tipo	Descrizione
top	string	Numero di righe di dati da restituire nella richiesta. Il valore massimo e il valore predefinito se non specificato è 10000. Se nella query sono presenti più righe, il corpo della risposta include un link successivo che puoi usare per richiedere la pagina successiva dei dati.
skip	INT	Numero di righe da ignorare nella query. Usa questo parametro per scorrere set di dati di grandi dimensioni. Ad esempio, `top=10000 and skip=0` recupera le prime 10000 righe di dati, `top=10000 and skip=10000` recupera le 10000 righe di dati successive e così via.
filter	string	Il parametro filter della richiesta include una o più istruzioni per filtrare le righe nella risposta. Ogni istruzione contiene un campo e un valore associati agli `eq` operatori o `ne` e le istruzioni possono essere combinate usando `and` o `or`. È possibile specificare le stringhe seguenti: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` Esempio: `.../usage/azure?filter=meterCategory eq 'Data Management'` Esempio: `.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))`
aggregationLevel	string	Specifica l'intervallo di tempo per cui recuperare dati aggregati. Può essere una delle stringhe seguenti: `day`, `week`o `month`. Se non specificato, il valore predefinito è `day`. Il `aggregationLevel` parametro non è supportato senza .`groupby` Il `aggregationLevel` parametro si applica a tutti i campi di data presenti in `groupby`.
orderby	string	Istruzione che ordina i valori dei dati dei risultati per ogni installazione. La sintassi è `...&orderby=field [order],field [order],...`. Il `field` parametro può essere una delle stringhe seguenti: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` Il parametro order è facoltativo e può essere `asc` o `desc` per specificare rispettivamente l'ordine crescente o decrescente per ogni campo. Il valore predefinito è `asc`. Esempio: `...&orderby=meterCategory,meterUnit`
groupby	string	Istruzione che applica l'aggregazione dei dati solo ai campi specificati. Puoi specificare i campi seguenti: `customerTenantId` `customerName` `subscriptionId` `subscriptionName` `usageDate` `resourceLocation` `meterCategory` `meterSubcategory` `meterUnit` Le righe di dati restituite conterranno i campi specificati nel `groupby` parametro e quantità. Il `groupby` parametro può essere usato con il `aggregationLevel` parametro . Esempio: `...&groupby=meterCategory,meterUnit`

Intestazioni della richiesta

Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una raccolta di risorse di utilizzo di Azure .

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Esempio di risposta

{
  "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Vedi anche

Analisi del Centro per i partner - Risorse

Condividi tramite