Product List - List By Subscription

Servicio:

Marketplace Catalog

Versión de la API:

2025-05-01

Enumera los productos para suscripción.

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

Con parámetros opcionales:

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}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.
$expand	query		string	Expande las entidades relacionadas insertadas
$filter	query		string	Filtra los resultados, en función de una condición booleana. Ejemplo: $filter=productType eq 'VirtualMachine'. Los campos por los que se puede filtrar son: 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	Ordenación de la expresión de los resultados mediante la notación OData. Evite usar orderby a menos que sea esencial, ya que esto puede afectar la latencia de su solicitud. Ejemplo: $orderby=displayName desc. Esta API solo admite pedidos por un solo campo. Los campos por los que se puede ordenar son: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	Búsqueda opcional por nombre para mostrar, nombre para mostrar del editor o palabras clave. Ejemplo $search=Microsoft
$select	query		string	Selecciona las propiedades que se incluirán en los resultados. Ejemplo: $select=displayName
excludePublicOffersAndPublicPlans	query		boolean	Si excluir las ofertas públicas y los planes públicos de la respuesta. El valor predeterminado es false, lo que significa que las ofertas públicas y los planes públicos se incluyen en la respuesta. Si se establece en true, solo se devolverán los planes privados.
language	query		string	Idioma para buscar, código de dos letras ISO 639-1, valores posibles: 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. El valor predeterminado es "en"

Respuestas

Nombre	Tipo	Description
200 OK	ProductSummaryListResult	La solicitud se ha realizado correctamente.
Other Status Codes	DiscoveryErrorPayload	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

ProductList_ListBySubscription

Solicitud de ejemplo

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

Respuesta de muestra

status code:

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..."
}

Definiciones

Nombre	Description
Attribute	Representa un atributo SKU, que consta de una clave y un valor. Los atributos pueden diferir entre varios servicios.
DiscoveryErrorDetails	Detalles del error devueltos en DiscoveryErrorPayload
DiscoveryErrorPayload	Carga de error devuelta por las API de descubrimiento de Marketplace
PlanMetadata	Metadatos adicionales
PlanSummary	Devuelve un subconjunto de atributos Plan
ProductSummary	Devuelve un subconjunto de atributos Product
ProductSummaryListResult	La respuesta personalizada de una operación de lista.

Attribute

Objeto

Representa un atributo SKU, que consta de una clave y un valor. Los atributos pueden diferir entre varios servicios.

Nombre	Tipo	Description
key	string	La clave de atributo
value	string	El valor del atributo

DiscoveryErrorDetails

Objeto

Detalles del error devueltos en DiscoveryErrorPayload

Nombre	Tipo	Description
code	string	El código de error HTTP
message	string	Mensaje de error

DiscoveryErrorPayload

Objeto

Carga de error devuelta por las API de descubrimiento de Marketplace

Nombre	Tipo	Description
error	DiscoveryErrorDetails	El objeto de detalles del error

PlanMetadata

Objeto

Metadatos adicionales

Nombre	Tipo	Description
altStackReference	string	Apuntar a un planId que contiene la referencia de pila alternativa
generation	string	La generación de imágenes de máquina virtual (aplicable solo a productos de máquinas virtuales)

PlanSummary

Objeto

Devuelve un subconjunto de atributos Plan

