.NET SDK 릴리스 정보

다음 릴리스 정보는 새 버전의 Microsoft 파트너 센터 .NET SDK에 사용할 수 있습니다. GitHub에서 .NET SDK 샘플을 찾을 수 있습니다. .NET API 브라우저에서 파트너 센터 .NET API 참조를 찾을 수 있습니다.

Important

2023년 6월 현재 최신 파트너 센터 .NET SDK 릴리스 3.4.0이 보관됩니다. 유용한 정보가 포함된 추가 정보 파일과 함께 GitHub에서 SDK 릴리스를 다운로드할 수 있습니다.

파트너는 파트너 센터 REST API를 계속 사용하는 것이 좋습니다.

버전 3.4.0

이제 Microsoft 파트너 센터 .NET SDK v3.4.0을 사용할 수 있습니다. 업데이트된 GitHub 샘플도 제공됩니다.

다음은 이 버전의 변경 내용입니다.

거래 및 관리

다음 API는 용어 종료 날짜 시간 속성을 제공하도록 업데이트됩니다.

• GetSubscriptionById
• GetAllSubscriptions

Pricing object 는 이제 아래 API 응답에 있습니다.

• OrderLineItem

프로모션

제약 조건 노출:

• GetPromoByID

버전 3.3.0

이제 Microsoft 파트너 센터 .NET SDK v3.3.0을 사용할 수 있습니다. 업데이트된 GitHub 샘플도 제공됩니다.

다음은 이 버전의 변경 내용입니다.

거래 및 관리

고객이 손상된 경우(사기 행위) Azure 구독 취소를 사용하도록 다음 API가 업데이트됩니다.

• Azure 플랜 - 구독 및 리소스 관리
• Azure 구독 취소 - 파트너 센터 앱 개발자
• Azure 지출 - Azure 자격 취소 - REST API(파트너 센터 Rest)
• 구독에 대한 Azure 자격 가져오기 - 파트너 센터 앱 개발자
• Azure 지출 - 구독에 대한 Azure 자격 가져오기 - REST API(파트너 센터 Rest)

'OperationId'는 이제 아래 API 응답에 있습니다.

• 새 상거래 구독 전환 - 파트너 앱 개발자
• 이전에 전환된 새 상거래 구독에 대한 전환 기록을 가져옵니다. - 파트너 앱 개발자

새 GDAP 오류 메시지:

• 구독 전환 - 파트너 앱 개발자
• 새 상거래 구독 전환 - 파트너 앱 개발자
• 구독 프로비저닝 상태 가져오기 - 파트너 앱 개발자

감사

다음을 위해 새 리소스 종류 'AzureEntitlement' 및 'IndirectProviderIndirectResellerDap'가 추가되었습니다.

• 리소스 감사
• Dotnet Latest

버전 3.2.0

이제 Microsoft 파트너 센터 .NET SDK v3.2.0이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다.

다음은 이 버전의 변경 내용입니다.

.NET SDK v 3.2.0을 사용하려면 파트너에게 Newtonsoft.Json 13.0.1 이상이 있어야 합니다. v13.0.1 이전 버전에는 취약한 버그가 높습니다.

새 API 계약

다음 API는 NCE 마이그레이션 일정을 지원하기 위해 도입되었습니다.

• 새 상거래 마이그레이션 예약
• 새 상거래 마이그레이션 취소
• 새 상거래 마이그레이션 업데이트
• 새 상거래 마이그레이션 받기

API 계약에 업데이트

• Qualifications API - "EducationSegment", "Website", "ValidationCode" 의 세 가지 새 필드로 공개 계약을 업데이트하여 고객의 자격 업데이트

• 유효성 검사 상태 - "lastUpdateDatetime"이 DateTime에서 문자열 검색 유효성 검사 상태 변경됨

• 셀프 서비스 정책 - 권한 개체 에서 리소스에 대해 지원되는 새 값 "AzureSavingsPlan" 셀프 서비스 정책 만들기

• 마이그레이션 - "customTermEndDate" 필드 소개 새 상거래 마이그레이션 만들기

• 구독 리소스 -새 "BillingCycleEndDate" 특성이 구독 리소스를 추가 했습니다.

