共用方式為

產品資源

代表可購買商品或服務的資源。 包含描述產品類型和圖形的資源（SKU），以及檢查庫存中產品的可用性。

產品

表示可購買的商品或服務。 產品本身不是可以購買的商品。

財產 類型 描述
識別碼 字串 產品的標識碼。
標題 字串 產品標題。
描述 字串 產品描述。
產品類型 項目類型 物件，描述此產品的型別分類。
isMicrosoftProduct 布爾 指出產品是否為Microsoft產品。
發行商名稱 字串 如果有的話，產品發行者的名稱。
連結 ProductLinks 產品中包含的資源連結。

項目類型

表示產品的型別。

財產 類型 描述
識別碼 字串 類型標識碼。
顯示名稱 字串 項目類型的顯示名稱。
子類型 項目類型 自選。 描述項目類型子類別分類的物件。

包含關於產品 的連結清單。

財產 類型 描述
skus 連結 存取基礎 SKU 的連結。
連結 ResourceLinks 資源內含的資源連結。

SKU

代表產品下可購買的庫存單位（SKU）。

財產 類型 描述
識別碼 字串 SKU 的標識碼。 ID 只有在其父產品的範圍內才是唯一的。
標題 字串 SKU 的標題。
描述 字串 SKU 的描述。
產品ID 字串 包含 SKU 的父 產品 的識別碼。
最小數量 整數 允許購買的最低數量。
最大數量 整數 允許購買的最大數量。
isTrial 布爾 指出 SKU 是否為試用項目。
支持的計費週期 字串陣列 SKU 支援的計費週期清單。 支援的值是 BillingCycleType中找到的成員名稱。
購買條件 字串陣列 購買專案之前所需的必要步驟或動作清單。 支援的值為：
“InventoryCheck” - 表示在嘗試購買商品之前，應先評估商品的庫存。
“AzureSubscriptionRegistration” - 指出需要 Azure 訂用帳戶，而且必須在嘗試購買專案之前註冊。
庫存變數 字串陣列 在物品上執行庫存檢查所需的變數清單。 支援的值為：
“CustomerId” - 購買此項目的客戶ID。
“AzureSubscriptionId” - 將用於 Azure 保留購買的 Azure 訂閱 ID。
“ArmRegionName” - 要核實存貨的區域。 此值必須符合 SKU DynamicAttributes 中的 “ArmRegionName”。
配置變數 字串陣列 在購買物品時，必須將下列變數提供給 購物車明細專案 的配置情境。 支援的值為：
範圍 - Azure 保留購買的範圍：「Single」、“Shared”
“SubscriptionId” - 用於 Azure 預訂購買之 Azure 訂閱 ID。
“Duration” - Azure 保留的持續時間：“1Year”、“3Year”。
dynamicAttributes 鍵值對 套用至專案的動態屬性字典。 字典中的屬性是動態的，而且可以變更而不通知。 合作夥伴應避免在屬性值中的特定現有鍵上建立強依賴性。
連結 ResourceLinks SKU 中包含的資源連結。
驗證屬性 證明屬性 SKU 的證明屬性。
消費類型 字串 只有在 SKU 支援消耗（如 超額）時才可用。
專門優惠屬性 specializedOfferProperties 的清單 只有當產品是 SpecializedOffer 的子類型時，才可用。
最低購買承諾 最低購買承諾 計算服務中承諾的固定金額。

動態 SKU 屬性

與新商務授權型產品和服務相關的值得注意的屬性。

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

財產 類型 描述
有約束條件 布爾 描述 SKU 是否包含資產限制條件
附加元件 布爾 描述 SKU 是否為附加元件
前提Skus 字串陣列 描述附加元件可以使用的產品和 SKU
upgradeTargetOffers 字串陣列 項目可升級至的產品和 SKU 清單
轉換說明 轉換指令列表 適用於轉換作業的指示清單

專門優惠屬性

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

僅適用於產品子類型 “SpecializedOffers”

財產 類型 描述
開始日期 字串 指令適用的術語識別碼
結束日期 字串 定義續訂過程的選項
定價策略 定價政策清單 定義促銷折扣類型和值的原則清單。

最低購買承諾

可設定於計算服務的最小承諾數量屬性。

財產 類型 描述
糧食 字串 最低購買承諾期。
貨幣代碼 字典<字串、字串> 可以承諾的最小金額的「貨幣類型」和「貨幣符號」。
量 整數 計算服務可承諾的最低限額。

定價政策

描述促銷折扣類型和值。

財產 類型 描述
類型 字串 描述折扣是以百分比還是固定費率為基礎。
價值 字串 定義套用的折扣金額。

可用性

