產品資源
代表可購買商品或服務的資源。 包含描述產品類型和圖形的資源（SKU），以及檢查庫存中產品的可用性。
Products
表示可購買的良好或服務。 產品本身不是可購買的專案。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | String | 產品的標識碼。 |
| title | String | 產品標題。 |
| description | String | 產品描述。 |
| productType | ItemType | 物件，描述此產品的型別分類。 |
| isMicrosoftProduct | Bool | 指出產品是否為Microsoft產品。 |
| publisherName | String | 如果有的話，產品發行者的名稱。 |
| 連結 | ProductLinks | 產品中包含的資源連結。 |
ItemType
表示產品的型別。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | String | 類型標識碼。 |
| displayName | String | 項目類型的顯示名稱。 |
| subType | ItemType | 選擇性。 物件，描述專案類型的子類型分類。 |
ProductLinks
包含產品的連結清單。
| 屬性 | 類型 | 描述 |
|---|---|---|
| skus | 連結 | 存取基礎 SKU 的連結。 |
| 連結 | ResourceLinks | 資源內含的資源連結。 |
Sku
代表產品下可購買的庫存單位（SKU）。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | String | SKU 的標識碼。 標識碼只有在其父產品的內容中才是唯一的。 |
| title | String | SKU 的標題。 |
| description | String | SKU 的描述。 |
| productId | String | 包含 SKU 之父 產品的 識別碼。 |
| minimumQuantity | int | 允許購買的最低數量。 |
| maximumQuantity | int | 允許購買的最大數量。 |
| isTrial | Bool | 指出 SKU 是否為試用專案。 |
| supportedBillingCycles | 字串陣列 | SKU 支援的計費週期清單。 支援的值是 BillingCycleType 中找到的成員名稱。 |
| purchasePrerequisites | 字串陣列 | 購買專案之前所需的必要步驟或動作清單。 支援的值為： “InventoryCheck” - 表示在嘗試購買專案之前，應該先評估專案的清查。 “AzureSubscriptionRegistration” - 指出需要 Azure 訂用帳戶，而且必須在嘗試購買專案之前註冊。 |
| inventoryVariables | 字串陣列 | 在專案上執行清查檢查所需的變數清單。 支援的值為： “CustomerId” - 購買物件之客戶的標識符。 “AzureSubscriptionId” - 將用於 Azure 保留購買的 Azure 訂用帳戶標識符。 “ArmRegionName” - 要驗證清查的區域。 此值必須符合 SKU DynamicAttributes 中的 “ArmRegionName”。 |
| provisioningVariables | 字串陣列 | 購買專案時，必須提供給購物車明細專案的布建內容中的變數清單。 支援的值為： 範圍 - Azure 保留購買的範圍：「Single」、“Shared” “SubscriptionId” - 將用於 Azure 保留購買的 Azure 訂用帳戶標識符。 “Duration” - Azure 保留的持續時間：“1Year”、“3Year”。 |
| dynamicAttributes | 索引鍵/值組 | 套用至專案的動態屬性字典。 字典中的屬性是動態的，而且可以變更而不通知。 合作夥伴應避免在屬性值中現有的特定索引鍵上建立強式相依性。 |
| 連結 | ResourceLinks | SKU 中包含的資源連結。 |
| AttestationProperties | AttestationProperties | SKU 的證明屬性。 |
| consumptionType | String | 只有在 SKU 支援使用量，例如 超額時，才能使用。 |
| specializedOfferProperties | specializedOfferProperties 的清單 | 只有在產品是 SpecializedOffer 的 subType 時，才能使用。 |
| minimumPurchaseCommitment | MinimumPurchaseCommitment | 計算服務上認可的固定數量。 |
動態 SKU 屬性
與新商務授權型產品和服務相關的值得注意的屬性。
注意
授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。
| 屬性 | 類型 | 描述 |
|---|---|---|
| hasConstraints | 布林值 | 描述 SKU 是否包含 assetContraints |
| isAddon | 布林值 | 描述 SKU 是否為附加元件 |
| prerequisiteSkus | 字串陣列 | 描述附加元件可以使用的產品和 SKU |
| upgradeTargetOffers | 字串陣列 | 項目可升級至的產品和 SKU 清單 |
| conversionInstructions | conversionInstructions 列表 | 適用於轉換作業的指示清單 |
specializedOfferProperties
注意
授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。
僅適用於產品子類型 “SpecializedOffers”
| 屬性 | 類型 | 描述 |
|---|---|---|
| startDate | String | 適用於指示的字詞標識碼 |
| endDate | String | 定義更新的選項 |
| pricingPolicies | pricingPolicies 清單 | 定義促銷折扣類型和值的原則清單。 |
MinimumPurchaseCommitment
可在計算服務上認可的最小數量屬性。
| 屬性 | 類型 | 描述 |
|---|---|---|
| 糧食 | String | 最低購買承諾期。 |
| currencyCode | <字典字串、字串> | 可認可的最小金額的「貨幣」和「符號」。 |
| 金額 | int | 計算服務可認可的最小數量。 |
PricingPolicies
描述促銷折扣類型和值。
| 屬性 | 類型 | 描述 |
|---|---|---|
| type | String | 描述折扣是以百分比或一般費率折扣為基礎。 |
| value | String | 定義套用的折扣金額。 |
可用性
代表可供購買 SKU 的組態（例如國家/地區、貨幣和產業區段）。
| 屬性 | 類型 | 描述 |
|---|---|---|
| id | String | 此可用性的識別碼。 此標識碼只在其父 產品和 SKU 的內容中是唯一的。 注意 可用性標識碼可能會隨著時間而變更。 合作夥伴只有在擷取此值之後，才應該在短時間內依賴此值。 |
| productId | String | 包含此可用性的產品識別碼。 |
| skuId | String | 包含此可用性之 SKU 的識別碼。 |
| catalogItemId | String | 目錄中此專案的唯一標識符。 購買父 SKU 時，此標識碼必須填入 OrderLineItem.OfferId 或 CartLineItem.CatalogItemId 屬性。 注意 此識別碼可能會隨著時間而變更。 您只應該在擷取此值之後的短時間內依賴此值。 它應該只能在購買時存取及使用。 |
| defaultCurrency | String | 此可用性支持的預設貨幣。 |
| segment | String | 此可用性的產業區段。 支援的值為：商業、教育、政府、NonProfit。 |
| 國家/地區 | String | 適用此可用性的國家/地區（採用 ISO 國家/地區代碼格式）。 |
| isPurchasable | Bool | 指出此可用性是否可購買。 |
| isRenewable | Bool | 指出此可用性是否可更新。 |
| RenewalInstructions | RenewalInstruction | 表示指定可用性的更新指示。 |
| product | 產品 | 此可用性對應至的產品。 |
| SKU | Sku | 此可用性所對應的 SKU。 |
| terms | 字詞資源的陣列 | 適用於此可用性的條款集合。 |
| 連結 | ResourceLinks | 可用性中包含的資源連結。 |
續約指示
注意
授權型服務的新商務體驗包含許多新功能，可供所有 雲端解決方案提供者 （CSP） 使用。 如需詳細資訊，請參閱 新的商務體驗概觀。
表示指定可用性的更新指示。
| 屬性 | 類型 | 描述 |
|---|---|---|
| applicableTermIds | 字串陣列 | 適用於指示的字詞標識碼 |
| RenewalOptions | RenewalOption 的陣列 | 定義更新的選項 |
RenewalOption
注意
授權型服務的新商務體驗包含許多新功能，且適用於所有 雲端解決方案提供者 （CSP）。 如需詳細資訊，請參閱 新的商務體驗概觀。
表示指定可用性的更新指示。
| 屬性 | 類型 | 描述 |
|---|---|---|
| renewToId | String | 代表要更新至的產品和 SKU |
| isAutoRenewable | Bool | 是否可自動更新可用性 |
術語
表示可以購買可用性的字詞。
| 屬性 | 類型 | 描述 |
|---|---|---|
| duration | String | 詞彙持續時間的 ISO 8601 表示法。 目前的支援值為 P1M（一個月）、P1Y（一年）和 P3Y（三年）。 |
| description | String | 字詞的描述。 |
InventoryCheckRequest
表示針對特定目錄項目檢查清查的要求。
| 屬性 | 類型 | 描述 |
|---|---|---|
| targetItems | InventoryItem 的 陣列 | 清查檢查將評估的目錄項目清單。 |
| inventoryContext | 索引鍵/值組 | 執行清查檢查所需的內容值字典。 產品的每個 SKU 都會定義執行這項作業所需的值（如果有的話）。 |
| 連結 | ResourceLinks | 清查檢查要求中包含的資源連結。 |
InventoryItem
表示清查作業中的單一專案。 此資源用於在輸入要求中指定目標專案，也用來表示清查檢查作業的輸出結果。
| 屬性 | 類型 | 描述 |
|---|---|---|
| productId | String | （必要）產品的標識碼。 |
| skuId | String | SKU 的標識碼。 當使用此資源作為清查要求的輸入時，這個值是選擇性的。 如果未提供此值，則產品下的所有 SKU 都會被視為庫存檢查作業的目標專案。 |
| isRestricted | Bool | 指出是否已找到此專案具有限制的清查。 |
| 限制 | InventoryRestriction 的 陣列 | 針對此專案找到的任何限制詳細數據。 只有當 isRestricted = “true” 時，才會填入此屬性。 |
InventoryRestriction
表示清查限制的詳細數據。 這些詳細數據僅適用於清查檢查輸出結果，不適用於輸入要求。
| 屬性 | 類型 | 描述 |
|---|---|---|
| reasonCode | String | 識別限制原因的程序代碼。 |
| description | String | 清查限制的描述。 |
| 內容 | 索引鍵/值組 | 屬性的字典，可提供限制的進一步詳細數據。 |
BillingCycleType
具有值表示計費周期類型的 [Enum/dotnet/api/system.enum]。
| 值 | 位置 | 描述 |
|---|---|---|
| Unknown | 0 | 列舉初始化表達式。 |
| 每月 | 1 | 指出合作夥伴將每月收費。 |
| 每年 | 2 | 表示合作夥伴將每年收取費用。 |
| 無 | 3 | 表示不會向合作夥伴收費。 此值可用於試用專案。 |
| 一次性 | 4 | 指出合作夥伴將收取一次費用。 |
| 三年 | 5 | 表示合作夥伴每三年收取一次費用。 |
AttestationProperties
表示證明類型，如果需要購買，則為 。
| 屬性 | 類型 | 描述 |
|---|---|---|
| attestationType | String | 表示證明類型。 Windows 365 產品將具有 Windows 365 的值。 Windows 365 證明文字是「我瞭解，每位搭配 Windows Hybrid Benefit 使用 Windows 365 商務版 的人員也必須在其主要工作裝置上安裝有效的 Windows 10/11 專業版複本。 |
| enforceAttestation | 布林值 | 指出購買是否需要證明。 |