• 새 오류 유형 "NoPromotionsAvailableEligibilityError"를 추가하고 "SeatCountPromotionEligibilityError"에 "AvailableSeats" 속성을 추가했습니다. 프로모션 자격 확인

버전 3.1.2

이제 Microsoft 파트너 센터 .NET SDK v3.1.2가 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

공개 계약에 업데이트

개체에 AddOnMigrations 필드를 추가했습니다.NewCommerceEligibility
마이그레이션에 대한 구독 유효성 검사

버전 3.1.1

Important

3.1.0 버전은 더 이상 사용되지 않습니다. .NET SDK v.3.1.0을 다운로드하지 마세요.

이제 Microsoft 파트너 센터 .NET SDK v3.1.1이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

거래 및 관리

공개 계약의 새 필드

예약된 변경에 승격 ID 추가
새 상거래 구독에 대한 예약된 변경 내용 관리

• Patch {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}

구독 상태 값 'disabled'에 대한 새 SDK 지원

• 구독 리소스
• 구독 수명 주기 상태

파트너 센터 API는 v3.1.1 SDK 릴리스로부터 90일 후에 새 '사용 안 함' 상태를 반환하기 시작합니다. 파트너는 API가 '사용 안 함' 상태를 반환하기 90일 전에 SDK를 업데이트하고 변경 관리 원칙을 준수할 시간을 제공합니다.

새 API 업데이트

마이그레이션된 구독 쿼리 는 파트너가 지정된 입력 조건에 대해 마이그레이션된 모든 하위를 쿼리할 수 있는 API입니다.

• GET {baseURL}/v1/migrations/newcommerce

새 상거래 마이그레이션 이벤트 가져오기 API는 현재 구독 ID 또는 마이그레이션 ID를 기반으로 마이그레이션 이벤트의 세부 정보를 가져오는 데 사용됩니다.

• GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events

버전 3.0.1

이제 Microsoft 파트너 센터 .NET SDK v3.0.1이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

거래 및 관리

공개 계약의 새 필드

• POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
• GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
• GET/PATCH {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}
  • 모델에 속성 추가됨 RefundableQuantitySubscription
  • 모델에 속성 추가됨 CustomTermEndDateScheduledNextTermInstructions
  • 모델에 속성 추가됨 MigratedFromSubscriptionIdSubscription
• POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
  • 모델에 속성 추가됨 AddOnMigrationsNewCommerceMigration
• POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
  • 모델에 속성 추가됨 AddOnMigrationsNewCommerceMigration
• GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
  • 모델에 속성 추가됨 AddOnMigrationsNewCommerceMigration
• POST {baseURL}/v1/customers/{customer_id}/carts
  • 새 CartErrorCode 열거형 값이 추가됨
  • 모델에 새 AdditionalInformation 모델 CartError 추가됨
  • 모델에 속성 추가됨 CustomTermEndDateCartLineItem
• GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
  • 새 CartErrorCode 열거형 값이 추가됨
  • 모델에 새 AdditionalInformation 모델 CartError 추가됨
  • 모델에 속성 추가됨 CustomTermEndDateCartLineItem
• GET/POST {baseURL}/v1/customers/{customer_id}/orders
  • 모델에 속성 추가됨 CustomTermEndDateOrderLineItem
• GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
  • 모델에 속성 추가됨 CustomTermEndDateOrderLineItem

NCE 일괄 처리 마이그레이션 도구

파트너가 대량의 구독을 효율적으로 마이그레이션할 수 있도록 BAM(Batch Migration) 도구를 사용하도록 설정했습니다. BAM 도구를 사용하면 파트너가 다음 방법을 사용하여 구독을 NCE로 마이그레이션할 수 있습니다.

• 간소화된 오픈 소스 .NET SDK 샘플 앱 환경
• Excel을 사용하여 마이그레이션 편집 관리
• 일괄 처리로 고품질, 반복 가능 및 사용자 지정 가능한 마이그레이션 시나리오를 지원하는 간단한 도구

자세한 지침은 BAM(New Commerce Experience Batch Migration Tool)을 참조하세요.

보안

새 API

• {baseURL}/v1/customers/{customer-tenant-id} 패치
  • DAP API 제거 – DAP 집합 AllowDelegatedAccess 속성을 false로 제거하려면

감사 및 웹후크

