产品资源

  • 项目

表示可购买商品或服务的资源。 包括用于描述产品类型和形状（SKU）的资源，以及用于检查产品在库存中的可用性。

产品

表示可购买的好服务。 产品本身不是可购买的项。

properties 类型​​ 描述
id 字符串 产品的 ID。
title 字符串 产品标题。
description 字符串 产品说明。
productType ItemType 描述此产品的类型分类的对象。
isMicrosoftProduct Bool 指示产品是否为 Microsoft 产品。
publisherName 字符串 产品发布者的名称（如果可用）。
链路 ProductLinks 产品中包含的资源链接。

ItemType

表示产品的类型。

properties 类型​​ 描述
id 字符串 类型标识符。
displayName 字符串 项类型的显示名称。
subType ItemType 可选。 描述项类型的子类型分类的对象。

包含产品的链接列表。

properties 类型​​ 描述
skus 链接。 用于访问基础 SKU 的链接。
链路 ResourceLinks 资源中包含的资源链接。

SKU

表示产品下的可购买库存单位（SKU）。

properties 类型​​ 描述
id 字符串 SKU 的 ID。 ID 仅在其父产品的上下文中是唯一的。
title 字符串 SKU 的标题。
description 字符串 SKU 的说明。
productId 字符串 包含 SKU 的父 产品的 ID。
minimumQuantity int 允许购买的最低数量。
maximumQuantity int 允许购买的最大数量。
isTrial Bool 指示 SKU 是否为试用项。
supportedBillingCycles 字符串数组 SKU 支持的计费周期列表。 支持的值是在 BillingCycleType 中找到的成员名称。
purchasePrerequisites 字符串数组 购买项目之前所需的先决条件步骤或操作的列表。 支持的值包括：
“InventoryCheck”- 指示在尝试购买商品之前应评估项目的库存。
“AzureSubscriptionRegistration” - 指示需要 Azure 订阅，并且必须在尝试购买项目之前注册。
inventoryVariables 字符串数组 对项执行清单检查所需的变量列表。 支持的值包括：
“CustomerId”- 购买将用于的客户 ID。
“AzureSubscriptionId”- 将用于 Azure 预留购买的 Azure 订阅的 ID。
“ArmRegionName”- 要为其验证清单的区域。 此值必须与 SKU 的 DynamicAttributes 中的“ArmRegionName”匹配。
provisioningVariables 字符串数组 购买商品时必须提供给购物车行项目的预配上下文中的变量列表。 支持的值包括：
范围 - Azure 预留购买的范围：“Single”、“Shared”。
“SubscriptionId”- 将用于 Azure 预留购买的 Azure 订阅的 ID。
“Duration” - Azure 预留的持续时间：“1Year”、“3Year”。
dynamicAttributes 键/值对 应用于项的动态属性的字典。 字典中的属性是动态的，可以在不通知的情况下更改。 合作伙伴应避免对属性值中存在的特定键创建强依赖关系。
链路 ResourceLinks SKU 中包含的资源链接。
AttestationProperties AttestationProperties SKU 的证明属性。
consumptionType 字符串 仅当 SKU 支持消耗（如 超额）时，才可用。
specializedOfferProperties specializedOfferProperties 列表 仅当产品是 SpecializedOffer 的子类型时，才可用。
minimumPurchaseCommitment MinimumPurchaseCommitment 在计算服务上提交的固定金额。

动态 SKU 属性

与基于新商业许可证的产品和服务相关的显著属性。

注意

基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商业体验概述。

properties 类型​​ 描述
hasConstraints 布尔 描述 SKU 是否包含 assetContraints
isAddon 布尔 描述 SKU 是否为加载项
prerequisiteSkus 字符串数组 介绍加载项可以使用的产品和 SKU
upgradeTargetOffers 字符串数组 项可以升级到的产品和 SKU 列表
conversionInstructions conversionInstructions 列表 适用于转换操作的说明列表

specializedOfferProperties

注意

基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商业体验概述。

仅适用于产品子类型“SpecializedOffers”

properties 类型​​ 说明
startDate 字符串 说明适用的术语 ID
endDate 字符串 定义续订的选项
pricingPolicies pricingPolicies 列表 定义促销折扣类型和值的策略列表。

MinimumPurchaseCommitment

可在计算服务上提交的最小量的属性。

properties 类型​​ 描述
粮食 字符串 最低购买承诺的期限。
currencyCode 字典<字符串，字符串> 可提交的最小金额的“currency”和“symbol”。
金额 int 可在计算服务上提交的最小金额。

PricingPolicies

描述促销折扣类型和值。

properties 类型​​ 说明
type 字符串 描述折扣是基于百分比还是固定费率折扣。
value 字符串 定义应用的折扣金额。

