CSP パートナー向けプライベート オファーを作成する
顧客向けの新しいプライベート オファーを作成するには、このメソッドを使用します。
要求
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
要求ヘッダー
| Header | 型 | 説明 |
|---|---|---|
| 承認 | String | 必須。 フォームの 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 }
]
}
]
}
要求本文のサンプル
指定した受益者に限定されたリセラー オファーのサンプル要求
特定の顧客に適用されるリセラーのマージンを作成する場合は、その情報を受益者の下の受益者の下の受益者のRecipientsパラメーター配列にオブジェクトとして追加します。
要求本文は次の例のようになります。
[
{
"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 | スキーマの検証。 要求本文が正しいスキーマに従っていることを確認し、すべての必須フィールドを含めます。 |