업데이트된 감사 - "초과분 관리", "Microsoft에서 종료한 DAP 관리 관계" 및 "Azure 사기 이벤트 감지됨"에 대한 새 작업 유형이 추가되었습니다.

리소스 감사

버전 3.0.0

이제 Microsoft 파트너 센터 .NET SDK v3.0.0이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

일반 업데이트

System.ComponentModel.Annotations를 최신 5.0 버전으로 업그레이드하여 기존 호환성 문제를 해결합니다.

거래 및 관리

새 API

• POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
• POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
• GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
• GET {baseURL}/customers/{customerId}/subscriptions/overage

공개 계약의 새 필드

• 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
• POST/PUT {baseURL}/v1/customers/{customer-tenant-id}/cart
• POST {baseURL}/v1/customers/{customer-tenant-id}/orders
• PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id}

카탈로그/가격/프로모션

새 API

• POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
• GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
• GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}

공개 계약의 새 필드

• GET {baseURL}/v1/offers/{offer-id}?country={country-code}
• 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?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}

고객

새 API

• GET {baseURL}/v1/customers/{customer-id}/validationStatus?type=account

감사 및 웹후크

업데이트된 감사 - SoftwareAttestation 추가 및 디바이스 및 정책 추가 업데이트 대한 새 작업 유형 추가

감사 리소스 - 파트너 센터 앱 개발자 | Microsoft Docs

• 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?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}
• PUT {baseURL}/customers/{customerId}/subscriptions/overage
• GET {baseURL}/customers/{customerId}/subscriptions/overage

버전 2.0.1

이제 Microsoft 파트너 센터 .NET SDK v2.0.1이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

참고 항목

Microsoft 365/Microsoft Dynamics 365 새 상거래 환경 기술 미리 보기의 일부인 파트너에 대한 초대를 기반으로 현재 제공되는 새로운 상거래 환경("NCE")의 일부로 도입된 일부 변경 내용입니다. 새 상거래 프라이빗 미리 보기에 속하지 않는 파트너는 영향을 받지 않아야 하며 이전 버전과 호환되어야 합니다.

공통

• 인증 라이브러리에 대한 참조 변경 - 참조가 ADAL(Azure Active Directory 인증 라이브러리)에서 MSAL(Microsoft 인증 라이브러리)으로 변경됨

  MSAL이 애플리케이션 또는 .NET 샘플에서 올바르게 실행되도록 다음을 변경해야 합니다.

  • Mobile 및 데스크톱 애플리케이션용 RedirectUrl로 추가 https://login.microsoftonline.com/common/oauth2/nativeclient

  • 애플리케이션 구성 파일의 UserAuthentication 섹션에 Do기본 추가합니다.

    기본 Azure AD 애플리케이션이 만들어진 Azure Active Directory do기본 또는 테넌트 ID입니다.

• 오류 코드 – 새 오류 코드가 추가됨

  • 408: 요청 시간 제한
  • 504: 게이트웨이 시간 제한

청구 관리

• 청구서 품목 - 다음 API에 추가된 새 특성:

  • GET /invoices/{invoice-id}/lineitems?provider={provider}&invoicelineitemtype=billinglineitems
  • GET /invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=billinglineitems

  새 특성:

  • productQualifiers
  • subscriptionStartDate
  • subscriptionEndDate
  • referenceId
  • creditReasonCode(NCE에만 해당)
  • promotionId

• 일일 등급 사용 현황 라인 항목 – 다음 API에 추가된 새 특성:

  • GET /invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems

  새 특성:

  • hasPartnerEarnedCredit(NCE에만 적용 가능)
  • creditType(NCE에만 해당)
  • rateOfCredit(NCE에만 적용 가능)

주문 관리

• 구독 리소스 – 새 속성이 추가되었습니다.

  • CancellationAllowedUntilDate - (NCE에만 해당)

• 전환 리소스(NCE에만 해당) – 새 속성이 추가됨

  • FromSubscriptionId

고객 계정 관리

• 주소 유효성 검사 – 응답이 부울에서 API의 새 모델로 변경됩니다.

  • POST /validations/address

  새 응답 모델:

  • AddressValidationResponse

• 고객의 자격 동기 API는 더 이상 사용되지 않습니다.

버전 1.17.0

이제 Microsoft 파트너 센터 .NET SDK v1.17.0이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