Nombre	Tipo	Description
altArchitectureReference	string	La referencia de arquitectura alternativa
altStackReference	string	Referencia de pila alternativa
categoryIds	string[]	Plan CategoryIds
cspState	string	Controla la disponibilidad del plan y el acceso de los asociados dentro del programa Proveedor de soluciones en la nube (CSP) de Microsoft. OptIn - Permite a todos los socios proveedores de soluciones en la nube autorizados revender e implementar el producto a los clientes OptOut - Excluido del programa Cloud Solution Provider, disponible solo a través de canales directos SelectiveOptIn - Disponible solo para socios proveedores de soluciones en la nube seleccionados para la reventa y la implementación del cliente
description	string	Descripción del plan / SKU
displayName	string	Nombre para mostrar del plan / SKU
displayRank	string	El orden en que se muestra el plan en la tabla "Planes"
hasProtectedArtifacts	boolean	Se establece en true si el plan tiene artefactos que se van a ocultar para los usuarios no autenticados
hasRi	boolean	Indicación de si el SKU admite reservas
isPrivate	boolean	Indicación de que el plan es accesible solo para una audiencia restringida
metadata	PlanMetadata	Metadatos ampliados del plan/SKU.
planId	string	Identificador del plan
planType	string	Especifica el modelo de implementación principal y la arquitectura de hospedaje para el producto de Marketplace. Los valores admitidos actualmente son: None - Tipo de producto no especificado, normalmente se usa para productos sin un modelo de implementación definido DevService - Servicios y herramientas centrados en el desarrollo para flujos de trabajo de creación de software ManagedApplication - Aplicaciones administradas de Azure que implementan y administran recursos en suscripciones de clientes VirtualMachine - Imágenes de máquina virtual preconfiguradas que se pueden implementar en la infraestructura de proceso de Azure AzureApplication - Aplicaciones nativas de Azure que aprovechan los servicios de plataforma y las API Container - Aplicaciones en contenedores implementadas a través de Azure Container Instances o servicios similares SaaS - Soluciones de software como servicio alojadas y administradas por el editor SolutionTemplate - Plantillas de Azure Resource Manager que aprovisionan varios recursos de Azure IotEdgeModules - Módulos diseñados para la implementación en entornos de tiempo de ejecución de Azure IoT Edge ManagedServices - Servicios totalmente administrados en los que el editor maneja la infraestructura y las operaciones ContainerApps - Aplicaciones creadas para la plataforma de contenedores sin servidor de Azure Container Apps VisualStudioExtension - Extensiones que se integran con la funcionalidad IDE de Visual Studio DynamicsOps - Aplicaciones y extensiones de Microsoft Dynamics 365 Finance and Operations DynamicsCE - Aplicaciones y personalizaciones de Microsoft Dynamics 365 Customer Engagement DynamicsBC - Aplicaciones y complementos de Microsoft Dynamics 365 Business Central PowerBI - Informes, paneles y componentes de visualización de datos de Microsoft Power BI ConsultingServices - Ofertas de servicios profesionales que incluyen servicios de implementación y asesoramiento CosellOnly - Productos disponibles exclusivamente a través de los programas de socios de venta conjunta de Microsoft CoreVirtualMachine - Ofertas principales de máquinas virtuales con funcionalidades de proceso de Azure de referencia PowerBIVisuals - Visualizaciones personalizadas para la plataforma de informes de Microsoft Power BI Office365 - Aplicaciones, complementos e integraciones de Microsoft 365 y Office 365 AADApps - Aplicaciones integradas de Azure Active Directory que admiten la identidad de la organización AzureServices - Servicios nativos de la plataforma Azure y proveedores de recursos AppService - Aplicaciones web hospedadas en la plataforma Azure App Service LogAnalytics - Soluciones de Azure Monitor Log Analytics y configuraciones de área de trabajo MicrosoftProduct - Productos propios de Microsoft disponibles a través de canales de mercado
pricingTypes	string[]	Indica los modelos de facturación y las estructuras de costes disponibles para el plan. Free - Sin cargo por el uso del plan, generalmente para ediciones comunitarias o niveles de servicio básico FreeTrial - Período de acceso gratuito por tiempo limitado antes de la transición al modelo de facturación de pago Byol - Modelo Bring Your Own License en el que los clientes proporcionan licencias de software existentes Payg - Facturación basada en el consumo de pago por uso calculada sobre el uso real de los recursos Ri - Facturación de instancias reservadas con compromiso inicial para precios con descuento a largo plazo
skuId	string	El ID de SKU
stackType	string	Tipo de pila: Clásica, Gen1, Gen2
summary	string	El texto del resumen del plan
uniquePlanId	string	Identificador único del plan que se antepone mediante la combinación de uniqueProductId y PlanId sin ningún separador intermedio
vmArchitectureType	string	Especifica la arquitectura y la generación del procesador de la máquina virtual. Se aplica exclusivamente a los tipos de productos de máquinas virtuales. X64Gen1 - Arquitectura de procesador x64 con firmware de máquina virtual de generación 1 y compatibilidad con BIOS X64Gen2 - Arquitectura de procesador x64 con firmware de máquina virtual de generación 2 y compatibilidad con UEFI Arm64 - Arquitectura de procesador ARM de 64 bits optimizada para la eficiencia energética y las cargas de trabajo nativas de la nube
vmSecuritytypes	string[]	Define el nivel de mejora de seguridad para las implementaciones de máquinas virtuales. Se aplica exclusivamente a los tipos de productos de máquinas virtuales. None - Seguridad estándar de la máquina virtual sin funciones de protección adicionales Trusted - Seguridad de Trusted Launch con arranque seguro y capacidades virtuales del módulo de plataforma segura Confidential - Computación confidencial con cifrado de memoria y atestación para cargas de trabajo confidenciales

