Abonelik analizini tarihlere veya koşullara göre gruplandırma

Makale
06/19/2023

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | Microsoft Cloud for US Government için İş Ortağı Merkezi

Müşterileriniz için abonelik analizi bilgilerini tarihlere veya koşullara göre gruplandırılmış olarak alma.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
GET	{baseURL}/partner/v1/analytics/subscriptions?groupby={groupby_queries}

URI parametreleri

Kuruluşunuzu tanımlamak ve sonuçları gruplandırmak için aşağıdaki gerekli yol parametrelerini kullanı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

Group by parametresi, virgülle ayrılmış bir dizi alan değeri olarak oluşturulmalıdır.

Kodlanmamış bir örnek şöyle görünür:

?groupby=termField1,dateField1,termField2

Aşağıdaki tabloda gruplandırma ölçütü için desteklenen alanların listesi gösterilmektedir.

Alan	Tür	Description
customerTenantId	string	Müşteri kiracısını 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 şunlardır: "ETKİn", "ASKIYA ALINDI" veya "DEPROVISIONED".
Productname	string	Ürünün adı.
Subscriptiontype	string	Abonelik türü. Not: Bu alan büyük/küçük harfe duyarlıdır. Desteklenen değerler şunlardır: "Office", "Azure", "Microsoft365", "Dynamics", "EMS".
autoRenewEnabled	Boole	Aboneliğin otomatik olarak yenilenip yenilenmediğini gösteren değer.
partnerId	string	The PartnerID. Doğrudan kurumsal bayi için bu parametre iş ortağının İş Ortağı Kimliği olacaktır. Dolaylı bir kurumsal bayi için bu parametre, dolaylı kurumsal bayinin İş Ortağı Kimliği olacaktır.
Friendlyname	string	Aboneliğin adı.
partnerName	string	Aboneliğin satın alındığı 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şturulduğu tarih.
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ştirileceği tarih.
trialToPaidConversionDate	UTC tarih saat biçiminde dize	Aboneliğin deneme sürümünden ücretliye dönüştürüldüğü tarih. Varsayılan değer boştur.
trialStartDate	UTC tarih saat biçiminde dize	Abonelik için deneme süresinin başladığı tarih. Varsayılan değer boştur.
lastUsageDate	UTC tarih saat biçiminde dize	Aboneliğin son kullanıldığı tarih. Varsayılan değer boştur.
deprovisionedDate	UTC tarih saat biçiminde dize	Aboneliğin sağlamasının kaldırıldığı tarih. Varsayılan değer boştur.
lastRenewalDate	UTC tarih saat biçiminde dize	Aboneliğin son yenilendiği tarih. Varsayılan değer boştur.

Alanları filtreleme

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

Alan	Tür	Description
top	int	İstekte döndürülecek veri satırlarının 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 bir sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantıyı içerir.
Atla	int	Sorguda atlana satır sayısı. Büyük veri kümelerini sayfalandırmak için bu parametreyi kullanın. Örneğin, top=10000 ve skip=0 ilk 10000 veri satırını alır; top=10000 ve skip=10000 sonraki 10000 veri satırını alır.
filtre	string	Yanıttaki satırları filtreleyen bir veya daha fazla deyim. Her filtre deyimi, yanıt gövdesinden bir alan adı ve , `ne`veya belirli alanlar `contains` için işleciyle `eq`ilişkili bir değer içerir. Deyimler veya `or`kullanılarak `and` birleştirilebilir. Dize değerleri, filtre parametresinde tek tırnak içine alınmalıdır. Filtrelenebilen alanların listesi ve bu alanlarla desteklenen işleçler için aşağıdaki bölüme bakın.
aggregationLevel	string	Toplama verilerinin alındığı zaman aralığını belirtir. Şu dizelerden biri olabilir: gün, hafta veya ay. Değer belirtilmezse, varsayılan değer dateRange'dir. Not: Bu parametre yalnızca groupBy parametresinin bir parçası olarak bir tarih alanı geçirildiğinde geçerlidir.
Groupby	string	Yalnızca belirtilen alanlara veri toplama uygulayan 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?groupBy=subscriptionType
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 0

REST yanıtı

Başarılı olursa, yanıt gövdesi belirtilen terimlere ve tarihlere göre gruplandırılmış bir Abonelik kaynakları koleksiyonu içerir.

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

Her yanıt, başarılı veya başarısız olduğunu ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla 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

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: aaaa0000-bb11-2222-33cc-444444dddddd
{
  "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

Aracılığıyla paylaş