Product List - List By Subscription

Servizio:

Marketplace Catalog

Versione API:

2025-05-01

Elenca i prodotti per l'abbonamento.

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

Con parametri facoltativi:

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}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.
$expand	query		string	Espande le entità correlate inline
$filter	query		string	Filtra i risultati in base a una condizione booleana. Esempio: $filter=productType eq 'VirtualMachine'. I campi che possono essere filtrati sono: 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	Espressione di ordinamento per i risultati utilizzando la notazione OData. Evitare di usare orderby a meno che non sia necessario in quanto ciò potrebbe influire sulla latenza della richiesta. Esempio: $orderby=displayName desc. Questa API supporta solo l'ordinamento in base a un singolo campo. I campi in base ai quali è possibile ordinare sono: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	Ricerca facoltativa per nome visualizzato, nome visualizzato dell'editore o parole chiave. Esempio $search=Microsoft
$select	query		string	Seleziona le proprietà da includere nei risultati. Esempio: $select=displayName
excludePublicOffersAndPublicPlans	query		boolean	Indica se escludere le offerte pubbliche e i piani pubblici dalla risposta. Il valore predefinito è false, il che significa che le offerte pubbliche e i piani pubblici sono inclusi nella risposta. Se impostato su true, verranno restituiti solo i piani privati.
language	query		string	Lingua da cercare, codice ISO 639-1 a due lettere, valori possibili - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Il valore predefinito è "en"

Risposte

Nome	Tipo	Descrizione
200 OK	ProductSummaryListResult	La richiesta ha avuto esito positivo.
Other Status Codes	DiscoveryErrorPayload	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

ProductList_ListBySubscription

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
Attribute	Rappresenta un attributo SKU, costituito da una chiave e un valore. Gli attributi possono differire tra i vari servizi.
DiscoveryErrorDetails	Dettagli dell'errore restituiti in DiscoveryErrorPayload
DiscoveryErrorPayload	Payload di errore restituito dalle API di individuazione del marketplace
PlanMetadata	Metadati aggiuntivi
PlanSummary	Restituisce un sottoinsieme di attributi del piano
ProductSummary	Restituisce un sottoinsieme di attributi del prodotto
ProductSummaryListResult	Risposta personalizzata di un'operazione di elenco.

Attribute

Oggetto

Rappresenta un attributo SKU, costituito da una chiave e un valore. Gli attributi possono differire tra i vari servizi.

Nome	Tipo	Descrizione
key	string	La chiave dell'attributo
value	string	Il valore dell'attributo

DiscoveryErrorDetails

Oggetto

Dettagli dell'errore restituiti in DiscoveryErrorPayload

Nome	Tipo	Descrizione
code	string	Codice di errore HTTP
message	string	Messaggio di errore

DiscoveryErrorPayload

Oggetto

Payload di errore restituito dalle API di individuazione del marketplace

Nome	Tipo	Descrizione
error	DiscoveryErrorDetails	L'oggetto dei dettagli dell'errore

PlanMetadata

Oggetto

Metadati aggiuntivi

Nome	Tipo	Descrizione
altStackReference	string	Puntamento a un planId che contiene il riferimento allo stack alternativo
generation	string	La generazione dell'immagine della macchina virtuale (applicabile solo ai prodotti Virtual Machine)

PlanSummary

Oggetto

Restituisce un sottoinsieme di attributi del piano

