파트너 센터 REST API의 최근 변경 내용

아티클
12/21/2023

이 문서에서는 파트너 센터 REST API에 대한 변경 내용을 요약합니다.

2022년 11월

기능 영역	변경 유형	API/개체
NCE 마이그레이션	이제 파트너는 API, UX 및 BAM 도구를 사용하여 마이그레이션을 예약할 수 있습니다.	새 상거래 마이그레이션 예약 새 상거래 마이그레이션 취소 새 상거래 마이그레이션 업데이트 새 상거래 마이그레이션 새 상거래 환경 일괄 마이그레이션 도구 가져오기

2022년 10월

API 변경은 새로운 기능을 지원하고 benefitOrderId, benefitId 및 benefitType 필드를 청구 및 청구되지 않은 일일 등급 사용량 현황 데이터에 추가합니다.

기능 영역	변경 유형	API/개체
셀프 서비스 정책 향상	Azure 저축 계획에 대한 새로운 셀프 서비스 정책 지원.	셀프 서비스 정책 만들기 셀프 서비스 정책 목록 가져오기 셀프 서비스 정책셀프 서비스 정책 리소스 셀프 서비스 정책 업데이트 셀프 서비스 정책 업데이트
청구된 일일 정격 사용량 현황 데이터	청구된 일일 등급 사용량 API에 benefitOrderId, benefitId 및 benefitType 필드를 추가합니다.	청구서 청구 상용 소비 품목 가져오기
청구되지 않는 일일 등급 사용량 현황 데이터	청구되지 않은 일일 등급 사용량 API에 benefitOrderId, benefitId 및 benefitType 필드를 추가합니다.	청구서 청구되지 않은 상업용 소비 품목 가져오기

2022년 9월

PI 변경으로 필드 firstObserved 및 lastObserved를 사기 이벤트에 추가합니다.

기능 영역	변경 유형	API/개체
NCE 마이그레이션	CustomTermEndDate가 마이그레이션 API에 추가됨	새 상거래 마이그레이션 만들기
Azure 사기 행위 알림	사기 이벤트에 firstObserved 및 lastObserved 필드 추가	사기 이벤트 가져오기

2022년 7월

API 변경은 새로운 기능을 지원합니다.

기능 영역	변경 유형	API/개체
승격을 사용하여 예약된 변경 내용	예약된 변경 내용이 사용 가능한 승격에 부합하는 경우 프로모션 ID를 표시합니다.	예약된 변경 내용 만들기

2022년 6월

API 변경은 NCE 마이그레이션을 사용하는 파트너를 지원합니다.

기능 영역	변경 유형	API/개체
마이그레이션 유효성 검사	새 상거래 환경으로 마이그레이션하기 위한 구독의 유효성을 검사하는 새 API	마이그레이션에 대한 구독 유효성 검사
새 마이그레이션 만들기	새 상거래 환경으로 구독 마이그레이션을 만드는 새 API	새 상거래 마이그레이션 만들기
새로운 상거래 구독 마이그레이션 받기	마이그레이션 상태 검사 위해 새 상거래 환경으로 구독을 마이그레이션하는 새 API	새로운 상거래 구독 마이그레이션 받기

2022년 5월

API 변경은 파트너가 DAP를 모니터링하고 비활성 DAP를 제거할 수 있도록 지원합니다.

기능 영역	변경 유형	API/개체
DAP 제거	더 이상 관리할 필요가 없는 고객과의 DAP(위임된 관리자) 관계를 제거합니다.	고객과 DAP 관계 제거
위임된 관리 관계 나열	파트너가 DAP/비 DAP 관계가 있는지 여부를 나타내는 파트너의 모든 고객 목록을 반환하는 새 API	위임된 관리 고객 나열
위임된 관리 통계 가져오기	모든 고객의 파트너와 연결된 DAP(위임된 관리자) 관계 또는 활성 관계에 대한 정보를 반환합니다.	위임된 관리 통계 가져오기

2022년 3월

3월 변경 사항에는 새로운 상거래 라이선스 기반 기능을 지원하기 위한 향상된 기능이 포함됩니다.

기능 영역	변경 유형	API/개체
DAP 제거	더 이상 관리할 필요가 없는 고객과의 DAP(위임된 관리자) 관계를 제거합니다.	고객과 DAP 관계 제거
새 상거래 카트	CartLineItem 응답에 대해 availableQuantity가 추가됨	프로모션 리소스
새 상거래 전환	전환 응답에 promotionId 추가	리소스 전환

2021년 12월

12월 변경 사항에는 새로운 상거래 라이선스 기반 기능을 지원하기 위한 향상된 기능이 포함됩니다.

기능 영역	변경 유형	API/개체
새로운 상거래 프로모션	좌석 수에 availableSeats 추가	프로모션 리소스
새로운 상거래 프로모션	좌석 수에 availableSeats 추가	POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
Azure 사기 행위 알림	새 API	사기 이벤트 가져오기
Azure 사기 행위 알림	새 API	사기 이벤트 업데이트 상태
새 상거래 구독	ID API별 구독 가져오기에 refundableQuantity 추가	ID별 구독 가져오기

2021년 10월

