에 적용: 파트너 센터 | 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터
이 문서에서는 고객의 모든 구독 분석 정보를 가져오는 방법을 설명합니다.
필수 구성 요소
- 파트너 센터 인증에 설명된 대로 자격 증명. 이 시나리오에서는 사용자 자격 증명으로만 인증을 지원합니다.
REST 요청
요청 구문
| 메서드 | 요청 URI |
|---|---|
| 가져오기 | {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1 |
URI 매개 변수
다음 표에는 선택적 매개 변수 및 해당 설명이 나와 있습니다.
| 매개 변수 | 유형 | 묘사 |
|---|---|---|
| 맨 위로 | int | 요청에 반환할 데이터 행 수입니다. 값을 지정하지 않으면 최대값과 기본값이 10000. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다. |
| 거르다 | 정수 | 쿼리에서 건너뛸 행 수입니다. 이 매개변수를 사용하여 큰 데이터 집합을 페이지로 나눌 수 있습니다. 예를 들어 top=10000 및 skip=0 처음 10,000개의 데이터 행을 검색하고, top=10000 및 skip=10000 다음 10,000개의 데이터 행을 검색합니다. |
| 필터 | 문자열 | 응답의 행을 필터링하는 하나 이상의 구문이 있습니다. 각 필터 문에는 응답 본문의 필드 이름과 eq, ne또는 특정 필드의 경우 contains 연산자와 연결된 값이 포함됩니다.
and 또는 or을 사용하여 문장을 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다. 필터링할 수 있는 필드 목록과 해당 필드에서 지원되는 연산자는 다음 섹션을 참조하세요. |
| 집계 수준 | 문자열 | 집계 데이터를 검색할 시간 범위를 지정합니다. 일, 주또는 월문자열 중 하나일 수 있습니다. 값을 지정하지 않으면 기본값은 dateRange. 이 매개 변수는 날짜 필드가 groupBy 매개 변수의 일부로 전달되는 경우에만 적용됩니다. |
| 그룹별 | 문자열 | 지정된 필드에만 데이터 집계를 적용하는 문입니다. |
요청 헤더
요청 본문
없음.
요청 예제
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
REST 응답
성공하면 응답 본문에 구독 리소스 컬렉션이 포함됩니다.
응답 성공 및 오류 코드
각 응답에는 성공 또는 실패 및 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은 오류 코드참조하세요.
응답 예제
{
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"customerName": "TESTORG65656565",
"customerMarket": "US",
"id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
"status": "ACTIVE",
"productName": "OFFICE 365 BUSINESS PREMIUM",
"subscriptionType": "Office",
"autoRenewEnabled": true,
"partnerId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"friendlyName": "FULL OFFICE SUITE",
"partnerName": "Partner Name",
"providerName": "Provider Name",
"creationDate": "2016-02-04T19:29:38.037",
"effectiveStartDate": "2016-02-04T00:00:00",
"commitmentEndDate": "2019-02-10T00:00:00",
"currentStateEndDate": "2019-02-10T00:00:00",
"trialToPaidConversionDate": null,
"trialStartDate": null,
"trialEndDate": null,
"lastUsageDate": null,
"deprovisionedDate": null,
"lastRenewalDate": "2018-02-10T02:39:57.729",
"licenseCount": 2,
"churnRisk": "High",
"billingCycleName": "MONTHLY"
}