產品資源
代表可購買商品或服務的資源。 包含描述產品類型和圖形的資源(SKU),以及檢查庫存中產品的可用性。
產品
表示可購買的商品或服務。 產品本身不是可以購買的商品。
財產 | 類型 | 描述 |
---|---|---|
識別碼 | 字串 | 產品的標識碼。 |
標題 | 字串 | 產品標題。 |
描述 | 字串 | 產品描述。 |
產品類型 | ItemType | 物件,描述此產品的型別分類。 |
isMicrosoftProduct | 布爾 | 指出產品是否為Microsoft產品。 |
publisherName | 字串 | 如果有的話,產品發行者的名稱。 |
連結 | ProductLinks | 產品中包含的資源連結。 |
項目類型
表示產品的型別。
財產 | 類型 | 描述 |
---|---|---|
識別碼 | 字串 | 類型標識碼。 |
顯示名稱 | 字串 | 項目類型的顯示名稱。 |
子類型 | 項目類型 | 自選。 描述項目類型子類別分類的物件。 |
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.OfferId 或 CartLineItem.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 專業版複本」。 |
強制驗證 | 布爾 | 指示購買是否需要認證。 |