Product List - List By Subscription

Service:

Marketplace Catalog

API-versie:

2025-05-01

Geeft een lijst van producten waarop u zich kunt abonneren.

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

Met optionele parameters:

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-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
$expand	query		string	Breidt gerelateerde entiteiten inline uit
$filter	query		string	Filtert de resultaten op basis van een Booleaanse voorwaarde. Voorbeeld: $filter=productType eq 'VirtualMachine'. Velden waarop kan worden gefilterd zijn: 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	Rangschikking van expressie voor de resultaten met behulp van OData-notatie. Vermijd het gebruik van orderby, tenzij dit essentieel is, omdat dit van invloed kan zijn op de latentie van uw verzoek. Voorbeeld: $orderby=displayName desc. Deze API ondersteunt alleen het bestellen op basis van een enkel veld. Velden die kunnen worden geordend op zijn: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	Optioneel zoeken op weergavenaam, weergavenaam van uitgever of trefwoorden. Voorbeeld $search=Microsoft
$select	query		string	Selecteert welke eigenschappen in de resultaten moeten worden opgenomen. Voorbeeld: $select=weergavenaam
excludePublicOffersAndPublicPlans	query		boolean	Of openbare aanbiedingen en openbare plannen moeten worden uitgesloten van de reactie. Standaard is onwaar, wat betekent dat openbare aanbiedingen en openbare abonnementen zijn opgenomen in de reactie. Als je deze instelling op waar zet, worden alleen privéabonnementen geretourneerd.
language	query		string	Taal om te zoeken, ISO 639-1 tweeletterige code, mogelijke waarden - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. De standaardinstelling is "en"

Antwoorden

Name	Type	Description
200 OK	ProductSummaryListResult	De aanvraag is voltooid.
Other Status Codes	DiscoveryErrorPayload	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ProductList_ListBySubscription

Voorbeeldaanvraag

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
Attribute	Vertegenwoordigt een SKU-kenmerk, dat bestaat uit een sleutel en een waarde. De kenmerken kunnen verschillen tussen verschillende services.
DiscoveryErrorDetails	Foutdetails die worden geretourneerd in DiscoveryErrorPayload
DiscoveryErrorPayload	Fout-payload geretourneerd door Marketplace Discovery-API's
PlanMetadata	Aanvullende metagegevens
PlanSummary	Retourneert een subset van plankenmerken
ProductSummary	Retourneert een subset van productkenmerken
ProductSummaryListResult	De aangepaste reactie van een lijstbewerking.

Attribute

Object

Vertegenwoordigt een SKU-kenmerk, dat bestaat uit een sleutel en een waarde. De kenmerken kunnen verschillen tussen verschillende services.

Name	Type	Description
key	string	De kenmerktoets
value	string	De waarde van het kenmerk

DiscoveryErrorDetails

Object

Foutdetails die worden geretourneerd in DiscoveryErrorPayload

Name	Type	Description
code	string	De HTTP-foutcode
message	string	Het foutbericht

DiscoveryErrorPayload

Object

Fout-payload geretourneerd door Marketplace Discovery-API's

Name	Type	Description
error	DiscoveryErrorDetails	Het object met foutdetails

PlanMetadata

Object

Aanvullende metagegevens

Name	Type	Description
altStackReference	string	Aanwijzen naar een planId die de alternatieve stackverwijzing bevat
generation	string	Het genereren van VM-installatiekopieën (alleen van toepassing op Virtual Machine-producten)

PlanSummary

Object

Retourneert een subset van plankenmerken

