Lisans kullanım bilgilerini alma

Makale
12/01/2021
Okumak için 2 dakika

Office dynamics için iş yükü düzeyinde lisans kullanım bilgilerini alın.

Önkoşullar

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

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
AL	{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 geri dönecek veri satırlarının sayısı. Belirtilmezse en büyük değer ve varsayılan değer 10000'tir. 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.	No
Atla	int	Sorguda atlana satır sayısı. Büyük veri kümelerini sayfalara yapmak için bu parametreyi kullanın. Örneğin, top=10000 ve skip=0 ilk 10000 veri satırlarını, top=10000 ve skip=10000 sonraki 10000 satırı ve bu şekilde devam ediyor.	No
filtre	string	İsteğin filtre parametresi, yanıtta satırları filtreleen bir veya daha fazla deyim içerir. Her deyim, veya işleçleriyle ilişkili bir alan ve değer içerir ve `eq``ne` deyimleri veya kullanılarak bir `and` araya `or` olabilir. Bazı örnek filtre parametreleri şu şekildedir: 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	No
Groupby	string	Yalnızca belirtilen alanlara veri toplaması uygulanan 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 şunları içerir: licensesActive licensesQualified	No
processedDateTime	DateTime	Kullanım verileri işlenme tarihini belirtebilirsiniz. Verilerin işlenme tarihi varsayılan olarak en son tarihtir	No

İ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: 9cbdf63c-2608-4ad8-b0a9-abae27d859d9
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ı
Lisans nitelikli	long	İş yükü için uygun lisans sayısı
processedDateTime	DateTime	Verilerin son işlendiği tarih

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. Iş 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: 9cbdf63c-2608-4ad8-b0a9-abae27d859d9
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
    }
}