모든 구독 분석 정보 가져오기
적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터
이 문서에서는 고객의 모든 구독 분석 정보를 가져오는 방법을 설명합니다.
필수 조건
- 자격 증명(파트너 센터 인증에서 설명). 이 시나리오에서는 사용자 자격 증명으로만 인증을 지원합니다.
REST 요청
요청 구문
| 메서드 | 요청 URI |
|---|---|
| GET | {baseURL}/partner/v1/analytics/subscriptions HTTP/1.1 |
URI 매개 변수
다음 표에는 선택적 매개 변수 및 해당 설명이 나와 있습니다.
| 매개 변수 | 형식 | 설명 |
|---|---|---|
| top | int | 요청에 반환할 데이터 행 수입니다. 값을 지정하지 않으면 최대값과 기본값은 다음과 같습니다 10000. 쿼리에 행이 더 있는 경우 응답 본문에는 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 포함됩니다. |
| skip | int | 쿼리에서 건너뛸 행 수입니다. 이 매개 변수를 사용하여 큰 데이터 집합을 페이지스합니다. 예를 들어 top=10000 skip=0 처음 10,000개의 데이터 top=10000 행을 검색하고 skip=10000 다음 10,000개의 데이터 행을 검색합니다. |
| 필터 | string | 응답의 행을 필터링하는 하나 이상의 문입니다. 각 필터 문에는 응답 본문의 필드 이름과 연산자와 연결된 eqne값 또는 특정 필드의 경우 연산자가 contains 포함됩니다. 문을 사용하거나 or.를 사용하여 and 결합할 수 있습니다. 문자열 값은 필터 매개 변수에서 작은따옴표로 묶어야 합니다. 필터링할 수 있는 필드 목록과 해당 필드에서 지원되는 연산자는 다음 섹션을 참조하세요. |
| aggregationLevel | string | 집계 데이터를 검색할 시간 범위를 지정합니다. 일, 주 또는 월 문자열 중 하나일 수 있습니다. 값을 지정하지 않으면 기본값은 dateRange입니다. 이 매개 변수는 날짜 필드가 groupBy 매개 변수의 일부로 전달되는 경우에만 적용됩니다. |
| Groupby | string | 지정된 필드에만 데이터 집계를 적용하는 문입니다. |
요청 헤더
자세한 내용은 파트너 센터 REST 헤더를 참조하세요.
요청 본문
없음
요청 예제
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"
}