Tarihlere veya terimlere göre gruplandırarak abonelik analizi alma

  • Makale
  • Okumak için 3 dakika

Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government

Müşterileriniz için tarihlere veya terimlere göre gruplara göre abonelik analizi bilgilerini alma.

Ö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?groupby={groupby_queries}

URI parametreleri

Aşağıdaki gerekli yol parametrelerini kullanarak kuruluşu tanıyın ve sonuçları gruplayın.

Ad Tür Gerekli Açıklama
groupby_queries dize çiftleri ve dateTime Yes Sonucu filtrelemek için terimler ve tarihler.

GroupBy söz dizimi

Parametreye göre grup, bir dizi virgülle ayrılmış alan değeri olarak bestelenmiş olmalıdır.

Kodlanmamış bir örnek şu şekildedir:

?groupby=termField1,dateField1,termField2

Aşağıdaki tabloda, grupla için desteklenen alanların listesi yer alır.

Alan Tür Description
customerTenantId string Müşteri kiracıyı tanımlayan GUID biçimli bir dize.
Müşteriadı string Müşterinin adı.
customerMarket string Müşterinin iş yaptığı ülke/bölge.
kimlik string Aboneliği tanımlayan GUID biçimli bir dize.
durum string Abonelik durumu. Desteklenen değerler: "ACTIVE", "SUSPENDED" veya "DEPROVISIONED".
Productname string Ürünün adı.
Subscriptiontype string Abonelik türü. Not: Bu alan büyük/büyük/büyük harfe duyarlıdır. Desteklenen değerler: "Office", "Azure", "Microsoft365", "Dynamics", "EMS".
autoRenewEnabled Boole Aboneliğin otomatik olarak yenilenmeyi belirten bir değer.
partnerId string MPN Kimliği. Doğrudan bayi için bu parametre, iş ortağının MPN kimliği olur. Dolaylı kurumsal bayi için bu parametre, dolaylı kurumsal bayinin MPN kimliği olur.
Friendlyname string Aboneliğin adı.
partnerName string Aboneliğin satın alınarak satın alınan iş ortağının adı
providerName string Abonelik işlemi dolaylı kurumsal bayi için olduğunda, sağlayıcı adı aboneliği satın alan dolaylı sağlayıcıdır.
Creationdate UTC tarih saat biçiminde dize Aboneliğin oluşturulma tarihi.
effectiveStartDate UTC tarih saat biçiminde dize Aboneliğin başladığı tarih.
commitmentEndDate UTC tarih saat biçiminde dize Aboneliğin bitiş tarihi.
currentStateEndDate UTC tarih saat biçiminde dize Aboneliğin geçerli durumunun değiş tarihi.
trialToPaidConversionDate UTC tarih saat biçiminde dize Aboneliğin denemeden ücretliye dönüştürülmesi tarihi. Varsayılan değer boştur.
trialStartDate UTC tarih saat biçiminde dize Aboneliğin deneme döneminin başladığı tarih. Varsayılan değer boştur.
lastUsageDate UTC tarih saat biçiminde dize Aboneliğin son kullanılma tarihi. Varsayılan değer boştur.
deprovisionedDate UTC tarih saat biçiminde dize Aboneliğin onaysız olduğu tarih. Varsayılan değer boştur.
lastRenewalDate UTC Tarih saat biçiminde dize Aboneliğin son yenilenme tarihi. Varsayılan değer boştur.

Filtre alanları

Aşağıdaki tablo, isteğe bağlı filtre alanlarını ve açıklamalarını listelemektedir:

Alan Tür Description
top int İstekte döndürülecek veri satır sayısı. Değer belirtilmezse, en büyük değer ve varsayılan değer 10000 ' dir. Sorguda daha fazla satır varsa, yanıt gövdesi sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantıyı içerir.
Atla int Sorgudaki atlanacak satır sayısı. Büyük veri kümeleri üzerinden sayfa eklemek için bu parametreyi kullanın. Örneğin, top = 10000 ve Skip = 0 verilerin ilk 10000 satırını alır, top = 10000 ve Skip = 10000, sonraki 10000 satırlık verileri alır.
filtre string Yanıttaki satırları filtreleyen bir veya daha fazla deyim. Her filtre ekstresi, yanıt gövdesinden bir alan adı ve eq , ne veya belirli alanlar için, işleci ile ilişkili bir değer içerir contains . Deyimler, veya kullanılarak birleştirilebilir andor . Dize değerleri, filtre parametresindeki tek tırnak işaretleriyle çevrelenmelidir. Filtrelenebilir alanların listesi ve bu alanlarla Desteklenen işleçler için aşağıdaki bölüme bakın.
aggregationLevel string Toplam verilerinin alınacağı zaman aralığını belirtir. Şu dizelerden biri olabilir: gün, haftaveya ay. Değer belirtilmezse, varsayılan olarak Dadterangeolur. Note: Bu parametre yalnızca, GroupBy parametresinin bir parçası olarak bir tarih alanı geçirildiğinde geçerlidir.
Ölçütü string Yalnızca belirtilen alanlara veri toplamayı uygulayan bir ifade.

İstek üst bilgileri

Daha fazla bilgi için bkz. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions?groupBy=subscriptionType
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-CorrelationId: ec8f62e5-1d92-47e9-8d5d-1924af105123
Content-Type: application/json
Content-Length: 0

REST yanıtı

Başarılı olursa, yanıt gövdesi belirtilen hüküm ve tarihlere göre gruplanmış bir abonelik kaynakları koleksiyonu içerir.

Yanıt başarısı ve hata kodları

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile 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

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3123
MS-RequestId: ec8f62e5-1d92-47e9-8d5d-1924af105123
{
  "Value": [
    {
      "subscriptionType": "Azure",
      "subscriptionCount": "63",
      "licenseCount": "0"
    },
    {
      "subscriptionType": "Dynamics",
      "subscriptionCount": "62",
      "licenseCount": "405"
    },
    {
      "subscriptionType": "EMS",
      "subscriptionCount": "39",
      "licenseCount": "193"
    },
    {
      "subscriptionType": "M365",
      "subscriptionCount": "2",
      "licenseCount": "5"
    },
    {
      "subscriptionType": "Office",
      "subscriptionCount": "906",
      "licenseCount": "7485"
    },
    {
      "subscriptionType": "UNKNOWN",
      "subscriptionCount": "104",
      "licenseCount": "439"
    },
    {
      "subscriptionType": "Windows",
      "subscriptionCount": "2",
      "licenseCount": "2"
    }
  ],
  "@nextLink": null,
  "TotalCount": 7
}

Ayrıca bkz.

İş Ortağı Merkezi Analizi - Kaynaklar