Product List - List By Subscription

Служба:

Marketplace Catalog

Версия API:

2025-05-01

Список продуктов для подписки.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01

С использованием необязательных параметров:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language={language}&excludePublicOffersAndPublicPlans={excludePublicOffersAndPublicPlans}&$filter={$filter}&$select={$select}&$expand={$expand}&$orderBy={$orderBy}&$search={$search}

Параметры URI

Имя	В	Обязательно	Тип	Описание
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.
$expand	query		string	Расширяет встроенные связанные сущности
$filter	query		string	Фильтрует результаты на основе логического условия. Пример: $filter=productType eq 'VirtualMachine'. Поля, по которым можно отфильтровать: displayName productId popularity categoryIds industryIds publisherId uniqueProductId productType operatingSystems pricingTypes publisherDisplayName longSummary summary linkedAddinsTypes description supportedProducts applicableProducts lastModifiedDateTime plan.planId plan.displayName plan.cspState plan.altStackReference plan.stackType plan.categoryIds plan.hasProtectedArtifacts plan.pricingTypes plan.summary plan.description plan.skuId plan.displayRank plan.isPrivate
$orderBy	query		string	Упорядочивание выражения для получения результатов с использованием нотации OData. Избегайте использования orderby, если в этом нет необходимости, так как это может повлиять на задержку вашего запроса. Пример: $orderby=displayName desc. Этот API поддерживает упорядочивание только по одному полю. Поля, которые можно упорядочить, следующие: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	Необязательный поиск по отображаемому имени, отображаемому имени издателя или ключевым словам. Пример $search=Microsoft
$select	query		string	Выбирает свойства для включения в результаты. Пример: $select=displayName
excludePublicOffersAndPublicPlans	query		boolean	Следует ли исключать из ответа публичные предложения и публичные планы. Значение по умолчанию равно false, что означает, что в ответ включены публичные предложения и публичные планы. Если установлено значение true, будут возвращены только частные планы.
language	query		string	Язык для поиска, двухбуквенный код ISO 639-1, возможные значения - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. По умолчанию используется "en"

Ответы

Имя	Тип	Описание
200 OK	ProductSummaryListResult	Запрос выполнен успешно.
Other Status Codes	DiscoveryErrorPayload	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

ProductList_ListBySubscription

Образец запроса

HTTP

GET https://management.azure.com/subscriptions/f47ac10b-58cc-4372-a567-0e02b2c3d479/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language=en&$filter=productType eq 'SaaS'&$select=displayName,uniqueProductId,productType,publisherDisplayName

Пример ответа

Код состояния:

200

{
  "value": [
    {
      "uniqueProductId": "microsoft.managedinstance_standard",
      "displayName": "Azure SQL Managed Instance",
      "publisherDisplayName": "Microsoft",
      "productType": "SaaS"
    }
  ],
  "nextLink": "https://management.azure.com/subscriptions/f47ac10b-58cc-4372-a567-0e02b2c3d479/providers/Microsoft.Marketplace/products?api-version=2025-05-01&language=en&$select=displayName,uniqueProductId,productType,publisherDisplayName&$filter=productType eq 'SaaS'&$skiptoken=W3sid..."
}

Определения

Имя	Описание
Attribute	Представляет атрибут SKU, который состоит из ключа и значения. Атрибуты могут отличаться в зависимости от службы.
DiscoveryErrorDetails	Сведения об ошибке, возвращенные в DiscoveryErrorPayload
DiscoveryErrorPayload	Полезные данные об ошибках, возвращаемые API-интерфейсами Marketplace Discovery
PlanMetadata	Дополнительные метаданные
PlanSummary	Возвращает подмножество атрибутов Plan
ProductSummary	Возвращает подмножество атрибутов Product
ProductSummaryListResult	Пользовательский ответ на операцию списка.

Attribute

Объект

Представляет атрибут SKU, который состоит из ключа и значения. Атрибуты могут отличаться в зависимости от службы.

Имя	Тип	Описание
key	string	Ключ атрибута
value	string	Значение атрибута

DiscoveryErrorDetails

Объект

Сведения об ошибке, возвращенные в DiscoveryErrorPayload

Имя	Тип	Описание
code	string	Код ошибки HTTP
message	string	Сообщение об ошибке

DiscoveryErrorPayload

Объект

Полезные данные об ошибках, возвращаемые API-интерфейсами Marketplace Discovery