10월의 변경 사항은 새로운 상거래 라이선스 기반 기능과 CSP 에 대한 새로운 ISV 마진 할인을 지원하기 위한 것입니다.

기능 영역	변경 유형	API/개체
새 상거래 구독 관리	공개 계약의 새 필드	PATCH {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}
새 상거래 업그레이드 및 평가판 변환	공개 계약의 새 필드	POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
새로운 상거래 전환	공개 계약의 새 필드	GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
새 상거래로 마이그레이션	새 API	POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
새 상거래로 마이그레이션	새 API	POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
새 상거래로 마이그레이션	새 API	GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
새 상거래 구매	공개 계약의 새 필드	POST {baseURL}/v1/customers/{customer-id}/orders"
새 상거래 구매	공개 계약의 새 필드	POST{baseURL}/v1/customers/{customer-id}/carts
새 상거래 구매	공개 계약의 새 필드	PUT{baseURL}/v1/customers/{customer-id}/carts/{cart-id}
새로운 상거래 프로모션	새 API	POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
새로운 상거래 프로모션	새 API	GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
새로운 상거래 프로모션	새 API	GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}
새로운 상거래 프로모션	새 리소스	프로모션 리소스
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}?country={country}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}
새 상거래에 대한 카탈로그 업데이트	공개 계약의 새 필드	제품 리소스
CSP에 대한 ISV 마진 할인	새 리소스	여백 리소스
CSP에 대한 ISV 마진 할인	새 API	GET {baseURL}/v1/margins
CSP에 대한 ISV 마진 할인	새 API	GET {baseURL}/v1/margins/download
새로운 상거래에서 텔코 종량제	새 API	PUT {baseURL}/customers/{customerId}/subscriptions/overage
새로운 상거래에서 텔코 종량제	새 API	GET {baseURL}/customers/{customerId}/subscriptions/overage
새로운 상거래에서 텔코 종량제	공개 계약의 새 필드	Sku 모델에 ConsumptionType 추가

2021년 7월

7월의 변경 사항은 일부 Windows 365 SKU에만 필요한 Windows 365 증명을 지원하기 위한 것이었습니다.

기능 영역	변경 유형	API/개체
Windows 365 증명	공개 계약의 새 필드	Sku 리소스
Windows 365 증명	공개 계약의 새 필드	제품 리소스
Windows 365 증명	공개 계약의 새 필드	카트 품목 리소스
Windows 365 증명	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
Windows 365 증명	공개 계약의 새 필드	GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
Windows 365 증명	공개 계약의 새 필드	PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id} HTTP/1.1

2020년 12월

두 개의 새로운 GET 및 POST 자격 API가 도입되었습니다. 새 API는 한정이 아닌 한정자를 사용합니다. API는 FY21 Q2에서 테스트에 사용할 수 있습니다.

기능 영역	변경 유형	API/개체
고객 자격	새 API	GET {baseURL}/v1/customers/{customer-tenant-id}/qualifications
고객 자격	새 API	POST {baseURL}/v1/customers/{customer_id}/qualifications?code={validationCode}

무엇이 변경되었습니까?

현재 파트너 센터 API에는 교육 고객의 자격을 확인하기 위한 GET 및 PUT 자격이 있습니다. GET Qualification API는 변경되지 않습니다. 그러나 PUT Qualification API에 반환 사례를 추가했습니다.

GET - 변경되지 않습니다.
PUT - 반환 사례가 추가됩니다.

이러한 API는 2021년 2월 말에 사용 중지되며 아래 설명된 대로 새 API로 대체됩니다.

영향을 받은 시나리오:

선택한 SKU의 교육 가격 책정에 대한 고객 자격

세부 정보 설명

두 개의 새로운 GET 및 POST 자격 API가 도입됩니다. 새 API는 한정이 아닌 한정자를 사용합니다. API는 FY21 Q2에서 테스트에 사용할 수 있습니다.

GET 자격

GET {customer_id}/qualifications

응답 예제:

{
  "Qualification": "Education",
  "VettingStatus": "Denied",
  "VettingReason": "Not an education customer",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

응답 필드:

VettingStatus 값: 승인됨, 거부됨, InReview 등
VettingReason 값:
- 교육 고객이 아님
- 더 이상 교육 고객이 아닙니다.
- 교육 고객이 아님 - 검토 후
- 교육 고객으로 제한됨
- 학문이 아닙니다기본
- 적격 라이브러리가 아님
- 적격 박물관이 아닙니다.

POST 자격

POST {customer_id}/qualifications
    [
            "Qualification": "Education"
    ]

응답 예제:

{
  "Qualification": "Education",
  "VettingStatus": "InReview",
  "VettingCreatedDate": "07/09/2020: 00:00:00" //UTC
}

다음 단계

파트너 센터 REST API 참조

파트너 센터 REST API의 최근 변경 내용

2022년 11월

2022년 10월

2022년 9월

2022년 7월

2022년 6월

2022년 5월

2022년 3월

2021년 12월

2021년 10월

2021년 7월

2020년 12월

무엇이 변경되었습니까?

영향을 받은 시나리오:

세부 정보 설명

GET 자격

응답 예제:

응답 필드:

POST 자격

응답 예제:

다음 단계

피드백

피드백

추가 리소스