Name	Type	Description
altArchitectureReference	string	De alternatieve architectuurreferentie
altStackReference	string	Alternatieve stackreferentie
categoryIds	string[]	Plan CategoryIds
cspState	string	Bepaalt de beschikbaarheid van het plan en de toegang van partners binnen het Microsoft Cloud Solution Provider (CSP)-programma. OptIn - Stelt alle geautoriseerde Cloud Solution Provider-partners in staat om het product door te verkopen en te implementeren aan klanten OptOut - Uitgesloten van het Cloud Solution Provider-programma, alleen beschikbaar via directe kanalen SelectiveOptIn - Alleen beschikbaar voor geselecteerde Cloud Solution Provider-partners voor wederverkoop en implementatie bij klanten
description	string	Plan / SKU beschrijving
displayName	string	Weergavenaam van het plan / sku
displayRank	string	De volgorde waarin het plan wordt weergegeven in de tabel 'Plannen'
hasProtectedArtifacts	boolean	Ingesteld op true als het plan artefacten bevat die moeten worden verborgen voor niet-geverifieerde gebruikers
hasRi	boolean	Indicatie of de SKU reserveringen ondersteunt
isPrivate	boolean	Indicatie dat het abonnement alleen toegankelijk is voor een beperkt publiek
metadata	PlanMetadata	Uitgebreide plan-/SKU-metagegevens.
planId	string	Identificatie van het plan
planType	string	Hiermee geeft u het primaire implementatiemodel en de hostingarchitectuur voor het Marketplace-product op. Momenteel ondersteunde waarden zijn: None - Niet-gespecificeerd producttype, meestal gebruikt voor producten zonder een gedefinieerd implementatiemodel DevService - Ontwikkelingsgerichte diensten en tools voor workflows voor het maken van software ManagedApplication - Door Azure beheerde toepassingen die resources implementeren en beheren in klantabonnementen VirtualMachine - Vooraf geconfigureerde installatiekopieën van virtuele machines die kunnen worden geïmplementeerd in de Azure-rekeninfrastructuur AzureApplication - Native Azure-applicaties die gebruikmaken van platformservices en API's Container - Toepassingen in containers die zijn geïmplementeerd via Azure Container Instances of vergelijkbare services SaaS - Software as a Service-oplossingen die worden gehost en beheerd door de uitgever SolutionTemplate - Azure Resource Manager-sjablonen die meerdere Azure-resources inrichten IotEdgeModules - Modules die zijn ontworpen voor implementatie in Azure IoT Edge runtime-omgevingen ManagedServices - Volledig beheerde services waarbij de uitgever de infrastructuur en operaties afhandelt ContainerApps - Toepassingen die zijn gebouwd voor Azure Container Apps serverloos containerplatform VisualStudioExtension - Extensies die integreren met Visual Studio IDE-functionaliteit DynamicsOps - Microsoft Dynamics 365 Finance and Operations-applicaties en -extensies DynamicsCE - Microsoft Dynamics 365 Customer Engagement-toepassingen en -aanpassingen DynamicsBC - Microsoft Dynamics 365 Business Central-applicaties en add-ons PowerBI - Microsoft Power BI-rapporten, dashboards en onderdelen voor gegevensvisualisatie ConsultingServices - Aanbod van professionele diensten, waaronder implementatie- en adviesdiensten CosellOnly - Producten die exclusief beschikbaar zijn via partnerprogramma's voor co-selling van Microsoft CoreVirtualMachine - Kernaanbiedingen voor virtuele machines met basislijnmogelijkheden voor Azure-rekenkracht PowerBIVisuals - Aangepaste visualisaties voor het Microsoft Power BI-rapportageplatform Office365 - Microsoft 365- en Office 365-toepassingen, invoegtoepassingen en integraties AADApps - Geïntegreerde Azure Active Directory-toepassingen die de identiteit van de organisatie ondersteunen AzureServices - Native Azure-platformservices en resourceproviders AppService - Webtoepassingen die worden gehost op het Azure App Service-platform LogAnalytics - Azure Monitor Log Analytics-oplossingen en werkruimteconfiguraties MicrosoftProduct - First-party Microsoft-producten die beschikbaar zijn via marktplaatskanalen
pricingTypes	string[]	Geeft de factureringsmodellen en kostenstructuren aan die beschikbaar zijn voor het abonnement. Free - Geen kosten voor het gebruik van het abonnement, meestal voor community-edities of basisserviceniveaus FreeTrial - Tijdelijke gratis toegangsperiode voordat wordt overgestapt op een betaald factureringsmodel Byol - Bring Your Own License-model waarbij klanten bestaande softwarelicenties leveren Payg - Pay As You Go-facturering op basis van verbruik, berekend op basis van het werkelijke resourcegebruik Ri - Facturering van gereserveerde instanties met toezegging vooraf voor gereduceerde prijzen op lange termijn
skuId	string	De SKU-id
stackType	string	Type stapel : Klassiek, Gen1, Gen2
summary	string	De samenvattende tekst van het plan
uniquePlanId	string	Unieke plan-ID die wordt voorafgegaan door een combinatie van uniqueProductId en PlanId zonder scheidingsteken ertussen
vmArchitectureType	string	Hiermee geeft u de architectuur en generatie van de processor van de virtuele machine op. Is uitsluitend van toepassing op producttypen van virtuele machines. X64Gen1 - x64-processorarchitectuur met firmware voor virtuele machines van de eerste generatie en BIOS-ondersteuning X64Gen2 - x64-processorarchitectuur met firmware voor virtuele machines van generatie 2 en UEFI-ondersteuning Arm64 - ARM 64-bits processorarchitectuur geoptimaliseerd voor energie-efficiëntie en cloud-native workloads
vmSecuritytypes	string[]	Definieert het beveiligingsverbeteringsniveau voor implementaties van virtuele machines. Is uitsluitend van toepassing op producttypen van virtuele machines. None - Standaard beveiliging van virtuele machines zonder extra beveiligingsfuncties Trusted - Trusted Launch-beveiliging met veilig opstarten en virtuele Trusted Platform Module-mogelijkheden Confidential - Vertrouwelijk computergebruik met geheugenversleuteling en attestatie voor gevoelige workloads