Имя	Тип	Описание
error	DiscoveryErrorDetails	Объект сведений об ошибке

PlanMetadata

Объект

Дополнительные метаданные

Имя	Тип	Описание
altStackReference	string	Указание на planId, который содержит альтернативную ссылку на стек
generation	string	Создание образа виртуальной машины (применимо только к продуктам виртуальных машин)

PlanSummary

Объект

Возвращает подмножество атрибутов Plan

Имя	Тип	Описание
altArchitectureReference	string	Справочник по альтернативной архитектуре
altStackReference	string	Справочник по альтернативному стеку
categoryIds	string[]	Идентификаторы категорий тарифных планов
cspState	string	Контролирует доступность планов и доступ партнеров в рамках программы Microsoft Cloud Solution Provider (CSP). OptIn - Позволяет всем авторизованным партнерам по программе «Поставщик облачных решений» перепродавать и развертывать продукт для клиентов OptOut - Исключен из программы Cloud Solution Provider, доступен только по прямым каналам SelectiveOptIn - Доступно только для избранных партнеров из числа поставщиков облачных решений для перепродажи и развертывания клиентами
description	string	План / описание артикула
displayName	string	Отображаемое название плана / артикул
displayRank	string	Порядок выполнения плана отображается в таблице "Планы"
hasProtectedArtifacts	boolean	Установите значение true, если в плане есть артефакты, которые должны быть скрыты для неаутентифицированных пользователей
hasRi	boolean	Указание на то, поддерживает ли SKU резервирование
isPrivate	boolean	Указание на то, что тарифный план доступен только для ограниченной аудитории
metadata	PlanMetadata	Расширены метаданные плана/SKU.
planId	string	Идентификатор плана
planType	string	Указывает основную модель развертывания и архитектуру размещения для продукта Marketplace. В настоящее время поддерживаются следующие значения: None - Неопределенный тип продукта, обычно используемый для продуктов без определенной модели развертывания DevService - Услуги и инструменты, ориентированные на разработку, для рабочих процессов создания программного обеспечения ManagedApplication - Управляемые приложения Azure, которые развертывают ресурсы в клиентских подписках и управляют ими. VirtualMachine - Предварительно настроенные образы виртуальных машин, развертываемые в вычислительной инфраструктуре Azure AzureApplication - Собственные приложения Azure, использующие сервисы платформы и API Container - Контейнерные приложения, развернутые с помощью Azure Container Instances или аналогичных служб SaaS - Решения «программное обеспечение как услуга», размещенные и управляемые издателем SolutionTemplate - Шаблоны Azure Resource Manager, которые подготавливают несколько ресурсов Azure IotEdgeModules - Модули, предназначенные для развертывания в средах выполнения Azure IoT Edge ManagedServices - Полностью управляемые сервисы, в которых издатель управляет инфраструктурой и операциями ContainerApps - Приложения, созданные для бессерверной контейнерной платформы Azure Container Apps VisualStudioExtension - Расширения, которые интегрируются с функциями интегрированной среды разработки Visual Studio DynamicsOps - Приложения и расширения Microsoft Dynamics 365 Finance and Operations DynamicsCE - Приложения и настройки Microsoft Dynamics 365 Customer Engagement DynamicsBC - Приложения и надстройки Microsoft Dynamics 365 Business Central PowerBI - Отчеты, панели мониторинга и компоненты визуализации данных Microsoft Power BI ConsultingServices - Предложение профессиональных услуг, включая услуги по внедрению и консультационные услуги CosellOnly - Продукты, доступные исключительно в рамках партнерских программ Microsoft по совместным продажам CoreVirtualMachine - Основные предложения виртуальных машин с базовыми вычислительными возможностями Azure PowerBIVisuals - Пользовательские визуализации для платформы отчетов Microsoft Power BI Office365 - Приложения, надстройки и интеграции Microsoft 365 и Office 365 AADApps - Интегрированные приложения Azure Active Directory, поддерживающие идентификацию организации AzureServices - Собственные службы платформы Azure и поставщики ресурсов AppService - Веб-приложения, размещенные на платформе Azure App Service LogAnalytics - Решения Azure Monitor Log Analytics и конфигурации рабочих областей MicrosoftProduct - Собственные продукты Майкрософт доступны через каналы Marketplace
pricingTypes	string[]	Указывает модели выставления счетов и структуры затрат, доступные для плана. Free - Плата за использование плана, как правило, для версий Community Edition или базовых уровней служб FreeTrial - Ограниченный по времени период бесплатного доступа перед переходом на модель платного биллинга Byol - Модель Bring Your Own License, при которой клиенты предоставляют существующие лицензии на программное обеспечение Payg - Оплата по мере использования — выставление счетов на основе потребления, рассчитанное на основе фактического использования ресурсов Ri - Выставление счетов за зарезервированные экземпляры с авансовым обязательством по долгосрочным ценам со скидкой
skuId	string	Идентификатор SKU
stackType	string	Тип стека : Классический, Gen1, Gen2
summary	string	Текст резюме плана
uniquePlanId	string	Уникальный идентификатор плана, который имеет префикс путем объединения uniqueProductId и PlanId без разделителя между ними
vmArchitectureType	string	Указывает архитектуру и поколение процессора виртуальной машины. Применяется исключительно к типам продуктов виртуальных машин. X64Gen1 - Процессорная архитектура x64 с прошивкой виртуальной машины 1-го поколения и поддержкой BIOS X64Gen2 - Процессорная архитектура x64 с прошивкой виртуальных машин 2-го поколения и поддержкой UEFI Arm64 - 64-разрядная архитектура процессора ARM, оптимизированная для энергоэффективности и облачных рабочих нагрузок
vmSecuritytypes	string[]	Определяет уровень повышения безопасности для развертываний виртуальных машин. Применяется исключительно к типам продуктов виртуальных машин. None - Стандартная безопасность виртуальных машин без дополнительных функций защиты Trusted - Безопасность Trusted Launch с безопасной загрузкой и возможностями виртуального модуля Trusted Platform Module Confidential - Конфиденциальные вычисления с шифрованием памяти и аттестацией для чувствительных рабочих нагрузок