Nome	Tipo	Descrizione
altArchitectureReference	string	Il riferimento all'architettura alternativa
altStackReference	string	Riferimento stack alternativo
categoryIds	string[]	Pianificare CategoryIds
cspState	string	Controlla la disponibilità del piano e l'accesso dei partner all'interno del programma Microsoft Cloud Solution Provider (CSP). OptIn - Consente a tutti i partner Cloud Solution Provider autorizzati di rivendere e distribuire il prodotto ai clienti OptOut - Esclusi dal programma Cloud Solution Provider, disponibile solo attraverso canali diretti SelectiveOptIn - Disponibile solo per i partner Cloud Solution Provider selezionati per la rivendita e la distribuzione da parte dei clienti
description	string	Descrizione del piano / sku
displayName	string	Nome visualizzato del piano/SKU
displayRank	string	L'ordine in cui il piano viene visualizzato nella tabella 'Piani'
hasProtectedArtifacts	boolean	Impostare su true se il piano contiene elementi che devono essere nascosti per gli utenti non autenticati
hasRi	boolean	Indicazione se lo SKU supporta le prenotazioni
isPrivate	boolean	Indicazione che il piano è accessibile solo a un pubblico ristretto
metadata	PlanMetadata	Metadati del piano/SKU ampliati.
planId	string	Identificatore del piano
planType	string	Specifica il modello di distribuzione principale e l'architettura di hosting per il prodotto del marketplace. I valori attualmente supportati sono: None - Tipo di prodotto non specificato, in genere utilizzato per prodotti senza un modello di distribuzione definito DevService - Servizi e strumenti incentrati sullo sviluppo per i flussi di lavoro di creazione del software ManagedApplication - Applicazioni gestite di Azure che distribuiscono e gestiscono le risorse nelle sottoscrizioni dei clienti VirtualMachine - Immagini di macchine virtuali preconfigurate distribuibili nell'infrastruttura di calcolo di Azure AzureApplication - Applicazioni Azure native che sfruttano i servizi della piattaforma e le API Container - Applicazioni containerizzate distribuite tramite Istanze di Azure Container o servizi simili SaaS - Soluzioni Software as a Service ospitate e gestite dall'editore SolutionTemplate - Modelli di Azure Resource Manager che effettuano il provisioning di più risorse di Azure IotEdgeModules - Moduli progettati per la distribuzione in ambienti di runtime Azure IoT Edge ManagedServices - Servizi completamente gestiti in cui l'editore gestisce l'infrastruttura e le operazioni ContainerApps - Applicazioni create per la piattaforma di contenitori serverless di App Azure Container VisualStudioExtension - Estensioni che si integrano con la funzionalità IDE di Visual Studio DynamicsOps - Applicazioni ed estensioni di Microsoft Dynamics 365 Finance and Operations DynamicsCE - Applicazioni e personalizzazioni di Microsoft Dynamics 365 Customer Engagement DynamicsBC - Applicazioni e componenti aggiuntivi di Microsoft Dynamics 365 Business Central PowerBI - Report, dashboard e componenti di visualizzazione dei dati di Microsoft Power BI ConsultingServices - Offerte di servizi professionali, tra cui servizi di implementazione e consulenza CosellOnly - Prodotti disponibili esclusivamente tramite i programmi per i partner di co-selling Microsoft CoreVirtualMachine - Offerte di macchine virtuali di base con funzionalità di calcolo di base di Azure PowerBIVisuals - Visualizzazioni personalizzate per la piattaforma di reporting Microsoft Power BI Office365 - Applicazioni, componenti aggiuntivi e integrazioni di Microsoft 365 e Office 365 AADApps - Applicazioni integrate di Azure Active Directory che supportano l'identità organizzativa AzureServices - Servizi e fornitori di risorse nativi della piattaforma Azure AppService - Applicazioni Web ospitate nella piattaforma del servizio app di Azure LogAnalytics - Soluzioni Log Analytics di Monitoraggio di Azure e configurazioni dell'area di lavoro MicrosoftProduct - Prodotti Microsoft proprietari disponibili tramite i canali del marketplace
pricingTypes	string[]	Indica i modelli di fatturazione e le strutture dei costi disponibili per il piano. Free - Nessun addebito per l'utilizzo del piano, in genere per le edizioni community o i livelli di servizio di base FreeTrial - Periodo di accesso gratuito limitato nel tempo prima del passaggio al modello di fatturazione a pagamento Byol - Modello Bring Your Own License in cui i clienti forniscono licenze software esistenti Payg - Fatturazione basata sul consumo con pagamento in base al consumo, calcolata sull'utilizzo effettivo delle risorse Ri - Fatturazione di istanze riservate con impegno anticipato per prezzi scontati a lungo termine
skuId	string	L'ID SKU
stackType	string	Tipo di stack : Classic, Gen1, Gen2
summary	string	Il testo riassuntivo del piano
uniquePlanId	string	Identificatore univoco del piano preceduto dalla combinazione di uniqueProductId e PlanId senza separatori intermedi
vmArchitectureType	string	Specifica l'architettura e la generazione del processore della macchina virtuale. Si applica esclusivamente ai tipi di prodotto Macchina virtuale. X64Gen1 - architettura del processore x64 con firmware della macchina virtuale di prima generazione e supporto del BIOS X64Gen2 - architettura del processore x64 con firmware della macchina virtuale di seconda generazione e supporto UEFI Arm64 - Architettura del processore ARM a 64 bit ottimizzata per l'efficienza energetica e i carichi di lavoro nativi per il cloud
vmSecuritytypes	string[]	Definisce il livello di miglioramento della sicurezza per le distribuzioni di macchine virtuali. Si applica esclusivamente ai tipi di prodotto Macchina virtuale. None - Sicurezza standard delle macchine virtuali senza funzionalità di protezione aggiuntive Trusted - Sicurezza Trusted Launch con avvio sicuro e funzionalità virtuali del Trusted Platform Module Confidential - Confidential computing con crittografia della memoria e attestazione per carichi di lavoro sensibili

