모든 간접 재판매인 분석 정보 가져오기

아티클
05/29/2024

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

고객에 대한 모든 간접 재판매인 분석 정보를 가져오는 방법입니다.

필수 조건

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

REST 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI 매개 변수

매개 변수	형식	설명
partnerTenantId	string	간접 재판매인 데이터를 검색하려는 파트너의 테넌트 ID입니다.
id	string	간접 재판매인 ID
name	string	간접 재판매인 데이터를 검색할 파트너의 이름입니다.
시장	string	간접 재판매인 데이터를 검색하려는 파트너의 시장입니다.
firstSubscriptionCreationDate	UTC 날짜/시간 형식의 문자열	간접 재판매인 데이터를 검색하려는 첫 번째 구독의 생성 날짜입니다.
latestSubscriptionCreationDate	UTC 날짜/시간 형식의 문자열	최신 구독의 생성 날짜입니다.
firstSubscriptionEndDate	UTC 날짜/시간 형식의 문자열	처음으로 구독이 종료되었습니다.
latestSubscriptionEndDate	UTC 날짜/시간 형식의 문자열	구독이 종료된 최신 날짜입니다.
firstSubscriptionSuspendedDate	UTC 날짜 시간의 문자열	처음으로 구독이 일시 중단되었습니다.
latestSubscriptionSuspendedDate	UTC 날짜/시간 형식의 문자열	구독이 일시 중단된 최신 날짜입니다.
firstSubscriptionDeprovisionedDate	UTC 날짜/시간 형식의 문자열	처음으로 구독 프로비전을 해제했습니다.
latestSubscriptionDeprovisionedDate	UTC 날짜/시간 형식의 문자열	구독이 프로비전 해제된 최신 날짜입니다.
subscriptionCount	double	모든 부가 가치 재판매인의 구독 수
licenseCount	double	모든 부가 가치 재판매인의 라이선스 수입니다.
indirectResellerCount	double	간접 재판매인 수
top	string	요청에서 반환할 데이터 행의 수. 지정하지 않으면 최대값과 기본값은 10,000입니다. 쿼리에 행이 더 있는 경우, 다음 데이터 페이지를 요청하는 데 사용할 수 있는 다음 링크가 응답 본문에 포함됩니다.
skip	int	쿼리에서 건너뛸 행 수. 이 매개 변수를 사용하여 큰 데이터 집합을 페이징합니다. 예를 들어 `top=10000 and skip=0` 처음 10,000개의 데이터 `top=10000 and skip=10000` 행을 검색하고, 다음 10,000개 행의 데이터 등을 검색합니다.
필터링	string	요청의 필터 매개 변수는 응답의 행을 필터링하는 하나 이상의 문을 포함합니다. 각 문에는 또는 `ne` 연산자와 연결된 `eq` 필드와 값이 포함되며, 문을 사용하거나 `or`사용하여 `and` 결합할 수 있습니다. 다음과 같은 필드를 지정할 수 있습니다. partnerTenantId id 이름 시장 firstSubscriptionCreationDate latestSubscriptionCreationDate firstSubscriptionEndDate latestSubscriptionEndDate firstSubscriptionSuspendedDate latestSubscriptionSuspendedDate firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate 예제: `.../indirectresellers?filter=market eq 'US'` 예제: `.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))`
aggregationLevel	문자열	집계 데이터를 검색할 시간 범위를 지정합니다. "day", "week" 또는 "month" 문자열 중 하나일 수 있습니다. 지정되지 않은 경우 기본값은 "day"입니다. `aggregationLevel` 가 지원되지 않습니다 `aggregationLevel`. `aggregationLevel` 에 있는 모든 날짜 필드에 적용됩니다. `aggregationLevel`
orderby	문자열	각 설치에 대한 결과 데이터 값의 순서를 지정하는 문. 구문은 `...&orderby=field[order],field [order],...`입니다. 필드 매개 변수는 다음 문자열 중 하나일 수 있습니다. "partnerTenantId" "id" "name" "market" "firstSubscriptionCreationDate" "latestSubscriptionCreationDate" "firstSubscriptionEndDate" "latestSubscriptionEndDate" "firstSubscriptionSuspendedDate" "latestSubscriptionSuspendedDate" "firstSubscriptionDeprovisionedDate" "latestSubscriptionDeprovisionedDate" "subscriptionCount" "licenseCount" order 매개 변수는 선택 사항이며 각 필드에 대해 오름차순 또는 내림차순을 지정할 수 있습니다 `asc` `desc`. 기본값은 `asc`입니다. 예제: `...&orderby=market,subscriptionCount`
groupby	문자열	지정된 필드에만 데이터 집계를 적용하는 문. 다음과 같은 필드를 지정할 수 있습니다. partnerTenantId ID 이름 시장 firstSubscriptionCreationDate latestSubscriptionCreationDate firstSubscriptionEndDate latestSubscriptionEndDate firstSubscriptionSuspendedDate latestSubscriptionSuspendedDate firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate 반환되는 데이터 행에는 절에 `groupby` 지정된 필드와 다음 필드가 포함됩니다. indirectResellerCount licenseCount subscriptionCount 매개 변수를 `groupby` 매개 변수와 함께 `aggregationLevel` 사용할 수 있습니다. 본보기: `...&groupby=ageGroup,market&aggregationLevel=week`

요청 헤더

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

요청 본문

없음

요청 예제

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/indirectresellers HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST 응답

성공하면 응답 본문에 간접 재판매인 리소스 컬렉션 이 포함됩니다.

응답 성공 및 오류 코드

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

응답 예제

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "1111111",
    "name": "RESELLER NAME",
    "market": "US",
    "firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "firstSubscriptionEndDate": "2018-11-07T00:00:00",
    "latestSubscriptionEndDate": "2018-11-07T00:00:00",
    "firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
    "latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
    "subscriptionCount": 10,
    "licenseCount": 20
}

참고 항목

파트너 센터 분석 - 리소스

다음을 통해 공유