Lisans kullanım bilgilerini alma

Makale
07/17/2024

Office ve Dynamics için iş yükü düzeyinde lisans kullanım bilgilerini alma.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo, App+User kimlik bilgileriyle kimlik doğrulamayı destekler.

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
GET	{baseURL}/v1/analytics/commercial/usage/license/ HTTP/1.1

İstek üst bilgileri

Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.

URI parametreleri

Parametre	Tür	Açıklama	Gerekli
top	string	İstekte döndürülecek veri satırlarının sayısı. En büyük değer ve belirtilmezse 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.	Hayır
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, vb.	Hayır
filtre	string	İsteğin filter parametresi, yanıttaki satırları filtreleyen bir veya daha fazla deyim içerir. Her deyim, veya işleçleriyle `eq` ilişkili bir alan ve değer içerir ve deyimler veya `or`kullanılarak `and` birleştirilebilir.`ne` Aşağıda bazı örnek filtre parametreleri verilmiştir: filter=workloadCode eq 'SFB' filter=workloadCode eq 'SFB' veya (channel eq 'Reseller') Aşağıdaki alanları belirtebilirsiniz: workloadCode workloadName serviceCode Hizmetadı Kanal customerTenantId Müşteriadı Productıd Productname	Hayır
Groupby	string	Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim. Aşağıdaki alanları belirtebilirsiniz: workloadCode workloadName serviceCode Hizmetadı channelcustomerTenantId Müşteriadı Productıd Productname Döndürülen veri satırları groupby parametresinde belirtilen alanları ve aşağıdakileri içerir: licensesActive licensesQualified	Hayır
processedDateTime	DateTime	Kullanım verilerinin işlendiği tarihi belirtebilirsiniz. Verilerin işlendiği en son tarihi varsayılan olarak belirler	Hayır

İstek örneği

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/usage/license?filter=customerTenantId%20eq%20%270112A436-B14E-4888-967B-CA4BB2CF1234%27 HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST yanıtı

Başarılı olursa, yanıt gövdesi lisans kullanımıyla ilgili verileri içeren aşağıdaki alanları içerir.

Alan	Tür	Description
workloadCode	string	İş yükü kodu
workloadName	string	İş yükü adı
serviceCode	string	Hizmet kodu
Hizmetadı	string	Hizmet adı
Kanal	string	Kanal adı, kurumsal bayi
customerTenantId	string	Müşterinin benzersiz tanımlayıcısı
Müşteriadı	string	Müşteri adı
productId	string	Ürün için benzersiz tanımlayıcı
Productname	string	Ürün adı
licensesActive	long	İş yükü başına etkin lisans sayısı
lisanslarQualified	long	İş yükü için nitelikli lisans sayısı
processedDateTime	DateTime	Verilerin son işlendiği tarih

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

Her yanıt, başarıyı veya başarısızlığı 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. İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 487
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: bad5f75f-fd44-43ab-9325-bbc79dcba9da
MS-CV: f0trvmq8mEScHcFS.0
MS-ServerId: 4
Date: Wed, 24 Oct 2018 22:37:18 GMT

{
"Value": [
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "workloadCode": "SPO",
      "workloadName": "SharePoint",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "0112A436-B14E-4888-967B-CA4BB2CF1234",
      "customerName": "TEST COMPANY",
      "productId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
      "productName": "OFFICE 365 ENTERPRISE E3",
      "licenseActive": 0,
      "licensesQualified": 1
    },
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "workloadCode": "EXO",
      "workloadName": "Exchange",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "0112A436-B14E-4888-967B-CA4BB2CF1234",
      "customerName": "TEST COMPANY",
      "productId": "45A2423B-E884-448D-A831-D9E139C52D2F",
      "productName": "EXCHANGE ONLINE PROTECTION",
      "licenseActive": 0,
      "licensesQualified": 1
    }
}

Aracılığıyla paylaş