ProductSummary

Объект

Возвращает подмножество атрибутов Product

Имя	Тип	Описание
applicableProducts	string[]	Категории товаров, к которым относится предложение
attributes	Attribute[]	Набор атрибутов товаров
azureBenefit	string	Указывает, учитываются ли покупки продуктов в рамках обязательств по потреблению Azure для корпоративных клиентов. Eligible - Затраты на продукт применяются к расчету преимуществ и кредитов по обязательствам по потреблению Azure NotEligible - Затраты на продукты не подпадают под действие программ преимуществ по потреблению Azure
badges	string[]	Отображает значки сертификации и квалификации, полученные продуктом, для видимости на рынке. PreferredSolution - Признанное корпорацией Майкрософт решение, отвечающее определенным критериям качества и партнерства PowerBICertified - Сертифицированная совместимость и интеграция с платформой Microsoft Power BI AdditionalPurchaseRequirement - Продукт требует дополнительных покупок или подписок для полной функциональности
categoryIds	string[]	Массив категорий товаров
cspLegalTermsUri	string	Юридические условия продукта для CSP
description	string	Текст описания товара
displayName	string	Отображаемое название продукта
hasMarketplaceFootprint	boolean	Указание на то, есть ли у товара представительство на рынке
hasRiPlans	boolean	Указание наличия у товара тарифных планов с оговорками
industryIds	string[]	Список отраслевых идентификаторов, к которым принадлежит товар
lastModifiedDateTime	string	Дата последнего обновления продукта
locations	string[]	Список местоположений, доступных в SKU
longSummary	string	Общий текст продукта
operatingSystems	string[]	Информация об операционной системе для этого продукта
plans	PlanSummary[]	Полный набор атрибутов плана/SKU
popularity	number (double)	Популярность продукта
pricingTypes	string[]	Указывает модели выставления счетов и структуры затрат, доступные для плана. Free - Плата за использование плана, как правило, для версий Community Edition или базовых уровней служб FreeTrial - Ограниченный по времени период бесплатного доступа перед переходом на модель платного биллинга Byol - Модель Bring Your Own License, при которой клиенты предоставляют существующие лицензии на программное обеспечение Payg - Оплата по мере использования — выставление счетов на основе потребления, рассчитанное на основе фактического использования ресурсов Ri - Выставление счетов за зарезервированные экземпляры с авансовым обязательством по долгосрочным ценам со скидкой
privacyPolicyUri	string	Политика конфиденциальности продукта
productFamily	string	Семейство продуктов
productId	string	Уникальный идентификатор товара
productSubType	string	Подтип продукта
productType	string	Указывает основную модель развертывания и архитектуру размещения для продукта Marketplace, хранящегося в каталоге Marketplace. None - Неопределенный тип продукта, обычно используемый для продуктов без определенной модели развертывания ManagedApplication - Управляемые приложения Azure, которые развертывают ресурсы в клиентских подписках и управляют ими. VirtualMachine - Предварительно настроенные образы виртуальных машин, развертываемые в вычислительной инфраструктуре Azure AzureApplication - Собственные приложения Azure, использующие сервисы платформы и API Container - Контейнерные приложения, развернутые с помощью Azure Container Instances или аналогичных служб SaaS - Решения «программное обеспечение как услуга», размещенные и управляемые издателем SolutionTemplate - Шаблоны Azure Resource Manager, которые подготавливают несколько ресурсов Azure IotEdgeModules - Модули, предназначенные для развертывания в средах выполнения Azure IoT Edge ManagedServices - Полностью управляемые сервисы, в которых издатель управляет инфраструктурой и операциями ContainerApps - Приложения, созданные для бессерверной контейнерной платформы Azure Container Apps DynamicsOps - Приложения и расширения Microsoft Dynamics 365 Finance and Operations DynamicsCE - Приложения и настройки Microsoft Dynamics 365 Customer Engagement DynamicsBC - Приложения и надстройки Microsoft Dynamics 365 Business Central PowerBI - Отчеты, панели мониторинга и компоненты визуализации данных Microsoft Power BI ConsultingServices - Предложение профессиональных услуг, включая услуги по внедрению и консультационные услуги CosellOnly - Продукты, доступные исключительно в рамках партнерских программ Microsoft по совместным продажам CoreVirtualMachine - Основные предложения виртуальных машин с базовыми вычислительными возможностями Azure PowerBIVisuals - Пользовательские визуализации для платформы отчетов Microsoft Power BI Office365 - Приложения, надстройки и интеграции Microsoft 365 и Office 365 AADApps - Интегрированные приложения Azure Active Directory, поддерживающие идентификацию организации AzureServices - Собственные службы платформы Azure и поставщики ресурсов AppService - Веб-приложения, размещенные на платформе Azure App Service LogAnalytics - Решения Azure Monitor Log Analytics и конфигурации рабочих областей MicrosoftProduct - Собственные продукты Майкрософт доступны через каналы Marketplace
publisherDisplayName	string	Отображаемое имя издателя
publisherId	string	Идентификатор издателя
publisherType	string	Определяет отношения издателя с корпорацией Майкрософт для классификации поддержки и партнерства. Microsoft - Собственный продукт Microsoft с прямой поддержкой и разработкой Microsoft ThirdParty - Независимый поставщик программного продукта с поддержкой и обслуживанием, предоставляемыми издателем
publishingStage	string	Указывает состояние доступности продукта и уровень доступа клиентов в Azure Marketplace. Preview - Ограниченная доступность для избранных клиентов для тестирования и оценки раннего доступа Public - Общедоступная версия для всех клиентов Azure Marketplace для производственного развертывания
ratingAverage	number (double)	Средний рейтинг по офферу
ratingBuckets	string[]	Классифицирует продукты по пороговым значениям рейтинга клиентов для фильтрации и обнаружения на маркетплейсе. AboveOne - Товары с рейтингом покупателей выше 1,0 звезды на основе отзывов на маркетплейсе AboveTwo - Товары с рейтингом покупателей выше 2,0 звезд на основе отзывов на маркетплейсе AboveThree - Товары с рейтингом покупателей выше 3,0 звезд на основе отзывов на торговой площадке AboveFour - Товары с рейтингом покупателей выше 4,0 звезд на основе отзывов на маркетплейсе
ratingCount	integer (int32)	Общее количество оценок по офферу
service	string	Название службы продукта, например "Виртуальные машины"
serviceFamily	string	Семейство служб продукта, например "Вычисления"
smallIconUri	string	URI к маленькому значку продукта
summary	string	Краткая информация о продукте
supportedProducts	string[]	Карты со списком совместимых продуктов
uniqueProductId	string	Уникальный идентификатор продукта

ProductSummaryListResult

Объект

Пользовательский ответ на операцию списка.

Имя	Тип	Описание
nextLink	string	Ссылка на следующую страницу элементов
value	ProductSummary[]	Элементы на этой странице