共用方式為


產品資源

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

產品

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

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

項目類型

表示產品的型別。

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

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

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

Sku

代表產品下可購買的庫存單位(SKU)。

財產 類型 描述
識別碼 字串 SKU 的標識碼。 ID 只有在其父產品的範圍內才是唯一的。
標題 字串 SKU 的標題。
描述 字串 SKU 的描述。
productId 字串 包含 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 的證明屬性。
消費類型 字串 只有在產品代號支援消耗,例如 超額時,才能使用。
specializedOfferProperties specializedOfferProperties 的清單 只有當產品是 SpecializedOffer 的子類型時,才可用。
最低購買承諾 最低購買承諾 計算服務中承諾的固定金額。

動態 SKU 屬性

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

注意

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

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

專業報價屬性

注意

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

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

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

最低購買承諾

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

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

定價政策

描述促銷折扣類型和值。

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

可用性

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

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

續約指示

注意

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

代表針對特定可用性的更新指南。

財產 類型 描述
適用的條款ID (applicableTermIds) 字串陣列 指令適用的術語標識碼
續約選項 "RenewalOption" 的陣列 定義更新的選項

續約選項

注意

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

表示給定的可用性的更新說明。

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

術語

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

財產 類型 描述
期間 字串 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M(一個月)、P1Y(一年)和 P3Y(三年)。
描述 字串 字詞的描述。

庫存檢查請求

表示針對特定目錄項目檢查清查的要求。

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

庫存項目

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

財產 類型 描述
productId 字串 (必要)產品的標識碼。
skuId 字串 SKU的識別碼。 當使用此資源作為清查要求的輸入時,這個值是選擇性的。 如果未提供此值,則產品下的所有 SKU 都會被視為庫存檢查作業的目標專案。
受限 布爾 指示此物品是否被發現為受限庫存。
限制 庫存限制 的陣列 針對此項目找到的任何限制詳細資訊。 只有當 為Restricted = “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 專業版複本」。
強制驗證 布爾 指示購買是否需要認證。