リソースの注文
適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター
パートナーは、顧客がオファーの一覧からサブスクリプションを購入する場合に注文を行います。
Note
Order リソースのレート制限は、テナント識別子あたり 1 分あたり 500 要求です。
注文
パートナーの注文について説明します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | string | 注文の正常な作成時に指定される注文識別子。 |
| alternateId | string | 便利な注文の識別子。 |
| referenceCustomerId | string | 顧客 ID。 |
| billingCycle | string | この注文に対してパートナーに請求される頻度を示します。 サポートされる値は、BillingCycleType で検出されたメンバー名です。 既定値は、注文の作成時に Monthly または OneTime です。 このフィールドは、注文が正常に作成されると適用されます。 |
| transactionType | string | 読み取り専用です。 注文のトランザクションの種類です。 サポートされている値は、 UserPurchase、 SystemPurchase、または SystemBilling です。 |
| lineItems | OrderLineItem リソースの配列 | 顧客が購入しているオファーの明細リスト (数量を含む)。 |
| currencyCode | string | 読み取り専用です。 注文時に使用される通貨。 注文が正常に作成されると適用されます。 |
| currencySymbol | string | 読み取り専用です。 通貨コードに関連する通貨記号。 |
| creationDate | datetime | 読み取り専用です。 注文が作成された日付 (日時形式)。 注文が正常に作成されると適用されます。 |
| status | string | 読み取り専用です。 指示の状態。 サポートされている値は、 OrderStatus で見つかったメンバー名です。 |
| リンク | OrderLinks | Order に対応するリソース リンク。 |
| 属性 | ResourceAttributes | Order に対応するメタデータ属性。 |
OrderLineItem
注文にはオファーのアイテム化されたリストが含まれており、各項目は OrderLineItem として表されます。
| プロパティ | タイプ | 説明 |
|---|---|---|
| lineItemNumber | int | コレクション内の各品目には、0 からカウント -1 までカウントする、一意の品目番号が与えられます。 |
| offerId | string | オファーの ID。 |
| subscriptionId | string | サブスクリプションの ID です。 |
| parentSubscriptionId | string | 省略可能。 アドオン オファーの親サブスクリプションの ID。 PATCH にのみ適用されます。 |
| friendlyName | string | 省略可能。 曖昧さをなくすためにパートナーが定義したサブスクリプションのフレンドリ名。 |
| quantity | int | ライセンスまたはインスタンスの数。 |
| customTermEndDate | DateTime | 新しいサブスクリプションの最初の請求期間の終了日。 |
| termDuration | string | 期間の ISO 8601 表現。 現在サポートされている値は、 P1M (1 か月)、 P1Y (1 年)、 P3Y (3 年) です。 |
| transactionType | string | 読み取り専用です。 明細行項目のトランザクションの種類です。 サポートされる値は、 new、 renew、 addQuantity、 removeQuantity、 cancel、 convert、または customerCredit です。 |
| partnerIdOnRecord | string | 間接プロバイダーが間接リセラーに代わって注文を行う場合は、このフィールドに indirect リセラーの PartnerID のみを設定します (間接プロバイダーの ID は設定されません)。 これにより、インセンティブを正しく計算できます。 |
| provisioningContext | ProvisioningContext | カタログ内の一部の項目のプロビジョニングに必要な情報。 SKU の provisioningVariables プロパティは、カタログ内の特定のアイテムに必要なプロパティを示します。 |
| リンク | OrderLineItemLinks | 読み取り専用です。 注文明細に対応するリソース リンク。 |
| renewsTo | RenewsTo | 更新期間の詳細。 |
| AttestationAccepted | [bool] | オファーまたは SKU の条件に対する契約を示します。 SkuAttestationProperties または OfferAttestationProperties enforceAttestation が True のオファーまたは SKU にのみ必要です。 |
| 価格 | 料金 | 定価の詳細。 |
| purchaseCommitment | PurchaseCommitment | コンピューティング サービスでコミットされた固定金額。 |
RenewsTo
更新期間の詳細を表します。
| プロパティ | タイプ | Required | 説明 |
|---|---|---|---|
| termDuration | string | いいえ | 更新期間の ISO 8601 表現。 現在サポートされている値は、 P1M (1 か月) と P1Y (1 年) です。 |
価格
価格の詳細を表します。 価格額は課税前に提供されます。
| プロパティ | タイプ | Required | 説明 |
|---|---|---|---|
| listPrice | 倍精度浮動小数点 | いいえ | 価格修飾子が適用されていないカタログに記載されている価格。 |
| discountedPrice | 倍精度浮動小数点 | いいえ | 適用されるすべての価格修飾子を適用した後の価格。 |
| proratedPrice | 倍精度浮動小数点 | いいえ | 割り当て後の割引価格。 |
| Price | 倍精度浮動小数点 | いいえ | すべての割引が適用され、日割り計算が実行された後の、該当する請求通貨での価格。 |
| extendedPrice | 倍精度浮動小数点 | いいえ | 数量、割引、および日割り計算が適用された品目の価格 (該当する請求通貨)。 |
OrderLinks
順序に対応するリソース リンクを表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| provisioningStatus | リンク | 設定すると、注文のプロビジョニング状態を取得するためのリンク。 |
| セルフ | リンク | 注文リソースを取得するためのリンク。 |
OrderLineItemLinks
注文に関連付けられている完全なサブスクリプションを表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| provisioningStatus | リンク | 入力すると、行項目の プロビジョニング状態 を取得するためのリンク。 |
| sku | リンク | 購入したカタログ アイテムの SKU 情報を取得するためのリンク。 |
| subscription | リンク | 入力すると、完全なサブスクリプション情報へのリンクが表示されます。 |
| activationLinks | リンク | 設定すると、サブスクリプションをアクティブ化するためのリンクの GET リソース。 |
OrderStatus
順序の状態を示す値を持つ [Enum/dotnet/api/system.enum)。
| Value | 配置 | 説明 |
|---|---|---|
| unknown | 0 | 列挙型初期化子。 |
| completed | 1 | 注文が完了しました。 |
| 保留中 | 2 | 注文は処理中です。 |
| キャンセル済み | 3 | 注文は取り消されます。 |
| 一時停止中 | 4 | 注文は中断されます。 詳細については、「 |
| 保留中のレビュー | 5 | 注文はセカンダリ レビューを保留中です。 パートナーはドキュメントをアップロードする必要がある場合があります。 セカンダリ 取引レビュー 選択した場合に期待される内容については 2 次取引レビュートレーニング デッキを参照してください。 |
| 保留中の po upload | 6 | パートナーは、顧客の発注書をアップロードし、Microsoft によるレビューのために記載されている詳細を入力します。 |
| po upload complete | 7 | 発注書 (PO) はパートナーによって送信され、Microsoft はレビュー中です。 パートナーによるそれ以上のアクションは必要ありません。 |
| po review rejected | 8 | この注文はセカンダリ レビューに合格せず、処理されません。 |
| 部分的な成功 | 9 | 注文内の 1 つ以上のサブスクリプションに問題があります。 パートナーは、満たされていないサブスクリプションを再購入する必要があります。 |
| エラー | 10 | 順序によってエラーが発生しました。 パートナーは再購入する必要があります。 |
OrderLineItemProvisioningStatus
OrderLineItemのプロビジョニング状態を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| lineItemNumber | int | 注文品目の一意の行番号。 値の範囲は 0 から count-1 です。 |
| status | string | 注文明細のプロビジョニング状態。 次の値が含まれます: Fulfilled: 注文のフルフィルメントが正常に完了し、ユーザーは予約を使用できるようになります Unfulfilled: 取り消しが原因で満たされていません PrefulfillmentPending: 要求はまだ処理中です。フルフィルメントはまだ完了していません |
| quantityProvisioningInformation | List<QuantityProvisioningStatus> | 注文品目の数量プロビジョニング状態情報の一覧。 |
QuantityProvisioningStatus
プロビジョニングの状態を数量別に表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| quantity | int | 項目数。 |
| status | string | 項目数の状態。 |
ProvisioningContext
カタログ内の一部の項目のプロビジョニングに必要な情報。 SKU の provisioningVariables プロパティは、カタログ内の特定のアイテムに必要なプロパティを示します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| scope | string | 特典が適用される場所を示す購入のスコープの種類: Single、 Shared。 |
| entitlementId | string | 購入に使用される Azure サブスクリプションの ID。 単一スコープに必要です。 |
PurchaseCommitment
コンピューティング サービスでコミットされた固定金額。
| プロパティ | タイプ | 説明 |
|---|---|---|
| 金額 | int | 固定金額コミットメント。 |
| currency | string | コミットメントの通貨。 |
| 穀物 | string | コミットメントの期間。 |