ProductSummary

Object

Retourneert een subset van productkenmerken

Name	Type	Description
applicableProducts	string[]	Productcategorieën waartoe het aanbod behoort
attributes	Attribute[]	Set productkenmerken
azureBenefit	string	Geeft aan of productaankopen meetellen voor de voordelen van Azure-verbruikstoezegging voor zakelijke klanten. Eligible - Productkosten zijn van toepassing op berekeningen en tegoeden van Azure-verbruikstoezegging NotEligible - Productkosten komen niet in aanmerking voor programma's voor Azure-verbruikstoezegging
badges	string[]	Geeft certificerings- en kwalificatiebadges weer die door het product zijn verdiend voor zichtbaarheid op de markt. PreferredSolution - Door Microsoft erkende oplossing die voldoet aan specifieke kwaliteits- en partnerschapscriteria PowerBICertified - Gecertificeerde compatibiliteit en integratie met het Microsoft Power BI-platform AdditionalPurchaseRequirement - Product vereist extra aankopen of abonnementen voor volledige functionaliteit
categoryIds	string[]	Scala aan productcategorieën
cspLegalTermsUri	string	De wettelijke voorwaarden van het product voor de CSP
description	string	De tekst van de productbeschrijving
displayName	string	Weergavenaam van het product
hasMarketplaceFootprint	boolean	Indicatie of het product een vertegenwoordiging op de markt heeft
hasRiPlans	boolean	Indicatie of het product plannen heeft met voorbehoud
industryIds	string[]	Lijst met branche-ID's waartoe het item behoort
lastModifiedDateTime	string	Laatste updatedatum van het product
locations	string[]	Lijst van locaties die beschikbaar zijn op de SKU's
longSummary	string	Product lange samenvatting
operatingSystems	string[]	Informatie over het besturingssysteem voor dit product
plans	PlanSummary[]	Volledige set plan-/SKU-kenmerken
popularity	number (double)	Populariteit van het product
pricingTypes	string[]	Geeft de factureringsmodellen en kostenstructuren aan die beschikbaar zijn voor het abonnement. Free - Geen kosten voor het gebruik van het abonnement, meestal voor community-edities of basisserviceniveaus FreeTrial - Tijdelijke gratis toegangsperiode voordat wordt overgestapt op een betaald factureringsmodel Byol - Bring Your Own License-model waarbij klanten bestaande softwarelicenties leveren Payg - Pay As You Go-facturering op basis van verbruik, berekend op basis van het werkelijke resourcegebruik Ri - Facturering van gereserveerde instanties met toezegging vooraf voor gereduceerde prijzen op lange termijn
privacyPolicyUri	string	Het privacybeleid van het product
productFamily	string	Productfamilie
productId	string	De unieke id van het product
productSubType	string	Subtype product
productType	string	Hiermee geeft u het primaire implementatiemodel en de hostingarchitectuur op voor het Marketplace-product dat is opgeslagen in de Marketplace-catalogus. None - Niet-gespecificeerd producttype, meestal gebruikt voor producten zonder een gedefinieerd implementatiemodel ManagedApplication - Door Azure beheerde toepassingen die resources implementeren en beheren in klantabonnementen VirtualMachine - Vooraf geconfigureerde installatiekopieën van virtuele machines die kunnen worden geïmplementeerd in de Azure-rekeninfrastructuur AzureApplication - Native Azure-applicaties die gebruikmaken van platformservices en API's Container - Toepassingen in containers die zijn geïmplementeerd via Azure Container Instances of vergelijkbare services SaaS - Software as a Service-oplossingen die worden gehost en beheerd door de uitgever SolutionTemplate - Azure Resource Manager-sjablonen die meerdere Azure-resources inrichten IotEdgeModules - Modules die zijn ontworpen voor implementatie in Azure IoT Edge runtime-omgevingen ManagedServices - Volledig beheerde services waarbij de uitgever de infrastructuur en operaties afhandelt ContainerApps - Toepassingen die zijn gebouwd voor Azure Container Apps serverloos containerplatform DynamicsOps - Microsoft Dynamics 365 Finance and Operations-applicaties en -extensies DynamicsCE - Microsoft Dynamics 365 Customer Engagement-toepassingen en -aanpassingen DynamicsBC - Microsoft Dynamics 365 Business Central-applicaties en add-ons PowerBI - Microsoft Power BI-rapporten, dashboards en onderdelen voor gegevensvisualisatie ConsultingServices - Aanbod van professionele diensten, waaronder implementatie- en adviesdiensten CosellOnly - Producten die exclusief beschikbaar zijn via partnerprogramma's voor co-selling van Microsoft CoreVirtualMachine - Kernaanbiedingen voor virtuele machines met basislijnmogelijkheden voor Azure-rekenkracht PowerBIVisuals - Aangepaste visualisaties voor het Microsoft Power BI-rapportageplatform Office365 - Microsoft 365- en Office 365-toepassingen, invoegtoepassingen en integraties AADApps - Geïntegreerde Azure Active Directory-toepassingen die de identiteit van de organisatie ondersteunen AzureServices - Native Azure-platformservices en resourceproviders AppService - Webtoepassingen die worden gehost op het Azure App Service-platform LogAnalytics - Azure Monitor Log Analytics-oplossingen en werkruimteconfiguraties MicrosoftProduct - First-party Microsoft-producten die beschikbaar zijn via marktplaatskanalen
publisherDisplayName	string	Weergavenaam van uitgever
publisherId	string	Uitgever-id
publisherType	string	Identificeert de uitgeversrelatie met Microsoft voor ondersteuning en partnerschapsclassificatie. Microsoft - First-party Microsoft-product met directe Microsoft-ondersteuning en -ontwikkeling ThirdParty - Product van een onafhankelijke softwareleverancier met door de uitgever geleverde ondersteuning en onderhoud
publishingStage	string	Geeft de beschikbaarheidsstatus van het product en het toegangsniveau van de klant aan binnen Azure Marketplace. Preview - Beperkte beschikbaarheid voor geselecteerde klanten voor testen en evaluatie van vroege toegang Public - Algemene beschikbaarheid voor alle Azure Marketplace-klanten voor productie-implementatie
ratingAverage	number (double)	Gemiddelde beoordeling voor de aanbieding
ratingBuckets	string[]	Categoriseert producten op basis van klantbeoordelingsdrempels voor het filteren en ontdekken van marktplaatsen. AboveOne - Producten met klantbeoordelingen van meer dan 1,0 sterren op basis van marktplaatsrecensies AboveTwo - Producten met klantbeoordelingen van meer dan 2,0 sterren op basis van marktplaatsrecensies AboveThree - Producten met klantbeoordelingen van meer dan 3,0 sterren op basis van marktplaatsrecensies AboveFour - Producten met klantbeoordelingen van meer dan 4,0 sterren op basis van marktplaatsrecensies
ratingCount	integer (int32)	Totaal aantal beoordelingen voor de aanbieding
service	string	De servicenaam van het product, zoals 'Virtual Machines'
serviceFamily	string	De servicefamilie van het product, zoals 'Compute'
smallIconUri	string	URI naar het kleine productpictogram
summary	string	Product samenvatting
supportedProducts	string[]	Kaarten naar de lijst met compatibele producten
uniqueProductId	string	Unieke productidentificatie

ProductSummaryListResult

Object

De aangepaste reactie van een lijstbewerking.

Name	Type	Description
nextLink	string	De koppeling naar de volgende pagina met items
value	ProductSummary[]	De items op deze pagina