产品资源
表示可购买商品或服务的资源。 包括用于描述产品类型和形状（SKU）的资源，以及检查库存中产品的可用性。
产品
表示可购买的好服务。 产品本身不是可购买的项。
| properties | 类型 | 描述 |
|---|---|---|
| id | 字符串 | 产品的 ID。 |
| title | 字符串 | 产品标题。 |
| description | 字符串 | 产品说明。 |
| productType | ItemType | 描述此产品的类型分类的对象。 |
| isMicrosoftProduct | Bool | 指示产品是否为Microsoft产品。 |
| publisherName | 字符串 | 产品发布者的名称（如果可用）。 |
| 链路 | ProductLinks | 产品中包含的资源链接。 |
ItemType
表示产品的类型。
| properties | 类型 | 描述 |
|---|---|---|
| id | 字符串 | 类型标识符。 |
| displayName | 字符串 | 项类型的显示名称。 |
| subType | ItemType | 可选。 描述项类型的子类型分类的对象。 |
ProductLinks
包含产品的链接列表。
| 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 | 键/值对 | 执行清单检查所需的上下文值的字典。 产品的每个 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 | 布尔 | 指示是否需要证明才能购买。 |