Lisans dağıtım bilgilerini alma

  • Makale
  • Okumak için 2 dakika

Office ve Dynamics lisanslarıyla ilgili dağıtım bilgilerini alma.

Önkoşullar

Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo, uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
AL {BaseUrl}/v1/Analtics/, CIAL/Deployment/License/http/1.1

İstek üst bilgileri

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

URI parametreleri

Parametre Tür Açıklama Gerekli
top string İstekte döndürülecek veri satır sayısı. Belirtilen 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. No
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 ve bu şekilde devam eder. No
filtre string İsteğin filtre parametresi, yanıttaki satırları filtreleyen bir veya daha fazla deyim içeriyor. Her deyim, veya işleçleriyle ilişkili bir alan ve değer içerir eqne ve deyimler or kullanılarak birleştirilebilir andor . Aşağıda bazı örnek filtre parametreleri verilmiştir:

Filter = serviceCode EQ ' O365 '
Filter = serviceCode EQ ' O365 ' veya (Channel EQ ' Bayi ')

Aşağıdaki alanları belirtebilirsiniz:

serviceCode
HizmetAdı
kanalla
Customertenantıd
customerName
ProductID
productName		 No
ölçütü string Yalnızca belirtilen alanlara veri toplamayı uygulayan bir ifade. Aşağıdaki alanları belirtebilirsiniz:

serviceCode
HizmetAdı
kanalla
Customertenantıd
customerName
ProductID
productName

Döndürülen veri satırları, GroupBy parametresinde belirtilen alanları ve şunları içerir:

Licensesdağıtıldı
Lisanssesseski		 No
processedDateTime DateTime Bunlardan biri, kullanım verilerinin işlendiği tarihi belirtebilir. Verilerin işlendiği tarih varsayılan olarak en geç No

İstek örneği

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/deployment/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 dağıtılan lisanslar hakkında veri içeren aşağıdaki alanları içerir.

Alan Tür Description
serviceCode string Hizmet kodu
HizmetAdı string Hizmet adı
kanalla string Kanal adı, satıcı
Customertenantıd string Müşteri için benzersiz tanımlayıcı
customerName string Müşteri adı
productId string Ürün için benzersiz tanımlayıcı
productName string Ürün adı
Licensesdağıtıldı long Dağıtılan lisansların sayısı
Lisanssesseski long Satılan lisans sayısı
processedDateTime DateTime Verilerin son işlenme tarihi

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. İŞ 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",
      "serviceCode": "crm",
      "serviceName": "Microsoft Dynamics",
      "channel": "reseller",
      "customerTenantId": "0112A436-B14E-4888-967B-CA4BB2CF1234",
      "customerName": "TEST COMPANY",
      "productId": "54B84594-9C77-4499-8D65-5E0D5F410E78",
      "productName": "DYNAMICS AX TASK",
      "licensesDeployed": 0,
      "licensesSold": 9
    },
    {
      "processedDateTime": "2018-10-14T00:00:00",
      "serviceCode": "o365",
      "serviceName": "Microsoft Office 365",
      "channel": "reseller",
      "customerTenantId": "0112A436-B14E-4888-967B-CA4BB2CF1234",
      "customerName": "TEST COMPANY",
      "productId": "D3B4FE1F-9992-4930-8ACB-CA6EC609365E",
      "productName": "DOMESTIC AND INTERNATIONAL CALLING PLAN",
      "licensesDeployed": 0,
      "licensesSold": 5
    }
],
  "@nextLink": null,
  "TotalCount": 2
}