여백 다운로드
적용 대상: 파트너 센터
적절한 역할: 관리 에이전트
파트너는 지정된 파트너에 대한 활성 여백 목록을 가져올 수 있습니다. 이 메서드는 파트너와 사용 가능한 시작 및 종료 날짜를 기준으로 여백을 반환합니다. 다운로드 여백 은 쉼표로 구분된 형식으로 데이터를 반환합니다.
필수 조건
- 자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 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"