Bagikan melalui

Mendapatkan semua informasi analitik langganan

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Artikel ini menjelaskan cara mendapatkan semua informasi analitik langganan untuk pelanggan Anda.

Prasyarat

  • Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini hanya mendukung autentikasi dengan kredensial Pengguna.

Permintaan REST

Sintaks permintaan

Metode Meminta URI
GET {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

Parameter URI

Tabel berikut ini mencantumkan parameter opsional dan deskripsinya:

Parameter Jenis Deskripsi
puncak Int Jumlah baris data yang akan dikembalikan dalam permintaan. Jika nilai tidak ditetapkan, nilai maksimum dan nilai default adalah 10000. Jika ada lebih banyak baris dalam kueri, isi respons menyertakan tautan berikutnya yang bisa Anda gunakan untuk meminta halaman data berikutnya.
lewat Int Jumlah baris yang akan dilewati dalam kueri. Gunakan parameter ini untuk menelusuri data dalam jumlah besar. Misalnya, top=10000 dan skip=0 mengambil 10.000 baris data pertama, top=10000 dan skip=10000 mengambil 10.000 baris data berikutnya.
saringan tali Satu atau beberapa pernyataan yang memfilter baris dalam respons. Setiap pernyataan filter berisi nama bidang dari isi respons dan nilai yang terkait dengan eq, ne, atau untuk bidang tertentu, operator contains. Pernyataan dapat digabungkan menggunakan and atau or. Nilai string harus dikelilingi oleh tanda kutip tunggal dalam parameter filter. Lihat bagian berikut untuk daftar bidang yang bisa difilter dan operator yang didukung dengan bidang tersebut.
tingkat agregasi string Menentukan rentang waktu untuk mengambil data agregat. Dapat berupa salah satu string berikut: hari, minggu, atau bulan . Jika nilai tidak ditentukan, defaultnya adalah dateRange. Parameter ini hanya berlaku ketika bidang tanggal diteruskan sebagai bagian dari parameter groupBy.
kelompokkanDengan tali Pernyataan yang menerapkan agregasi data hanya ke bidang yang ditentukan.

Header permintaan

Untuk informasi selengkapnya, lihat header REST Pusat Mitra.

Isi permintaan

Tidak.

Contoh permintaan

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

Respons REST

Jika berhasil, isi respons berisi kumpulan Langganan sumber daya.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan lebih banyak parameter. Untuk daftar lengkapnya, lihat kode kesalahan .

Contoh respons

{
    "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"

}

Lihat juga

  • Last updated on