ProductSummary

Oggetto

Restituisce un sottoinsieme di attributi del prodotto

Nome	Tipo	Descrizione
applicableProducts	string[]	Categorie di prodotti a cui appartiene l'offerta
attributes	Attribute[]	Set di attributi dei prodotti
azureBenefit	string	Indica se gli acquisti di prodotti vengono conteggiati ai fini dei vantaggi dell'impegno di consumo di Azure per i clienti aziendali. Eligible - I costi del prodotto si applicano ai calcoli e ai crediti dei vantaggi dell'impegno a consumo di Azure NotEligible - I costi del prodotto non sono idonei per i programmi di benefit per l'impegno al consumo di Azure
badges	string[]	Mostra i badge di certificazione e qualifica ottenuti dal prodotto per la visibilità sul marketplace. PreferredSolution - Soluzione riconosciuta da Microsoft che soddisfa specifici criteri di qualità e partnership PowerBICertified - Compatibilità e integrazione certificate con la piattaforma Microsoft Power BI AdditionalPurchaseRequirement - Il prodotto richiede acquisti o abbonamenti aggiuntivi per la piena funzionalità
categoryIds	string[]	Varietà di categorie di prodotti
cspLegalTermsUri	string	Condizioni legali del prodotto per il CSP
description	string	Il testo della descrizione del prodotto
displayName	string	Nome visualizzato del prodotto
hasMarketplaceFootprint	boolean	Indicazione se il prodotto ha una rappresentazione sul mercato
hasRiPlans	boolean	Indicazione se il prodotto ha piani con riserve
industryIds	string[]	Elenco degli ID settore a cui appartiene l'articolo
lastModifiedDateTime	string	Data dell'ultimo aggiornamento del prodotto
locations	string[]	Elenco delle ubicazioni disponibili nelle referenze
longSummary	string	Riassunto lungo del prodotto
operatingSystems	string[]	Informazioni sul sistema operativo per questo prodotto
plans	PlanSummary[]	Set completo di attributi del piano/SKU
popularity	number (double)	Popolarità del prodotto
pricingTypes	string[]	Indica i modelli di fatturazione e le strutture dei costi disponibili per il piano. Free - Nessun addebito per l'utilizzo del piano, in genere per le edizioni community o i livelli di servizio di base FreeTrial - Periodo di accesso gratuito limitato nel tempo prima del passaggio al modello di fatturazione a pagamento Byol - Modello Bring Your Own License in cui i clienti forniscono licenze software esistenti Payg - Fatturazione basata sul consumo con pagamento in base al consumo, calcolata sull'utilizzo effettivo delle risorse Ri - Fatturazione di istanze riservate con impegno anticipato per prezzi scontati a lungo termine
privacyPolicyUri	string	L'informativa sulla privacy del prodotto
productFamily	string	Famiglia di prodotti
productId	string	L'ID univoco del prodotto
productSubType	string	Sottotipo di prodotto
productType	string	Specifica il modello di distribuzione principale e l'architettura di hosting per il prodotto del Marketplace archiviato nel Catalogo del Marketplace. None - Tipo di prodotto non specificato, in genere utilizzato per prodotti senza un modello di distribuzione definito ManagedApplication - Applicazioni gestite di Azure che distribuiscono e gestiscono le risorse nelle sottoscrizioni dei clienti VirtualMachine - Immagini di macchine virtuali preconfigurate distribuibili nell'infrastruttura di calcolo di Azure AzureApplication - Applicazioni Azure native che sfruttano i servizi della piattaforma e le API Container - Applicazioni containerizzate distribuite tramite Istanze di Azure Container o servizi simili SaaS - Soluzioni Software as a Service ospitate e gestite dall'editore SolutionTemplate - Modelli di Azure Resource Manager che effettuano il provisioning di più risorse di Azure IotEdgeModules - Moduli progettati per la distribuzione in ambienti di runtime Azure IoT Edge ManagedServices - Servizi completamente gestiti in cui l'editore gestisce l'infrastruttura e le operazioni ContainerApps - Applicazioni create per la piattaforma di contenitori serverless di App Azure Container DynamicsOps - Applicazioni ed estensioni di Microsoft Dynamics 365 Finance and Operations DynamicsCE - Applicazioni e personalizzazioni di Microsoft Dynamics 365 Customer Engagement DynamicsBC - Applicazioni e componenti aggiuntivi di Microsoft Dynamics 365 Business Central PowerBI - Report, dashboard e componenti di visualizzazione dei dati di Microsoft Power BI ConsultingServices - Offerte di servizi professionali, tra cui servizi di implementazione e consulenza CosellOnly - Prodotti disponibili esclusivamente tramite i programmi per i partner di co-selling Microsoft CoreVirtualMachine - Offerte di macchine virtuali di base con funzionalità di calcolo di base di Azure PowerBIVisuals - Visualizzazioni personalizzate per la piattaforma di reporting Microsoft Power BI Office365 - Applicazioni, componenti aggiuntivi e integrazioni di Microsoft 365 e Office 365 AADApps - Applicazioni integrate di Azure Active Directory che supportano l'identità organizzativa AzureServices - Servizi e fornitori di risorse nativi della piattaforma Azure AppService - Applicazioni Web ospitate nella piattaforma del servizio app di Azure LogAnalytics - Soluzioni Log Analytics di Monitoraggio di Azure e configurazioni dell'area di lavoro MicrosoftProduct - Prodotti Microsoft proprietari disponibili tramite i canali del marketplace
publisherDisplayName	string	Nome visualizzato dell'editore
publisherId	string	ID editore
publisherType	string	Identifica la relazione tra l'editore e Microsoft per il supporto e la classificazione delle partnership. Microsoft - Prodotto Microsoft di prima parte con supporto e sviluppo diretti da Microsoft ThirdParty - Prodotto di un fornitore di software indipendente con supporto e manutenzione forniti dall'editore
publishingStage	string	Indica lo stato di disponibilità del prodotto e il livello di accesso del cliente all'interno di Azure Marketplace. Preview - Disponibilità limitata a clienti selezionati per test e valutazione dell'accesso anticipato Public - Disponibilità generale per tutti i clienti di Azure Marketplace per la distribuzione di produzione
ratingAverage	number (double)	Valutazione media dell'offerta
ratingBuckets	string[]	Classifica i prodotti in base alle soglie di valutazione dei clienti per il filtraggio e l'individuazione del marketplace. AboveOne - Prodotti con valutazioni dei clienti superiori a 1,0 stelle in base alle recensioni del marketplace AboveTwo - Prodotti con valutazioni dei clienti superiori a 2,0 stelle in base alle recensioni del marketplace AboveThree - Prodotti con valutazioni dei clienti superiori a 3,0 stelle in base alle recensioni del marketplace AboveFour - Prodotti con valutazioni dei clienti superiori a 4,0 stelle in base alle recensioni del marketplace
ratingCount	integer (int32)	Numero totale di valutazioni per l'offerta
service	string	Il nome del servizio del prodotto, ad esempio "Macchine virtuali"
serviceFamily	string	La famiglia di servizi del prodotto, ad esempio "Calcolo"
smallIconUri	string	URI dell'icona del prodotto piccolo
summary	string	Riassunto del prodotto
supportedProducts	string[]	Mappa l'elenco dei prodotti compatibili
uniqueProductId	string	Identificatore univoco del prodotto

ProductSummaryListResult

Oggetto

Risposta personalizzata di un'operazione di elenco.

Nome	Tipo	Descrizione
nextLink	string	Collegamento alla pagina successiva di elementi
value	ProductSummary[]	Gli elementi di questa pagina