代表可供購買 SKU 的組態（例如國家/地區、貨幣和產業區段）。

財產 類型 描述
識別碼 字串 此可用性的識別碼。 此識別碼僅在其父系 產品 與 SKU的內容中是唯一的。 注意 可用性標識符可能會隨著時間而變更。 合作夥伴應該只在擷取此值後的短時間內依靠此值。
產品ID 字串 包含此可用性之 產品 的標識碼。
skuId 的 字串 包含此可用性之 SKU 的識別碼。
目錄項目ID 字串 目錄中此項目的唯一標識符。 購買父 SKU時，此標識碼必須填入 OrderLineItem.OfferId 或 CartLineItem.CatalogItemId 属性。 注意 此標識碼可能會隨著時間而變更。 您只應該在擷取此值之後的短時間內依賴此值。 它僅能在購買時存取及使用。
預設貨幣 字串 此項可用性所支持的預設貨幣。
段 字串 與此可用性對應的產業區段。 支援的值為：商業、教育、政府、非營利組織。
國家 字串 適用此可用性的國家/地區（採用 ISO 國家/地區代碼格式）。
可購買 布爾 指示此項可用性是否可購買。
可再生 布爾 指出此可用性是否可更新。
續約說明 RenewalInstruction 表示指定可用性的更新指示。
產品 產品 此可用性所對應的產品。
SKU SKU 此可用性所對應的 SKU。
條款 一組術語資源的陣列 適用於此可用性的條款集合。
連結 ResourceLinks 可用性中包含的資源連結。

續約指示

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

表示指定可用性的更新指示。

財產 類型 描述
適用的條款識別碼 字串陣列 指令適用的術語識別碼
續約選項 "RenewalOption" 的陣列 定義續訂過程的選項

續約選項

注意

授權型服務的新商務體驗包含許多新功能，且適用於所有雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。

表示指定可用性的更新指示。

財產 類型 描述
renewToId 字串 指定要更新的產品和 SKU
是否自動續訂 布爾 是否可自動更新可用性

術語

代表一個可以購買其可用性的條款。

財產 類型 描述
期間 字串 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。
描述 字串 字詞的描述。
termLifeCycleState 字串 生命週期的描述。 支持的這些值包括 GA （正式推出、EndOfSale 和 EndofSaleWithConversions。 只有在呼叫依標識符 API 取得可用性時，includeLifeCycleState 設為 true 時，才會傳回這個屬性。

庫存檢查請求

表示針對特定目錄項目檢查庫存的請求。

財產 類型 描述
目標項目 InventoryItem 的陣列 清查檢查評估的目錄項目清單。
庫存情境 鍵值對 執行庫存檢查所需的脈絡值字典。 產品的每個 SKU 都會決定執行這項作業所需的值（如果有的話）。
連結 ResourceLinks 清查檢查要求中包含的資源連結。

庫存項目

表示清查作業中的單一項目。 此資源用於在輸入要求中指定目標專案，也用來表示清查檢查作業的輸出結果。

財產 類型 描述
產品ID 字串 （必要）產品的標識碼。
skuId 的 字串 SKU的識別碼。 此為選用值。 如果未提供此值，則產品下的所有 SKU 都被視為庫存檢查操作的目標項目。
受限 布爾 指示此物品是否被發現為受限庫存。
限制 庫存限制 的陣列 針對此項目所發現的任何限制詳細資料。 只有當 isRestricted = “true” 時，才會填入此屬性。

庫存限制

表示清查限制的詳細數據。 這些詳細數據僅適用於清查檢查輸出結果，不適用於輸入要求。

財產 類型 描述
原因碼 字串 識別限制原因的程序代碼。
描述 字串 庫存限制的描述。
性能 鍵值對 屬性的字典，可提供限制的進一步詳細數據。

計費週期類型

具有用於指示計費周期類型的值的 [Enum/dotnet/api/system.enum]。

價值 位置 描述
未知 0 列舉初始化表達式。
每月 1 指出合作夥伴每月被收費。
每年 2 表示合作夥伴被每年收取費用。
沒有 3 表示合作夥伴不收費。 此值可用於試用專案。
單次 4 指出合作夥伴會收取一次費用。
三年一次 5 表示對合作夥伴每三年收費一次。

驗證屬性

表示證明類型以及是否需要購買。

財產 類型 描述
認證類型 字串 表示證明類型。 Windows 365 產品具有 Windows 365 的價值。 Windows 365 證明文字是「我瞭解，使用 Windows 365 商務版與 Windows Hybrid Benefit 的每個人也需要在其主要工作裝置上安裝有效的 Windows 10/11 專業版複本」。
強制驗證 布爾 指示購買是否需要認證。
  • Last updated on