Ресурсы продуктов
Ресурсы, представляющие выкупаемые товары или услуги. Включает ресурсы для описания типа продукта и фигуры (SKU) и проверки доступности продукта в инвентаризации.
Продукт
Представляет благо или обслуживание. Продукт сам по себе не является purchasable элементом.
| Свойство | Type | Описание |
|---|---|---|
| id | Строка | Идентификатор продукта. |
| title | Строка | Название продукта. |
| описание | Строка | Описание продукта. |
| productType | ItemType | Объект, описывающий категории типов этого продукта. |
| isMicrosoftProduct | Bool | Указывает, является ли продукт продуктом Майкрософт. |
| publisherName | Строка | Имя издателя продукта, если оно доступно. |
| ссылки | ProductLinks | Ссылки на ресурсы, содержащиеся в продукте. |
ItemType
Представляет тип продукта.
| Свойство | Type | Описание |
|---|---|---|
| id | Строка | Идентификатор типа. |
| displayName | Строка | Отображаемое имя типа элемента. |
| subType | ItemType | Необязательно. Объект, описывающий классификацию подтипов для типа элемента. |
ProductLinks
Содержит список ссылок для продукта.
| Свойство | Type | Описание |
|---|---|---|
| skus | Ссылка | Ссылка для доступа к базовым номерам SKU. |
| ссылки | ResourceLinks | Ссылки на ресурсы, содержащиеся в ресурсе. |
Sku
Представляет purchasable Stock Keeping Unit (SKU) под продуктом.
| Свойство | Type | Описание |
|---|---|---|
| id | Строка | Идентификатор номера SKU. Идентификатор является уникальным только в контексте родительского продукта. |
| title | Строка | Заголовок номера SKU. |
| описание | Строка | Описание номера SKU. |
| productId | Строка | Идентификатор родительского продукта , содержащего номер SKU. |
| minimumQuantity | Int | Минимальное количество, допустимое для покупки. |
| maximumQuantity | Int | Максимальное количество, допустимое для покупки. |
| isTrial | Bool | Указывает, является ли SKU пробным элементом. |
| supportedBillingCycles | Массив строк | Список поддерживаемых период выставления счетов для номера SKU. Поддерживаемые значения: имена участников в BillingCycleType. |
| purchasePrerequisites | Массив строк | Список необходимых шагов или действий, необходимых перед покупкой элемента. Поддерживаются такие значения: "InventoryCheck" — указывает, что инвентаризация элемента должна быть оценена перед попыткой приобрести элемент. "AzureSubscriptionRegistration" — указывает, что требуется подписка Azure и должна быть зарегистрирована перед попыткой приобрести элемент. |
| inventoryVariables | Массив строк | Список переменных, необходимых для выполнения проверки инвентаризации элемента. Поддерживаются такие значения: CustomerId — идентификатор клиента, за который будет приобретена покупка. AzureSubscriptionId — идентификатор подписки Azure, которая будет использоваться для покупки резервирования Azure. ArmRegionName — регион, для которого необходимо проверить инвентаризацию. Это значение должно соответствовать параметру ArmRegionName из DynamicAttributes номера SKU. |
| provisioningVariables | Массив строк | Список переменных, которые должны быть предоставлены в контекст подготовки элемента строки корзины при покупке элемента. Поддерживаются такие значения: Область — область покупки резервирования Azure: "Один", "Общий". SubscriptionId — идентификатор подписки Azure, которая будет использоваться для покупки резервирования Azure. "Длительность" — длительность резервирования Azure: "1Year", "3Year". |
| dynamicAttributes | Пары "ключ-значение" | Словарь динамических свойств, применяемых к элементу. Свойства в словаре являются динамическими и могут изменяться без уведомления. Партнеры должны избегать создания сильных зависимостей от определенных ключей, существующих в значении свойства. |
| ссылки | ResourceLinks | Ссылки на ресурсы, содержащиеся в номере SKU. |
| АттестацияProperties | АттестацияProperties | Свойства аттестации для номера SKU. |
| consumptionType | Строка | Доступен только в том случае, если sku поддерживает потребление, например избыточность. |
| специализированныеofferProperTies | Список специализированныхOfferProperTies | Доступен только в том случае, если продукт является подтипом СпециализированногоOffer. |
| minimumPurchaseCommitment | MinimumPurchaseCommitment | Фиксированный объем, зафиксированный в службах вычислений. |
Атрибуты динамического SKU
Важные свойства, относящиеся к новым продуктам и службам на основе лицензий.
Примечание.
Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.
| Свойство | Type | Описание |
|---|---|---|
| hasConstraints | Логический | Описывает, содержит ли номер SKU assetContraints |
| isAddon | Логический | Описывает, является ли номер SKU надстройкой |
| предварительный компонент < | массив строк | Описание продуктов и номеров sus, с которыми может работать надстройка |
| upgradeTargetOffers | массив строк | Список продуктов и номеров SKU, которые элемент может обновить до |
| преобразованиеInstructions | Список преобразованийInstructions | Список инструкций, применимых для преобразования операций |
специализированныеofferProperTies
Примечание.
Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.
Применимо только для подтипов продукта "Специализированныеoffers"
| Свойство | Type | Описание |
|---|---|---|
| startDate | Строка | Идентификаторы терминов применимы к инструкциям |
| endDate | Строка | Параметры, определяющие продление |
| pricingPolicies | Список цен наPolicies | Список политик, определяющих типы и значения скидок на повышение. |
MinimumPurchaseCommitment
Атрибуты минимального количества, которое может быть зафиксировано в службах вычислений.
| Свойство | Type | Описание |
|---|---|---|
| зерно | Строка | Период минимального обязательства на покупку. |
| currencyCode | Строка словаря<, строка> | Значение "валюта" и "символ" минимальной суммы, которую можно зафиксировать. |
| amount | Int | Минимальная сумма, которую можно зафиксировать в службах вычислений. |
ЦенообразованиеPolicies
Описать типы и значения скидок на повышение.
| Свойство | Type | Описание |
|---|---|---|
| type | Строка | Опишите, основана ли скидка на процентные или плоские скидки. |
| значение | Строка | Определяет сумму примененной скидки. |
Availability
Представляет конфигурацию, в которой номер SKU доступен для покупки (например, страна или регион, валюта и отраслевый сегмент).
| Свойство | Type | Описание |
|---|---|---|
| id | Строка | Идентификатор этой доступности. Этот идентификатор является уникальным только в контексте родительского продукта и номера SKU. Идентификаторы доступности заметок могут меняться с течением времени. Партнеры должны полагаться только на это значение в течение короткого промежутка времени после получения. |
| productId | Строка | Идентификатор продукта , содержащего эту доступность. |
| skuId | Строка | Идентификатор номера SKU , содержащего эту доступность. |
| catalogItemId | Строка | Уникальный идентификатор этого элемента в каталоге. Этот идентификатор должен быть заполнен свойствами OrderLineItem.OfferId или CartLineItem.CatalogItemId при покупке родительского номера SKU. Обратите внимание, что этот идентификатор может изменяться со временем. Вы должны полагаться только на это значение в течение короткого времени после получения. Доступ к нему должен использоваться только во время покупки. |
| DefaultCurrency | Строка | Валюта по умолчанию, поддерживаемая для этой доступности. |
| сегмент | Строка | Сегмент отрасли для этой доступности. Поддерживаемые значения: коммерческая, образование, правительство, nonProfit. |
| country | Строка | Страна или регион (в формате кода страны ISO), где применяется эта доступность. |
| isPurchasable | Bool | Указывает, является ли эта доступность доступной. |
| isRenewable | Bool | Указывает, является ли эта доступность возобновляемым. |
| Возобновление инструкций | ОбновлениеInstruction | Представляет инструкции по продлению для заданной доступности. |
| продукт | Продукт | Продукт, соответствующий этой доступности. |
| sku | SKU | Номер SKU этой доступности соответствует. |
| условия | Массив ресурсов терминов | Коллекция терминов, применимых к этой доступности. |
| ссылки | ResourceLinks | Ссылки на ресурсы, содержащиеся в доступности. |
Инструкция по продлению
Примечание.
Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.
Представляет инструкции по продлению для заданной доступности.
| Свойство | Type | Описание |
|---|---|---|
| applicableTermIds | Массив строк | Идентификаторы терминов применимы к инструкциям |
| ОбновлениеOptions | Массив ОбновленияOption | Параметры, определяющие продление |
ОбновлениеOption
Примечание.
Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.
Представляет инструкции по продлению для заданной доступности.
| Свойство | Type | Описание |
|---|---|---|
| renewToId | Строка | Представляет продукт и номер SKU для возобновления |
| isAutoRenewable | Bool | Возможность автоматического продления доступности |
Термин
Представляет термин, для которого можно приобрести доступность.
| Свойство | Type | Описание |
|---|---|---|
| duration | Строка | Представление срока действия термина ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года). |
| описание | Строка | Описание термина. |
InventoryCheckRequest
Представляет запрос на проверку инвентаризации определенных элементов каталога.
| Свойство | Type | Описание |
|---|---|---|
| targetItems | Массив InventoryItem | Список элементов каталога, которые будет оценивать проверка инвентаризации. |
| inventoryContext | пары "ключ-значение"; | Словарь значений контекста, необходимых для выполнения проверки инвентаризации. Каждый номер SKU продуктов определяет, какие значения (если таковые имеются) необходимы для выполнения этой операции. |
| ссылки | ResourceLinks | Ссылки на ресурсы, содержащиеся в запросе проверки инвентаризации. |
InventoryItem
Представляет один элемент в операции проверки инвентаризации. Этот ресурс используется для указания целевых элементов во входном запросе, а также используется для представления выходных результатов операции проверки инвентаризации.
| Свойство | Type | Описание |
|---|---|---|
| productId | Строка | (обязательно) Идентификатор продукта. |
| skuId | Строка | Идентификатор номера SKU. При использовании этого ресурса в качестве входных данных для запроса инвентаризации это значение является необязательным. Если это значение не указано, все номера SKU под продуктом будут считаться целевыми элементами операции проверки инвентаризации. |
| isRestricted | Bool | Указывает, был ли найден этот элемент ограниченным инвентаризацией. |
| ограничения | Массив inventoryRestriction | Сведения о любых ограничениях, найденных для этого элемента. Это свойство будет заполнено только в том случае, если isRestricted = true. |
InventoryRestriction
Представляет сведения об ограничении инвентаризации. Эти сведения применимы только для результатов проверки инвентаризации, а не для входных запросов.
| Свойство | Type | Описание |
|---|---|---|
| reasonCode | Строка | Код, определяющий причину ограничения. |
| описание | Строка | Описание ограничения инвентаризации. |
| свойства | пары "ключ-значение"; | Словарь свойств, которые могут предоставлять дополнительные сведения об ограничении. |
BillingCycleType
[Enum/dotnet/api/system.enum) со значениями, указывающими тип период выставления счетов.
| Значение | Position | Description |
|---|---|---|
| Неизвестно | 0 | Инициализатор перечисления. |
| Месяц | 1 | Указывает, что партнер будет взиматься ежемесячно. |
| Ежегодный | 2 | Указывает, что партнер будет взиматься ежегодно. |
| нет | 3 | Указывает, что партнер не будет взиматься. Это значение можно использовать для пробных элементов. |
| OneTime | 4 | Указывает, что партнер будет взиматься один раз. |
| Трехлетие | 5 | Указывает, что партнер будет взиматься каждые три года. |
АттестацияProperties
Представляет тип аттестации и, если он необходим для покупки.
| Свойство | Type | Описание |
|---|---|---|
| аттестацияType | Строка | Указывает тип аттестации. Продукты Windows 365 будут иметь значение Windows 365. Текст аттестации Windows 365 — "Я понимаю, что каждый пользователь, использующий Windows 365 для бизнеса с Преимущество гибридного использования Windows также должен иметь действительную копию Windows 10/11 Pro на основном рабочем устройстве". |
| enforceAttestation | Логический | Указывает, требуется ли аттестация для покупки. |