可用性

表示可供购买的 SKU 的配置（例如国家/地区、货币和行业细分市场）。

properties 类型​​ 描述
id 字符串 此可用性的 ID。 此 ID 仅在其父 产品和SKU 的上下文中是唯一的。 请注意 ，可用性 ID 可能会随时间而变化。 合作伙伴在检索此值后，仅应在短时间内依赖于此值。
productId 字符串 包含此可用性的产品的 ID。
skuId 字符串 包含此可用性的 SKU 的 ID。
catalogItemId 字符串 目录中此项的唯一标识符。 购买父 SKU 时，必须将此 ID 填充到 OrderLineItem.OfferId 或 CartLineItem.CatalogItemId 属性中。 请注意 ，此 ID 可能会随时间而更改。 在检索此值后，仅应在短时间内依赖此值。 只能在购买时访问和使用它。
defaultCurrency 字符串 此可用性支持的默认货币。
段 字符串 此可用性的行业细分市场。 支持的值为：商业、教育、政府、NonProfit。
country 字符串 适用此可用性的国家/地区（采用 ISO 国家/地区代码格式）。
isPurchasable Bool 指示此可用性是否可购买。
isRenewable Bool 指示此可用性是否可续订。
RenewalInstructions RenewalInstruction 表示给定可用性的续订说明。
product Product 此可用性对应于的产品。
sku Sku 此可用性对应于的 SKU。
terms 术语资源数组 适用于此可用性的术语集合。
链路 ResourceLinks 可用性中包含的资源链接。

续订说明

注意

基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商业体验概述。

表示给定可用性的续订说明。

properties 类型​​ 描述
applicableTermIds 字符串数组 说明适用的术语 ID
RenewalOptions RenewalOption 数组 定义续订的选项

RenewalOption

注意

基于许可证的服务的新商业体验涵盖许多新功能，可供所有云解决方案提供商 (CSP) 使用。 有关详细信息，请参阅新商业体验概述。

表示给定可用性的续订说明。

properties 类型​​ 描述
renewToId 字符串 表示要续订到的产品和 SKU
isAutoRenewable Bool 是否可自动续订可用性

Term

表示可为其购买可用性的术语。

properties 类型​​ 描述
duration 字符串 术语持续时间的 ISO 8601 表示形式。 当前支持的值为 P1M（一个月）、P1Y（一年）和 P3Y（三年）。
description 字符串 术语的说明。

InventoryCheckRequest

表示针对某些目录项检查清单的请求。

properties 类型​​ 描述
targetItems InventoryItem 数组 清单检查将评估的目录项的列表。
inventoryContext 键/值对 执行清单检查（s）所需的上下文值的字典。 产品的每个 SKU 将定义执行此操作所需的值（如果有）。
链路 ResourceLinks 清单检查请求中包含的资源链接。

InventoryItem

表示清单检查操作中的单个项。 此资源用于在输入请求中指定目标项，还用于表示清单检查操作的输出结果。

properties 类型​​ 描述
productId 字符串 （必需）产品的 ID。
skuId 字符串 SKU 的 ID。 将此资源用作清单请求的输入时，此值是可选的。 如果未提供此值，则产品下的所有 SKU 都将被视为库存检查操作的目标项。
isRestricted Bool 指示是否已找到此项目具有受限清单。
限制 InventoryRestriction 数组 找到此项的任何限制的详细信息。 仅当 isRestricted = “true”时，才会填充此属性。

InventoryRestriction

表示清单限制的详细信息。 这些详细信息仅适用于清单检查输出结果，不适用于输入请求。

properties 类型​​ 描述
reasonCode 字符串 标识限制原因的代码。
description 字符串 清单限制的说明。
properties 键/值对 可以提供有关限制的更多详细信息的属性字典。

BillingCycleType

一个 [Enum/dotnet/api/system.enum），其值指示计费周期的类型。

值 位置 说明
未知 0 枚举初始值设定项。
每月 1 指示合作伙伴将按月收费。
每年 2 指示合作伙伴将按年收费。
无 3 指示不会向合作伙伴收费。 此值可用于试用项目。
一次性 4 指示合作伙伴将收取一次费用。
三年 5 指示合作伙伴每三年收取一次费用。

AttestationProperties

表示证明类型以及是否需要购买。

properties 类型​​ 描述
attestationType 字符串 指示证明类型。 Windows 365 产品将具有 Windows 365 的值。 Windows 365 证明文本是“我知道，每个使用Windows 365 商业版和Windows 混合权益的人也需要在其主工作设备上安装 Windows 10/11 专业版的有效副本。
enforceAttestation 布尔 指示是否需要证明才能购买。