다음을 통해 공유

CSP 파트너에 대한 전용 제안 만들기

  • 아티클

이 방법을 사용하여 고객을 위한 새 프라이빗 제품을 만듭니다.

요청

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

요청 헤더

머리글 유형 묘사
권한 부여 문자열 필수. Microsoft Entra 액세스 토큰은 Bearer <token>형식입니다.

요청 매개 변수

$version - 필수입니다. 요청에 사용되는 스키마의 버전입니다.

요청 본문

ISV를 사용하여 프라이빗 오퍼의 세부 정보를 제공하고, 이를 재판매인 마진 프라이빗 오퍼 스키마에 맞춥니다. 이름을 포함해야 합니다.

{
 "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01", 
  "resources": [ 
    { 
       "$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15", 
       "privateOfferType": "cspPromotion",
       "name": "privateOffercsp1034",
       "state": "live",
       "variableStartDate": false,
       "start": "2022-01-31",
       "end": "2022-02-28",
       "preparedBy": "amy@contoso.com",
       "notificationContacts": [ "amy@contoso.com" ],
       "beneficiaries": [ 
          { "id": "xxxxxxx-0a32-4b44-b904-39dd964dd790", "description": "Top First CSP"}
       ], 
       "pricing": [ 
          { "product": "product/34771906-9711-4196-9f60-4af380fd5042", "plan":"plan/123456","discountType": "percentage","discountPercentage": 5 }
       ]
    }
  ]
}

요청 본문 예시

지정된 수혜자에게 제한된 재판매인 제안에 대한 샘플 요청

특정 고객에게 적용되는 재판매인의 마진을 만드는 경우, 해당 정보를 beneficiaries의 beneficiaryRecipients 매개 변수 배열에 객체로 추가하세요.

요청 본문은 다음 샘플과 같습니다.

[
    {
        "id": "xxxxxxx-0a32-4b44-b904-39dd964dd790",
        "description": "Top First CSP",
        "beneficiaryRecipients": [
            {
                "id": "xxxxxxx-48b4-af80-66333cd9c609",
                "recipientType": "cspCustomer"
            }
        ]
    }
],

응답

응답에는 나중에 상태를 폴링하는 데 사용할 수 있는 jobId가 포함됩니다.

{
    "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
    "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 스키마 유효성 검사. 요청 본문이 올바른 스키마를 따르고 있으며 모든 필수 필드를 포함하는지 확인합니다.

관련 콘텐츠