여백 다운로드

적용 대상: 파트너 센터

적절한 역할: 관리 에이전트

파트너는 지정된 파트너에 대한 활성 여백 목록을 가져올 수 있습니다. 이 메서드는 파트너와 사용 가능한 시작 및 종료 날짜를 기준으로 여백을 반환합니다. 다운로드 여백 은 쉼표로 구분된 형식으로 데이터를 반환합니다.

필수 조건

• 자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.

REST 요청

[GET] /v1/margins/download

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/margins/download?country={countrycode} HTTP/1.1

국가 코드 목록은 공동 판매 국가, 지역, 주 및 지방 코드를 참조 하세요.

URI 매개 변수

이 표에는 필요한 쿼리 매개 변수가 나열됩니다.

속성	Type	필수	설명
country	문자열	Y	값은 국가 코드를 나타내는 문자열입니다.

요청 헤더

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

요청 본문

None

요청 예제

GET https://api.partnercenter.microsoft.com/v1/margins/download?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

REST 응답

성공하면 이 메서드는 가격표를 파일 스트림으로 a.csv 반환합니다.

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

"b82103f870af_e71f19b1-27cf-43d3-be46-3d87a9d908a2","US","Percentage","Test PMC 2 PC","DZH318Z0FTST","HelloWorld3","0002","plan1","Dynamics 365","3b274863-227e-4b2c-a463-330b949e2e34","3pptesting","8.0","","","","","","","","","8/14/2023 6:09:28 PM","10/31/2023 11:59:59 PM","live","8/14/2023 6:09:28 PM"