Ottenere tutte le informazioni sull'analisi delle sottoscrizioni

Articolo
09/22/2023

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Questo articolo descrive come ottenere tutte le informazioni di analisi delle sottoscrizioni per i clienti.

Prerequisiti

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

Richiesta REST

Sintassi della richiesta

Method	URI della richiesta
GET	{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

Parametri URI

La tabella seguente elenca i parametri facoltativi e le relative descrizioni:

Parametro	Type	Descrizione
migliori	int	Numero di righe di dati da restituire nella richiesta. Se il valore non viene specificato, il valore massimo e il valore predefinito sono `10000`. Se nella query sono presenti più righe, il corpo della risposta include un collegamento successivo che è possibile usare per richiedere la pagina successiva dei dati.
skip	int	Numero di righe da ignorare nella query. Usare questo parametro per scorrere set di dati di grandi dimensioni. Ad esempio, `top=10000` e `skip=0` recupera le prime 10.000 righe di dati `top=10000` e `skip=10000` recupera le 10.000 righe di dati successive.
filter	stringa	Una o più istruzioni che filtrano le righe nella risposta. Ogni istruzione di filtro contiene un nome di campo dal corpo della risposta e un valore associato a `eq`, `ne`o per determinati campi, l'operatore `contains` . Le istruzioni possono essere combinate usando `and` o `or`. I valori stringa devono essere racchiusi tra virgolette singole nel parametro di filtro . Vedere la sezione seguente per un elenco di campi che possono essere filtrati e gli operatori supportati con tali campi.
aggregationLevel	stringa	Specifica l'intervallo di tempo per il quale recuperare i dati aggregati. Può essere una delle stringhe seguenti: giorno, settimana o mese. Se il valore non è specificato, il valore predefinito è dateRange. Questo parametro si applica solo quando un campo data viene passato come parte del parametro groupBy .
Groupby	stringa	Istruzione che applica l'aggregazione dei dati solo ai campi specificati.

Intestazioni della richiesta

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

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
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 sottoscrizione .

Codici di errore e di esito della risposta

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

Risposta di esempio

{
    "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "customerName": "TESTORG65656565",
    "customerMarket": "US",
    "id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
    "status": "ACTIVE",
    "productName": "OFFICE 365 BUSINESS PREMIUM",
    "subscriptionType": "Office",
    "autoRenewEnabled": true,
    "partnerId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "friendlyName": "FULL OFFICE SUITE",
    "partnerName": "Partner Name",
    "providerName": "Provider Name",
    "creationDate": "2016-02-04T19:29:38.037",
   "effectiveStartDate": "2016-02-04T00:00:00",
    "commitmentEndDate": "2019-02-10T00:00:00",
    "currentStateEndDate": "2019-02-10T00:00:00",
    "trialToPaidConversionDate": null,
    "trialStartDate": null,
    "trialEndDate": null,
    "lastUsageDate": null,
    "deprovisionedDate": null,
    "lastRenewalDate": "2018-02-10T02:39:57.729",
    "licenseCount": 2,
    "churnRisk": "High",
    "billingCycleName": "MONTHLY"

}

Vedi anche

Analisi del Centro per i partner - Risorse

Condividi tramite