라이선스 사용 현황 정보 가져오기

아티클
07/17/2024

Office 및 Dynamics의 워크로드 수준에서 라이선스 사용 정보를 가져오는 방법입니다.

필수 구성 요소

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱+사용자 자격 증명을 통한 인증을 지원합니다.

REST 요청

요청 구문

방법	요청 URI
GET	{baseURL}/v1/analytics/commercial/usage/license/ HTTP/1.1

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

URI 매개 변수

매개 변수	형식	Description	필요한 공간
top	문자열	요청에서 반환할 데이터의 행의 수입니다. 지정되지 않은 경우 최대값 및 기본값은 10000입니다. 쿼리에 더 많은 행이 있는 경우 응답 본문에 데이터의 다음 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함되어 있습니다.	아니요
skip	int	쿼리에서 건너뛸 행의 수입니다. 이 매개 변수를 사용하여 큰 데이터 집합의 페이지를 탐색할 수 있습니다. 예를 들어 top=10000 및 skip=0이면 데이터의 처음 10000개 행을 검색하고 top=10000 및 skip=10000이면 데이터의 다음 10000개 행을 검색하는 방식입니다.	아니요
filter	문자열	요청의 filter 매개 변수에는 응답에서 행을 필터링하는 하나 이상의 문이 포함되어 있습니다. 각 문에는 또는 `ne` 연산자와 연결된 `eq` 필드와 값이 포함되며 또는 를 사용하여 `and``or`문을 결합할 수 있습니다. 다음은 filter 매개 변수의 몇 가지 예입니다. filter=workloadCode eq 'SFB' filter=workloadCode eq 'SFB' 또는 (channel eq 'Reseller') 다음 필드를 지정할 수 있습니다. workloadCode workloadName serviceCode serviceName 채널 customerTenantId Customername productId productName	아니요
groupby	문자열	지정된 필드에 대한 데이터 집계에만 적용되는 문입니다. 다음 필드를 지정할 수 있습니다. workloadCode workloadName serviceCode serviceName channelcustomerTenantId Customername productId productName 반환된 데이터 행에는 groupby 매개 변수에 지정된 필드와 다음이 포함됩니다. licensesActive licensesQualified	No
processedDateTime	DateTime	사용량 현황 데이터가 처리된 날짜를 지정할 수 있습니다. 기본값은 데이터가 처리된 최신 날짜입니다.	예

요청 예제

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/commercial/usage/license?filter=customerTenantId%20eq%20%27aaaabbbb-0000-cccc-1111-dddd2222eeee%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 응답

성공하면 응답 본문에는 라이선스 사용량에 대한 데이터가 포함된 다음 필드가 포함됩니다.

필드	형식	Description
workloadCode	문자열	워크로드 코드
workloadName	문자열	워크로드 이름
serviceCode	문자열	서비스 코드
serviceName	문자열	서비스 이름
채널	문자열	채널 이름, 재판매인
customerTenantId	문자열	고객의 고유 식별자
customerName	문자열	고객 이름
productId	문자열	제품의 고유 식별자
productName	문자열	제품 이름
licensesActive	long	워크로드당 활성 라이선스 수
licensesQualified	long	워크로드에 대한 정규화된 라이선스 수
processedDateTime	DateTime	데이터가 마지막으로 처리된 날짜

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 파트너 센터 REST 오류 코드를 참조하세요.

응답 예제

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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
      "customerName": "TEST COMPANY",
      "productId": "45A2423B-E884-448D-A831-D9E139C52D2F",
      "productName": "EXCHANGE ONLINE PROTECTION",
      "licenseActive": 0,
      "licensesQualified": 1
    }
}

다음을 통해 공유