Tüm abonelik analizi bilgilerini alma
Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government
Bu makalede, müşterileriniz için tüm abonelik analizi bilgilerini alma açıklanmıştır.
Önkoşullar
- kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo yalnızca Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.
REST isteği
İstek söz dizimi
| Yöntem | İstek URI'si |
|---|---|
| AL | {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1 |
URI parametreleri
Aşağıdaki tabloda isteğe bağlı parametreler ve açıklamaları liste almaktadır:
| Parametre | Tür | Description |
|---|---|---|
| top | int | İstekte geri dönecek veri satırlarının sayısı. Değer belirtilmezse, en büyük değer ve varsayılan değer 10000 olur. Sorguda daha fazla satır varsa yanıt gövdesi, sonraki veri sayfasını talep etmek için kullanabileceğiniz bir sonraki bağlantı içerir. |
| Atla | int | Sorguda atlana satır sayısı. Büyük veri kümelerini sayfalara yapmak için bu parametreyi kullanın. Örneğin, ilk 10000 veri satırı ve sonraki top=10000skip=0top=10000skip=10000 10000 satır veriyi de alan ve . |
| filtre | string | Yanıtta satırları filtreleen bir veya daha fazla deyim. Her filtre deyimi, yanıt gövdesinden bir alan adı ve , veya belirli alanlar eqne için işleciyle ilişkili bir değer contains içerir. deyimleri veya kullanılarak and birleştirilmiş or olabilir. Dize değerleri, filtre parametresinde tek tırnak içine alınarak olmalıdır. Filtrelenmiş alanların listesi ve bu alanlarda desteklenen işleçler için aşağıdaki bölüme bakın. |
| aggregationLevel | string | Toplama verilerini almak için zaman aralığını belirtir. Şu dizelerden biri olabilir: gün,haftaveya ay. Değer belirtilmezse varsayılan değer dateRange'dır. Bu parametre yalnızca groupBy parametresinin bir parçası olarak bir tarih alanı geçir kullanıldığında geçerlidir. |
| Groupby | string | Yalnızca belirtilen alanlara veri toplaması uygulanan bir deyim. |
İstek üst bilgileri
Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.
İstek gövdesi
Yok.
İstek örneği
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
REST yanıtı
Başarılı olursa, yanıt gövdesi Abonelik kaynaklarının bir koleksiyonunu içerir.
Yanıt başarı ve hata kodları
Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Hata Kodları.
Yanıt örneği
{
"customerTenantId": "76906668-27FC-4F5B-A35C-75A9823E13AF",
"customerName": "TESTORG65656565",
"customerMarket": "US",
"id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
"status": "ACTIVE",
"productName": "OFFICE 365 BUSINESS PREMIUM",
"subscriptionType": "Office",
"autoRenewEnabled": true,
"partnerId": "3B33E682-00C3-41EE-9DD2-A548ADF56438",
"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"
}