• 업데이트된 감사 - 고객이 DAP를 승인하고 종료한 시기를 알 수 있는 새 작업 유형이 추가됨

  • Dap관리RelationshipApproved
  • Dap관리RelationshipTerminated

• 업데이트된 감사 – 고객 디렉터리 역할 시나리오를 지원하기 위한 새 리소스 및 작업 유형 추가

  • 리소스 종류 "CustomerDirectoryRole"
  • 작업 유형 "AddUserMember" 및 "RemoveUserMember"

• 고객 계정에 SDK 업데이트 - 다음 API 지원

  • GET /customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus
  • GET /customers/{customer-tenant-id}/qualifications
  • POST /customers/{customer_id}/qualifications?code={validationCode}

• 현재 Microsoft 365/Microsoft Dynamics 365 새 상거래 환경 기술 미리 보기의 일부인 파트너에게만 초대를 기반으로 제공되는 새 상거래의 일부로 도입된 변경 내용입니다. 새 상거래 프라이빗 미리 보기에 속하지 않는 파트너는 영향을 인식하지 않아야 하며 이전 버전과 호환되어야 합니다.

  • 카탈로그 변경 내용:
    • GET /products/{product-id}/skus/{sku-id}
  • 구매 및 관리:
    • GET /customers/{customerId}/subscriptions
    • GET /customers/{customerId}/subscriptions/{subscriptionId}
    • PATCH /customers/{customerId}/subscriptions/{subscriptionId}
    • GET /customers/{customerId}/subscriptions/{subscriptionId}/transitioneligibilities
    • GET /customers/{customerId}/subscriptions/{subscriptionId}/transitions
    • POST /customers/{customerId}/subscriptions/{subscriptionId}/transitions

버전 1.16.3

이제 Microsoft 파트너 센터 .NET SDK v1.16.3이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

• SelfServePolicies - 새 기능 추가

  • GetSelfServePolicies
  • GetListOfSelfServicePolicies
  • CreateSelfServePolicies
  • UpdateSelfServePolicies
  • DeleteSelfServePolicies

• 고객 회사 프로필

  • OrganizationRegistrationNumber 추가

• CustomerBillingProfile.DefaultAddress

  • MiddleName 추가

버전 1.16.2

Microsoft 파트너 센터 .NET SDK v1.16.2는 이제 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

• 감사 레코드를 지원하는 작업 유형이 업데이트되었습니다. 새로 추가된 항목은 다음과 같습니다.

  • CreateSelfServePolicy
  • UpdateSelfServePolicy
  • DeleteSelfServePolicy
  • RemovePartnerRelationship
  • DeleteTipCustomer
  • CreateRelatedReferral
  • UpdateRelatedReferral

• 서비스 요청 만들기는 이제 사용되지 않습니다.

• 지원 토픽은 이제 사용되지 않습니다.

버전 1.16.1

이제 Microsoft 파트너 센터 .NET SDK v1.16.1이 일반 공급됩니다. 업데이트된 GitHub 샘플도 제공됩니다. 다음은 이 버전의 변경 내용입니다.

기존 Microsoft 파트너 센터 SDK를 .NET Framework에서 .NET Standard 2.0 플랫폼으로 마이그레이션했습니다. 이 마이그레이션을 통해 SDK는 .NET Framework 4.6.1 이상을 사용하여 기존 애플리케이션과 호환됩니다. SDK는 .NET Core 2.0 이상을 지원합니다. 기존 애플리케이션으로 이식하기 전에 .NET 구현 지원을 확인합니다.

버전 1.15.3

Microsoft 파트너 센터 .NET SDK v1.15.3은 이제 일반 공급됩니다. 업데이트된 REST API 및 GitHub 샘플 도 사용할 수 있습니다. 다음은 이 버전의 변경 내용입니다.

• 파트너 계약
  • 간접 공급자가 간접 재판매인의 Microsoft 파트너 계약 상태 확인하는 기능이 추가되었습니다.
• 제품
  • 다음 두 인터페이스가 Microsoft.Store.PartnerCenter.Products 네임스페이스 아래에 잘못 배치되었습니다. 이제 Microsoft.Store.PartnerCenter.Customers.Products 네임스페이스 아래에 있습니다.
    • ICustomerProductByReservationScope
    • ICustomerSkuByReservationScope