가격표 가져오기

이 문서에서는 지정된 시장 및 보기에 대한 가격표를 가져오는 방법을 설명합니다. 이 메서드는 월별 기록을 가져오는 필터를 지원합니다.

필수 조건

• 자격 증명은 파트너 API 인증에 설명되어 있습니다. 이 시나리오는 애플리케이션 사용자 인증만 지원합니다. 애플리케이션 전용은 아직 지원되지 않습니다. http 오류:400이 발생하는 파트너는 파트너 API 인증 설명서를 참조해야 합니다.
• 이 API는 현재 파트너가 전역 관리, 관리 에이전트 또는 판매 에이전트 역할 중 하나에 있어야 하는 사용자 액세스만 지원합니다.

세부 정보

• 현재는 Azure 플랜 사용량 및 예약, 라이선스 기반(새 상거래 환경) 및 Marketplace 제품에 대한 데이터만 반환합니다.
• 현재 가격에는 API가 호출된 날짜까지 현재 월 동안 사용할 수 있는 모든 미터 및 제품이 포함됩니다. 이전 달에는 지정된 월에 사용할 수 있는 모든 미터 및 제품이 포함됩니다.
• 소비량 측정기 가격은 USD에 불과하며, 파트너는 환율 API를 사용하여 현지 통화 비용을 계산해야 합니다.
• 소비량 측정기 가격은 예상 소매 가격입니다. 파트너 할인은 파트너 획득 크레딧을 통해 사용할 수 있습니다.
• 예약 미터 가격에는 CSP 파트너 할인이 포함됩니다. 예약의 예상 소매 가격은 파트너 센터 "가격 책정 및 제품" 페이지에서 다운로드할 수 있는 예약 공유 서비스에서 찾을 수 있습니다.
• Azure 플랜 가격 책정에 대한 자세한 내용은 Azure 플랜 가격 책정 설명서에서 확인할 수 있습니다.
• 파트너 가격 책정 및 환율 API는 파트너 센터 SDK의 일부가 아닙니다.
• 이 메서드는 가격표를 파일 스트림으로 반환합니다. 파일 스트림은 .csv 파일 또는 압축된 .csv 버전입니다. 압축된 파일을 요청하는 방법에 대한 세부 정보는 아래에 포함되어 있습니다.

REST 요청

요청 구문

메서드	요청 URI
GET	https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value

URI 필수 매개 변수

다음 경로 매개 변수를 사용하여 원하는 가격표의 시장 및 유형을 요청합니다.

속성	Type	필수	설명
시장	string	예	요청되는 시장에 대한 두 개의 문자 국가/지역 코드
PricesheetView	string	예	요청되는 가격표의 유형으로, azure_consumption, azure_reservations, updatedlicensebased, marketplace 또는 소프트웨어일 수 있습니다.

참고 항목

updatelicensebased PriceSheetView는 현재 Microsoft 365/Microsoft Dynamics 365 새로운 상거래 환경 기술 미리 보기의 일부인 파트너만 사용할 수 있습니다.

참고 항목

소프트웨어 가격표는 2022년 4월 1일부터 API를 통해 사용할 수 있습니다.

URI 필터 매개 변수

다음 필터 매개 변수를 사용합니다.

속성	Type	필수	설명
타임라인	string	아니요	전달되지 않은 경우 기본값은 현재로 설정됩니다. 가능한 값은 기록, 현재 및 미래입니다.
Month	string	아니요	기록이 요청된 경우에만 필수이며 요청되는 가격표에 대해 YYYYMM을 준수해야 합니다.

참고 항목

Marketplace에서는 향후 가격 책정이 지원되지 않습니다. 2022년 4월 1일부터 파트너는 2022년 3월부터 API를 통해 소프트웨어 가격표 기록을 볼 수 있습니다.

요청 헤더

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

위의 헤더 외에도 가격 책정 파일을 압축된 것으로 검색하여 대역폭 및 다운로드 시간을 줄일 수 있습니다. 기본적으로 파일은 압축되지 않습니다. 압축된 버전의 파일을 얻으려면 아래 헤더 값을 포함할 수 있습니다. 압축 시트는 2020년 4월부터만 사용할 수 있으며, 2020년 4월 이전의 모든 시트는 압축되지 않은 것으로만 사용할 수 있습니다.

헤더	값 유형	값	설명
Accept-Encoding	string	폐	선택 사항. 생략된 파일 스트림이 압축되지 않은 경우

요청 예시

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com

새 상거래에 대한 요청 예제

참고 항목

updatelicensebased PriceSheetView는 현재 Microsoft 365/Microsoft Dynamics 365 새로운 상거래 환경 기술 미리 보기의 일부인 파트너만 사용할 수 있습니다.

GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com

REST 응답

성공하면 이 메서드는 가격표를 파일 스트림으로 반환합니다. 파일 스트림은 .csv 파일 또는 압축된 .csv 버전입니다.

새 상거래에 대한 응답 예제

참고 항목

updatelicensebased PriceSheetView는 현재 Microsoft 365/Microsoft Dynamics 365 새로운 상거래 환경 기술 미리 보기의 일부인 파트너만 사용할 수 있습니다.

HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT

"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============

응답 성공 및 오류 코드

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

새 상거래 사용이 허가된 미래 가격표에 대한 변경 사항이 없는 경우 향후 가격표가 반환되지 않습니다. updatedlicensebased PriceSheetView에 대해 요청된 타임라인으로 미래를 전달할 때 파트너는 다음 API 응답 코드인 404 찾을 수 없음을 확인합니다.

다음 단계

• 제품 매트릭스 가져오기