訂購資源

  • 發行項

適用於：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |美國政府適用的 Microsoft Cloud 合作夥伴中心

當客戶想要從供應專案清單中購買訂閱時，合作夥伴會下訂單。

注意

Order 資源每個租用戶標識碼的速率限制為每分鐘 500 個要求。

訂單

描述合作夥伴的訂單。

屬性 類型​ 描述
id string 成功建立訂單時所提供的訂單標識碼。
alternateId string 訂單的易記標識碼。
referenceCustomerId string 客戶標識碼。
billingCycle string 指出合作夥伴為此訂單計費的頻率。 支援的值是 BillingCycleType 中找到的成員名稱。 預設值為 每月 或 建立訂單的 OneTime 。 成功建立訂單時會套用此欄位。
transactionType string 唯讀。 訂單的交易類型。 支援的值包括 UserPurchase、 SystemPurchase 或 SystemBilling
明細項目 OrderLineItem 資源的數位 客戶正在購買的供應項目專案清單，包括數量。
currencyCode string 唯讀。 下訂單時所使用的貨幣。 成功建立訂單時套用。
currencySymbol string 唯讀。 與貨幣碼相關聯的貨幣符號。
creationDate Datetime 唯讀。 訂單建立的日期，以日期時間格式。 成功建立訂單時套用。
status 字串 唯讀。 訂單的狀態。 支援的值是在 OrderStatus 中找到的成員名稱。
連結 OrderLinks 對應至 Order 的資源連結。
attributes ResourceAttributes 對應至 Order 的元數據屬性。

OrderLineItem

訂單包含供應專案的項目化清單，而每個項目都會以 OrderLineItem 表示。

屬性 類型​ 描述
lineItemNumber int 集合中的每個明細項目都會取得唯一的行號，從 0 計算到 count-1。
offerId string 供應項目的標識碼。
subscriptionId string 訂用帳戶的標識碼。
parentSubscriptionId string 選擇性。 附加元件供應專案中父訂閱的標識碼。 僅適用於 PATCH。
friendlyName string 選擇性。 合作夥伴所定義的訂用帳戶易記名稱，以協助釐清。
數量 int 授權或實例的數目。
customTermEndDate Datetime 新訂用帳戶第一個計費期限的結束日期。
termDuration string 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月）、 P1Y （1 年）和 P3Y （3 年）。
transactionType string 唯讀。 明細專案的交易類型。 支援的值為 new、renew、addQuantity、removeQuantity、cancel、convert 或 customerCredit。
partnerIdOnRecord string 當間接提供者代表間接轉銷商下訂單時，僅以間接轉銷商的 PartnerID 填入此字段（絕不是間接提供者的識別符）。 這可確保適當地考慮獎勵。
provisioningContext ProvisioningContext 布建目錄中某些專案所需的資訊。 SKU 中的 provisioningVariables 屬性會指出目錄中特定專案需要哪些屬性。
連結 OrderLineItemLinks 唯讀。 對應至訂單明細項目的資源連結。
renewsTo RenewsTo 續約期限詳細數據。
證明Accepted bool 表示供應專案或 SKU 條件的合約。 僅適用於 SkuAttestationProperties 或 OfferAttestationProperties 強制Attestation 為 True 的供應專案或 SKU。
定價 定價 列出價格詳細數據。
purchaseCommitment PurchaseCommitment 計算服務上認可的固定數量。

RenewsTo

代表續約期間詳細數據。

屬性 型別 必要 描述
termDuration string No 更新期限的 ISO 8601 表示法。 目前的支援值為 P1M （1 個月）和 P1Y （1 年）。

定價

代表價格詳細數據。 價格金額是在稅務前提供。

屬性 型別 必要 描述
listPrice double No 目錄中所列的價格，未套用任何定價修飾詞。
discountedPrice double No 套用所有適用的定價修飾詞之後的價格。
proratedPrice double No 執行按比例後折扣的價格。
price double No 套用所有折扣並執行比例后，適用計費貨幣的價格。
extendedPrice double No 以適用的計費貨幣套用數量、折扣和比例的明細項目價格。

表示對應至訂單的資源連結。

屬性 類型​ 描述
provisioningStatus 連結 填入時，要擷取訂單布建狀態的連結。
self 連結 要擷取訂單資源的連結。

表示與訂單相關聯的完整訂用帳戶。

屬性 類型​ 描述
provisioningStatus 連結 填入時，要擷取 明細專案布建狀態 的連結。
SKU 連結 擷取所購買目錄專案 SKU 信息的連結。
訂用帳戶 連結 填入時，連結至完整的訂用帳戶資訊。
activationLinks 連結 填入時，要啟用訂用帳戶的連結 GET 資源。

OrderStatus

具有值表示順序狀態的 [Enum/dotnet/api/system.enum]。

值 位置 描述
未知 0 列舉初始化表達式。
已完成 1 訂單已完成。
擱置 2 訂單正在處理。
取消 3 訂單已取消。
暫停 4 訂單已暫停。 若要深入瞭解，請參閱： 訂用帳戶生命周期狀態 - NCE 已暫停。
擱置中的檢閱 5 訂單暫止次要檢閱。 可能需要合作夥伴才能上傳檔。 請參閱 次要交易檢閱訓練組 ，以瞭解您是否已選取次要交易檢閱時應預期的情況。
暫止的po上傳 6 合作夥伴是上傳其客戶採購單，並輸入 Microsoft 檢閱中所述的詳細數據。
po upload complete 7 採購單（PO）是由合作夥伴提交，Microsoft 正在檢閱。 合作夥伴不需要採取進一步的動作。
po review rejected 8 此訂單未通過次要檢閱，且不會處理。
部分成功 9 訂單中的一或多個訂用帳戶有問題。 合作夥伴應重新購買未完成的訂用帳戶。
error 10 順序導致錯誤。 合作夥伴應重新購買。

OrderLineItemProvisioningStatus

表示 OrderLineItem 的布建狀態。

屬性 類型​ 描述
lineItemNumber int 訂單明細專案的唯一行號。 值的範圍從 0 到 count-1。
status 字串 訂單明細專案的布建狀態。 值包括：
履行：已成功完成訂單，且使用者可以使用未完成的保留
：因取消
預先填寫未完成而未完成：您的要求仍在處理中，履行尚未完成
quantityProvisioningInformation 列出<QuantityProvisioningStatus> 訂單明細項目的數量布建狀態信息清單。

QuantityProvisioningStatus

依數量表示布建狀態。

屬性 類型​ 描述
數量 int 項目數。
status 字串 項目數目的狀態。

ProvisioningContext

布建目錄中某些專案所需的資訊。 SKU 中的 provisioningVariables 屬性會指出目錄中特定專案需要哪些屬性。

屬性 類型​ Description
範圍 (scope) string 購買的範圍類型，指出權益套用的位置： Single，Shared。
entitlementId string 要用於購買的 Azure 訂用帳戶標識碼。 單一範圍的必要專案。

PurchaseCommitment

計算服務上認可的固定數量。

屬性 類型​ 描述
金額 int 固定金額承諾用量。
currency string 承諾的貨幣。
糧食 string 承諾的期間。