ProductSummary

Objeto

Devuelve un subconjunto de atributos Product

Nombre	Tipo	Description
applicableProducts	string[]	Categorías de productos a las que pertenece la oferta
attributes	Attribute[]	Conjunto de atributos de productos
azureBenefit	string	Indica si las compras de productos cuentan para las ventajas del compromiso de consumo de Azure para los clientes empresariales. Eligible - Los costos del producto se aplican a los cálculos y créditos de beneficios del compromiso de consumo de Azure NotEligible - Los costos del producto no califican para los programas de beneficios de compromiso de consumo de Azure
badges	string[]	Muestra las insignias de certificación y calificación obtenidas por el producto para la visibilidad del mercado. PreferredSolution - Solución reconocida por Microsoft que cumple con criterios específicos de calidad y asociación PowerBICertified - Compatibilidad e integración certificadas con la plataforma Microsoft Power BI AdditionalPurchaseRequirement - El producto requiere compras o suscripciones adicionales para una funcionalidad completa
categoryIds	string[]	Variedad de categorías de productos
cspLegalTermsUri	string	Los términos legales del producto para el CSP
description	string	El texto de la descripción del producto
displayName	string	Nombre para mostrar del producto
hasMarketplaceFootprint	boolean	Indicación de si el producto tiene representación en el mercado
hasRiPlans	boolean	Indicación de si el producto tiene planes con reservas
industryIds	string[]	Lista de ID de industria a los que pertenece el artículo
lastModifiedDateTime	string	Fecha de última actualización del producto
locations	string[]	Lista de ubicaciones que están disponibles en los SKU
longSummary	string	Resumen largo del producto
operatingSystems	string[]	Información del sistema operativo para este producto
plans	PlanSummary[]	Conjunto completo de atributos de plan/SKU
popularity	number (double)	Popularidad del producto
pricingTypes	string[]	Indica los modelos de facturación y las estructuras de costes disponibles para el plan. Free - Sin cargo por el uso del plan, generalmente para ediciones comunitarias o niveles de servicio básico FreeTrial - Período de acceso gratuito por tiempo limitado antes de la transición al modelo de facturación de pago Byol - Modelo Bring Your Own License en el que los clientes proporcionan licencias de software existentes Payg - Facturación basada en el consumo de pago por uso calculada sobre el uso real de los recursos Ri - Facturación de instancias reservadas con compromiso inicial para precios con descuento a largo plazo
privacyPolicyUri	string	La política de privacidad del producto
productFamily	string	Familia de productos
productId	string	El identificador único del producto
productSubType	string	Subtipo de producto
productType	string	Especifica el modelo de implementación principal y la arquitectura de hospedaje para el producto de Marketplace almacenado en el catálogo de Marketplace. None - Tipo de producto no especificado, normalmente se usa para productos sin un modelo de implementación definido ManagedApplication - Aplicaciones administradas de Azure que implementan y administran recursos en suscripciones de clientes VirtualMachine - Imágenes de máquina virtual preconfiguradas que se pueden implementar en la infraestructura de proceso de Azure AzureApplication - Aplicaciones nativas de Azure que aprovechan los servicios de plataforma y las API Container - Aplicaciones en contenedores implementadas a través de Azure Container Instances o servicios similares SaaS - Soluciones de software como servicio alojadas y administradas por el editor SolutionTemplate - Plantillas de Azure Resource Manager que aprovisionan varios recursos de Azure IotEdgeModules - Módulos diseñados para la implementación en entornos de tiempo de ejecución de Azure IoT Edge ManagedServices - Servicios totalmente administrados en los que el editor maneja la infraestructura y las operaciones ContainerApps - Aplicaciones creadas para la plataforma de contenedores sin servidor de Azure Container Apps DynamicsOps - Aplicaciones y extensiones de Microsoft Dynamics 365 Finance and Operations DynamicsCE - Aplicaciones y personalizaciones de Microsoft Dynamics 365 Customer Engagement DynamicsBC - Aplicaciones y complementos de Microsoft Dynamics 365 Business Central PowerBI - Informes, paneles y componentes de visualización de datos de Microsoft Power BI ConsultingServices - Ofertas de servicios profesionales que incluyen servicios de implementación y asesoramiento CosellOnly - Productos disponibles exclusivamente a través de los programas de socios de venta conjunta de Microsoft CoreVirtualMachine - Ofertas principales de máquinas virtuales con funcionalidades de proceso de Azure de referencia PowerBIVisuals - Visualizaciones personalizadas para la plataforma de informes de Microsoft Power BI Office365 - Aplicaciones, complementos e integraciones de Microsoft 365 y Office 365 AADApps - Aplicaciones integradas de Azure Active Directory que admiten la identidad de la organización AzureServices - Servicios nativos de la plataforma Azure y proveedores de recursos AppService - Aplicaciones web hospedadas en la plataforma Azure App Service LogAnalytics - Soluciones de Azure Monitor Log Analytics y configuraciones de área de trabajo MicrosoftProduct - Productos propios de Microsoft disponibles a través de canales de mercado
publisherDisplayName	string	Nombre para mostrar del publicador
publisherId	string	ID del editor
publisherType	string	Identifica la relación del editor con Microsoft para la clasificación de soporte técnico y asociación. Microsoft - Producto de Microsoft propio con soporte y desarrollo directos de Microsoft ThirdParty - Producto de proveedor de software independiente con soporte y mantenimiento proporcionados por el editor
publishingStage	string	Indica el estado de disponibilidad del producto y el nivel de acceso del cliente en Azure Marketplace. Preview - Disponibilidad limitada para clientes seleccionados para pruebas y evaluación de acceso anticipado Public - Disponibilidad general para todos los clientes de Azure Marketplace para la implementación de producción
ratingAverage	number (double)	Valoración media de la oferta
ratingBuckets	string[]	Clasifica los productos por umbrales de calificación de clientes para el filtrado y la detección de marketplaces. AboveOne - Productos con calificaciones de clientes superiores a 1.0 estrellas según las reseñas del mercado AboveTwo - Productos con calificaciones de clientes superiores a 2.0 estrellas según las reseñas del mercado AboveThree - Productos con calificaciones de clientes superiores a 3.0 estrellas según las reseñas del mercado AboveFour - Productos con calificaciones de clientes superiores a 4.0 estrellas según las reseñas del mercado
ratingCount	integer (int32)	Número total de valoraciones de la oferta
service	string	El nombre del servicio del producto, como "Máquinas virtuales"
serviceFamily	string	La familia de servicios del producto, como "Compute"
smallIconUri	string	URI al icono de producto pequeño
summary	string	Resumen del producto
supportedProducts	string[]	Se asigna a la lista de productos compatibles
uniqueProductId	string	Identificador de producto único

ProductSummaryListResult

Objeto

La respuesta personalizada de una operación de lista.

Nombre	Tipo	Description
nextLink	string	El enlace a la siguiente página de artículos
value	ProductSummary[]	Los elementos de esta página