고객 프라이빗 제품으로 직접 ISV 만들기
이 방법을 사용하여 고객에게 ISV로 직접 프라이빗 제품을 만듭니다.
요청
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | 문자열 | 필수입니다. 형식 Bearer <token>의 Microsoft Entra 액세스 토큰입니다. |
선택 사항: 클라이언트 ID
요청 매개 변수
$version - 필수입니다. 요청에 사용되는 스키마의 버전입니다.
요청 본문
ISV에서 고객 프라이빗 제품 스키마로 프라이빗 제품의 세부 정보를 제공합니다. 여기에는 이름이 포함되어야 합니다.
다음 옵션은 고객에 대한 프라이빗 제품을 만들 때 파트너 센터의 옵션을 반영합니다. 옵션은 여기에 나열된 offerPricingType 값으로 정의됩니다.
| offerPricingType 값 | 파트너 센터 프라이빗 제품 생성 옵션에 해당 |
|---|---|
| editExistingOfferPricingOnly | 기존 퍼블릭 제품 및 플랜에 대한 가격 책정 사용자 지정 - SaaS, Azure Virtual Machines 및 Azure 애플리케이션 거래 가능한 모든 제품 유형에 대한 프라이빗 제품을 만들려면 이 옵션을 사용합니다. 절대 가격 책정 또는 백분율 할인을 통해 파트너 가격을 사용자 지정할 수 있습니다. |
| saasNewCustomizedPlans | SaaS 제품에 대한 가격 책정, 미터 수량 및 사용자 제한 사용자 지정 - 절대 파트너 가격, 계량 차원 수량 및 사용자 제한을 사용자 지정하여 SaaS 플랜에 대한 프라이빗 제품을 만들려면 이 옵션을 사용합니다. |
| vmSoftwareReservations | VM 소프트웨어 예약 제품에 대한 가격 책정 및 특정 수량 사용자 지정 - 이 옵션을 사용하여 VM 소프트웨어 예약(1년 또는 3년)을 판매하고 절대 파트너 가격, vCPU 크기, 수량, 기간 및 결제 일정을 사용자 지정하는 다중 파티 프라이빗 제품을 만듭니다. |
이전 세 가지 가격 책정 유형 옵션의 경우 계획별 리소스 요구 사항이 다를 수 있습니다. 자세한 내용은 다음 표를 참조하세요.
| 리소스 이름 | editExistingOfferPricingOnly | saasNewCustomizedPlans | vmSoftwareReservations |
|---|---|---|---|
| 가격. 계획 | 요청 본문에서 구성할 공용 계획의 계획 ID로 설정합니다. | 해당 없음 | 해당 없음 |
| pricing.basePlan | 해당 없음 | 요청 본문에서 구성할 공용 계획의 계획 ID로 설정합니다. | 요청 본문에서 구성할 공용 계획의 계획 ID로 설정합니다. |
| pricing.newPlanDetails.name | 해당 없음 | 요청 본문에서 고객에게 표시될 새 플랜의 이름으로 설정합니다. | 요청 본문에 적용되지 않습니다. 시스템이 생성되고 완료되면 작업의 응답에서 사용할 수 있습니다. |
| pricing.newPlanDetails.description | 해당 없음 | 요청 본문의 새 플랜에 대해 고객에게 표시될 설명으로 설정합니다. | 요청 본문에는 적용되지 않으며, 완료되면 시스템이 생성되고 작업의 응답에서 사용할 수 있습니다. |
요청 본문 샘플
할인 가격을 사용하여 기존 공용 요금제에 대한 가격 책정만 사용자 지정하는 샘플 요청 본문
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "editExistingOfferPricingOnly",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA ",
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{ "product": "product/34771906-9711-4196-9f60-4af380fd5042", "plan":"plan/123456","discountType": "percentage", "discountPercentage": 5 }
]
}
]
}
절대 가격을 사용하여 기존 공용 계획에 대한 가격 책정만 사용자 지정하는 샘플 요청 본문
백분율 기반 할인 대신 절대 가격을 사용하는 경우:
- 절대 가격을 정의하는 프라이빗 제품 리소스 위에 새 리소스 만들기
- 새로 만든 리소스를 구성 스키마의 리소스 목록에 다른 개체로 포함합니다.
이 방법을 사용하여 기존 공용 플랜에 대한 가격 책정 리소스를 가져오고 가격 책정을 편집한 다음 프라이빗 제품에 대해 편집된 리소스를 사용합니다.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
샘플 절대 가격 책정 리소스
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newSimpleAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"offerPricingType": "editExistingOfferPricingOnly",
"plan": "plan/987654",
"pricing": {
"recurrentPrice": {
"priceInputOption": "usd",
"prices": [
{
"pricePerPaymentInUsd": 1,
"billingTerm": {
"type": "month",
"value": 1
}
},
{
"pricePerPaymentInUsd": 2,
"paymentOption": {
"type": "month",
"value": 1
},
"billingTerm": {
"type": "year",
"value": 1
}
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"meter1": {
"pricePerPaymentInUsd": 1
}
}
}
}
}
가격 책정 모듈에 해당 리소스를 개체로 포함
[
{
"product": "product/34771906-9711-4196-9f60-4af380fd5042",
"plan": "plan/123456",
"discountType": "percentage",
"discountPercentage": 5
},
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/987654",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newSimpleAbsolutePricing"
}
}
]
절대 가격을 사용하여 SaaS 제품에 대한 가격 책정, 계량 수량 및 사용자 제한을 사용자 지정하는 샘플 요청 본문
다음 방법을 사용하여 제품에 대한 절대 가격 및 가용성 리소스를 만듭니다.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
가격 및 미터 수량을 사용자 지정하는 정액 SaaS 제품에 대한 샘플 절대 가격 책정 리소스
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"resourceName": "newSaaSPlanAbsolutePricing",
"plan": "plan/ 123456",
"offerPricingType": "saasNewCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "flatRate",
"priceInputOption": "usd",
"prices": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.1
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.12
}
]
},
"customMeters": {
"priceInputOption": "usd",
"meters": {
"meter1": {
"includedQuantities": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"quantity": 10.0,
"isInfinite": false
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"quantity": 15.0,
"isInfinite": false
}
]
},
"meter2": {
"includedQuantities": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"isInfinite": true
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"isInfinite": true
}
]
}
}
}
}
}
가격 및 사용자 제한을 사용자 지정하는 사용자별 SaaS 제품에 대한 샘플 절대 가격 책정 리소스
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newSaaSPlanAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"plan": "plan/123456",
"offerPricingType": "saasNewCustomizedPlans",
"pricing": {
"recurrentPrice": {
"recurrentPriceMode": "perUser",
"priceInputOption": "usd",
"userLimits": {
"min": 20,
"max": 100
},
"prices": [
{
"billingTerm": {
"type": "month",
"value": 1
},
"paymentOption": {
"type": "month",
"value": 1
},
"pricePerPaymentInUsd": 0.01
},
{
"billingTerm": {
"type": "year",
"value": 1
},
"paymentOption": {
"type": "year",
"value": 1
},
"pricePerPaymentInUsd": 0.02
}
]
}
}
}
가격 책정 모듈에 해당 리소스를 개체로 포함
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "saasNewCustomizedPlans",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA",
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newSaaSPlanAbsolutePricing"
}
"basePlan": "plan/123456",
"newPlanDetails": {
"name": "newPlanName",
"description": "newPlanDescription"
}
]
}
]
}
절대 가격을 사용하여 VM 소프트웨어 예약 제품에 대한 가격 책정 및 특정 수량을 사용자 지정하는 샘플 요청 본문
다음 방법을 사용하여 제품에 대한 절대 가격 및 가용성 리소스를 만듭니다.
GET https://graph.microsoft.com/rp/product-ingestion/price-and-availability-private-offer-plan/{productId}?plan={planId}&$version=2023-07-15
가격 및 수량을 사용자 지정하는 VM 제품에 대한 샘플 절대 가격 책정 리소스
{
"$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2023-07-15",
"resourceName": "newVMSRAbsolutePricing",
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"offerPricingType": "vmSoftwareReservations",
"plan": "plan/987654",
"softwareReservation": {
"reservationDuration": {
"type": "year",
"value": 1
},
"paymentSchedule": {
"type": "year",
"value": 1
},
"vmPrices": {
"36Core": {
"quantity": 4.0,
"unitPricePerPaymentPeriodInUsd": 0.04
}
}
}
}
가격 책정 모듈에 해당 리소스를 개체로 포함
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01",
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"name": "privateOffercustomer1705",
"state": "live",
"privateOfferType": "customerPromotion",
"offerPricingType": "vmSoftwareReservations",
"variableStartDate": true,
"end": "2022-01-31",
"acceptBy": "2022-02-28",
"preparedBy": "amy@contoso.com",
"termsAndConditionsDocSasUrl": "https://query.prod.cms.rt.microsoft.com/cms/api/am/binary/RE4rFOA",
"notificationContacts": [ "amy@contoso.com" ],
"beneficiaries": [
{ "id": "xxxxxx-2163-5eea-ae4e-d6e88627c26b:6ea018a9-da9d-4eae-8610-22b51ebe260b_2019-05-31", "description": "Top First Customer"}
],
"pricing": [
{
"product": "product/7ba807c8-386a-4efe-80f1-b97bf8a554f8",
"discountType": "absolute",
"priceDetails": {
"resourceName": "newVMSRAbsolutePricing"
}
"basePlan": "plan/987654"
]
}
]
}
Response
응답에는 나중에 상태를 폴링하는 데 사용할 수 있는 jobId가 포함됩니다.
{
"$schema": "https://schema.mp.microsoft.com/schema/configure-status/2023-07-15",
"jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
"jobStatus": "notStarted",
"jobResult": "pending",
"jobStart": "2021-12-21T21:29:54.9702903Z",
"jobEnd": "0001-01-01",
"errors": []
}
오류 코드
| HTTP 상태 코드 | 설명 |
|---|---|
| 401 | 인증 오류: 유효한 Microsoft Entra 액세스 토큰을 사용하고 있는지 확인합니다. |
| 400 | 스키마 유효성 검사. 요청 본문이 올바른 스키마를 따르고 모든 필수 필드를 포함하는지 확인합니다. |