Product List - List By Subscription

Tjänst:

Marketplace Catalog

API-version:

2025-05-01

Listar produkter för prenumeration.

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

Med valfria parametrar:

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

Name	I	Obligatorisk	Typ	Description
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.
$expand	query		string	Expanderar relaterade entiteter infogade
$filter	query		string	Filtrerar resultatet baserat på ett booleskt villkor. Exempel: $filter=productType eq 'VirtualMachine'. Fält som kan filtreras efter är: 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	Ordnande uttryck för resultaten med hjälp av OData-notation. Undvik att använda orderby om det inte är nödvändigt eftersom detta kan påverka svarstiden för din begäran. Exempel: $orderby=displayName desc. Det här API:et stöder endast sortering efter ett enda fält. Fält som kan sorteras efter är: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	Du kan också söka efter visningsnamn, utgivarens visningsnamn eller nyckelord. Exempel $search=Microsoft
$select	query		string	Väljer vilka egenskaper som ska ingå i resultatet. Exempel: $select=displayName
excludePublicOffersAndPublicPlans	query		boolean	Om du vill undanta offentliga erbjudanden och offentliga planer från svaret. Standardvärdet är false, vilket innebär att offentliga erbjudanden och offentliga planer ingår i svaret. Om värdet är true returneras endast privata planer.
language	query		string	Språk att söka i, ISO 639-1 tvåbokstavskod, möjliga värden - "en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant". Standard är "en"

Svar

Name	Typ	Description
200 OK	ProductSummaryListResult	Begäran har slutförts.
Other Status Codes	DiscoveryErrorPayload	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

ProductList_ListBySubscription

Exempelbegäran

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
Attribute	Representerar ett SKU-attribut som består av en nyckel och ett värde. Attributen kan skilja sig åt mellan olika tjänster.
DiscoveryErrorDetails	Felinformation som returneras i DiscoveryErrorPayload
DiscoveryErrorPayload	Felnyttolast som returneras av API:er för Marketplace Discovery
PlanMetadata	Ytterligare metadata
PlanSummary	Returnerar en delmängd av Plan-attributen
ProductSummary	Returnerar en delmängd av Product attribut
ProductSummaryListResult	Det anpassade svaret för en liståtgärd.

Attribute

Objekt

Representerar ett SKU-attribut som består av en nyckel och ett värde. Attributen kan skilja sig åt mellan olika tjänster.

Name	Typ	Description
key	string	Attributets nyckel
value	string	Attributets värde

DiscoveryErrorDetails

Objekt

Felinformation som returneras i DiscoveryErrorPayload

Name	Typ	Description
code	string	HTTP-felkoden
message	string	Felmeddelandet

DiscoveryErrorPayload

Objekt

Felnyttolast som returneras av API:er för Marketplace Discovery

Name	Typ	Description
error	DiscoveryErrorDetails	Objektet för felinformation

PlanMetadata

Objekt

Ytterligare metadata

Name	Typ	Description
altStackReference	string	Peka på ett planId som innehåller den alternativa stackreferensen
generation	string	Generering av VM-avbildning (gäller endast för produkter för virtuella datorer)

PlanSummary

Objekt

Returnerar en delmängd av Plan-attributen

Name	Typ	Description
altArchitectureReference	string	Referensen för alternativ arkitektur
altStackReference	string	Alternativ stackreferens
categoryIds	string[]	Planera CategoryIds
cspState	string	Styr planens tillgänglighet och partneråtkomst i Microsoft Cloud Solution Provider-programmet (CSP). OptIn - Gör det möjligt för alla auktoriserade Cloud Solution Provider-partner att sälja och distribuera produkten till kunder OptOut - Utesluten från Molnlösningsleverantör-programmet, endast tillgängligt via direkta kanaler SelectiveOptIn - Endast tillgängligt för utvalda Molnlösningsleverantör-partner för återförsäljning och kunddistribution
description	string	Beskrivning av plan/SKU
displayName	string	Visningsnamn för planen/SKU:n
displayRank	string	Ordningen som planen visas i tabellen "Planer"
hasProtectedArtifacts	boolean	Ställ in på true om planen har artefakter som ska döljas för icke-autentiserade användare
hasRi	boolean	Indikation om SKU:n stöder reservationer
isPrivate	boolean	Indikation på att planen endast är tillgänglig för en begränsad publik
metadata	PlanMetadata	Utökade metadata för plan/SKU.
planId	string	Identifierare för plan
planType	string	Anger den primära distributionsmodellen och värdarkitekturen för Marketplace-produkten. För närvarande stöds värden: None - Ospecificerad produkttyp, används vanligtvis för produkter utan en definierad distributionsmodell DevService - Utvecklingsfokuserade tjänster och verktyg för arbetsflöden för att skapa programvara ManagedApplication - Azure-hanterade program som distribuerar och hanterar resurser i kundprenumerationer VirtualMachine - Förkonfigurerade avbildningar av virtuella datorer som kan distribueras till Azures beräkningsinfrastruktur AzureApplication - Inbyggda Azure-program som utnyttjar plattformstjänster och API:er Container - Containerbaserade program som distribueras via Azure Container Instances eller liknande tjänster SaaS - Software as a Service-lösningar som drivs och hanteras av utgivaren SolutionTemplate - Azure Resource Manager-mallar som etablerar flera Azure-resurser IotEdgeModules - Moduler som är utformade för distribution till Azure IoT Edge körningsmiljöer ManagedServices - Fullt hanterade tjänster där utgivaren hanterar infrastruktur och drift ContainerApps - Program som skapats för Azure Container Apps serverlös containerplattform VisualStudioExtension - Tillägg som integreras med Visual Studio IDE-funktioner DynamicsOps - Microsoft Dynamics 365 Finance and Operations-program och tillägg DynamicsCE - Microsoft Dynamics 365 Customer Engagement-program och anpassningar DynamicsBC - Microsoft Dynamics 365 Business Central-program och tillägg PowerBI - Microsoft Power BI-rapporter, instrumentpaneler och komponenter för datavisualisering ConsultingServices - Professionella tjänsteerbjudanden, inklusive implementerings- och rådgivningstjänster CosellOnly - Produkter som endast är tillgängliga via Microsofts partnerprogram för säljförsäljning CoreVirtualMachine - Grundläggande erbjudanden för virtuella datorer med grundläggande Azure-beräkningsfunktioner PowerBIVisuals - Anpassade visualiseringar för Microsoft Power BI-rapporteringsplattformen Office365 - Microsoft 365- och Office 365-program, tillägg och integrationer AADApps - Azure Active Directory-integrerade program som stöder organisationsidentitet AzureServices - Inbyggda Azure-plattformstjänster och resursproviders AppService - Webbprogram som finns på Azure App Service-plattformen LogAnalytics - Azure Monitor Log Analytics-lösningar och konfigurationer av arbetsytor MicrosoftProduct - Förstapartsprodukter från Microsoft som är tillgängliga via Marketplace-kanaler
pricingTypes	string[]	Anger de faktureringsmodeller och kostnadsstrukturer som är tillgängliga för planen. Free - Ingen avgift för plananvändning, vanligtvis för community-utgåvor eller grundläggande tjänstnivåer FreeTrial - Tidsbegränsad period med kostnadsfri åtkomst innan du övergår till en betald faktureringsmodell Byol - Bring Your Own License-modell där kunderna tillhandahåller befintliga programvarulicenser Payg - Betala per användning: förbrukningsbaserad fakturering beräknad på faktisk resursanvändning Ri - Fakturering av reserverade instanser med förskottsåtagande för rabatterade långsiktiga priser
skuId	string	SKU-ID:t
stackType	string	Stacktyp: Klassisk, Gen1, Gen2
summary	string	Sammanfattningstexten för planen
uniquePlanId	string	Unik planidentifierare som föregås av en kombination av uniqueProductId och PlanId utan någon avgränsare däremellan
vmArchitectureType	string	Anger processorarkitekturen och genereringen för den virtuella datorn. Gäller endast för produkttyper för virtuella datorer. X64Gen1 - x64-processorarkitektur med inbyggd programvara för virtuella datorer i generation 1 och BIOS-stöd X64Gen2 - x64-processorarkitektur med inbyggd programvara för virtuella datorer i generation 2 och UEFI-stöd Arm64 - ARM 64-bitars processorarkitektur optimerad för energieffektivitet och molnbaserade arbetsbelastningar
vmSecuritytypes	string[]	Definierar säkerhetsförbättringsnivån för distributioner av virtuella datorer. Gäller endast för produkttyper för virtuella datorer. None - Standardsäkerhet för virtuella maskiner utan ytterligare skyddsfunktioner Trusted - Betrodd startsäkerhet med säker start och virtuella funktioner för Trusted Platform Module Confidential - Konfidentiell databehandling med minneskryptering och attestering för känsliga arbetsbelastningar

ProductSummary

Objekt

Returnerar en delmängd av Product attribut

Name	Typ	Description
applicableProducts	string[]	Produktkategorier som erbjudandet tillhör
attributes	Attribute[]	Uppsättning av produktattribut
azureBenefit	string	Anger om produktköp räknas mot fördelarna med Azure-förbrukningsåtagande för företagskunder. Eligible - Produktkostnader gäller för beräkning av Azure-förbrukningsåtagande, förmånsberäkningar och krediter NotEligible - Produktkostnader kvalificerar sig inte för förmånsprogram för Azure-förbrukningsåtagande
badges	string[]	Visar certifierings- och kvalificeringsmärken som tjänats in av produkten för synlighet på Marketplace. PreferredSolution - Microsoft-godkänd lösning som uppfyller specifika kvalitets- och partnerskapskriterier PowerBICertified - Certifierad kompatibilitet och integration med Microsoft Power BI-plattformen AdditionalPurchaseRequirement - Produkten kräver ytterligare köp eller prenumerationer för full funktionalitet
categoryIds	string[]	Utbud av produktkategorier
cspLegalTermsUri	string	De juridiska villkoren för produkten för CSP
description	string	Texten i produktbeskrivningen
displayName	string	Namn på produktens display
hasMarketplaceFootprint	boolean	Indikation om produkten har en representation på marknaden
hasRiPlans	boolean	Uppgift om huruvida produkten har planer med reservationer
industryIds	string[]	Lista över bransch-ID:n som objektet tillhör
lastModifiedDateTime	string	Senaste uppdateringsdatum för produkten
locations	string[]	Lista över platser som är tillgängliga på SKU:erna
longSummary	string	Lång sammanfattning av produkten
operatingSystems	string[]	Information om operativsystemet för den här produkten
plans	PlanSummary[]	Fullständig uppsättning plan-/SKU-attribut
popularity	number (double)	Produktens popularitet
pricingTypes	string[]	Anger de faktureringsmodeller och kostnadsstrukturer som är tillgängliga för planen. Free - Ingen avgift för plananvändning, vanligtvis för community-utgåvor eller grundläggande tjänstnivåer FreeTrial - Tidsbegränsad period med kostnadsfri åtkomst innan du övergår till en betald faktureringsmodell Byol - Bring Your Own License-modell där kunderna tillhandahåller befintliga programvarulicenser Payg - Betala per användning: förbrukningsbaserad fakturering beräknad på faktisk resursanvändning Ri - Fakturering av reserverade instanser med förskottsåtagande för rabatterade långsiktiga priser
privacyPolicyUri	string	Sekretesspolicyn för produkten
productFamily	string	Produktfamilj
productId	string	Produktens unika id
productSubType	string	Typ av produkt
productType	string	Anger den primära distributionsmodellen och värdarkitekturen för Marketplace-produkten som lagras i Marketplace-katalogen. None - Ospecificerad produkttyp, används vanligtvis för produkter utan en definierad distributionsmodell ManagedApplication - Azure-hanterade program som distribuerar och hanterar resurser i kundprenumerationer VirtualMachine - Förkonfigurerade avbildningar av virtuella datorer som kan distribueras till Azures beräkningsinfrastruktur AzureApplication - Inbyggda Azure-program som utnyttjar plattformstjänster och API:er Container - Containerbaserade program som distribueras via Azure Container Instances eller liknande tjänster SaaS - Software as a Service-lösningar som drivs och hanteras av utgivaren SolutionTemplate - Azure Resource Manager-mallar som etablerar flera Azure-resurser IotEdgeModules - Moduler som är utformade för distribution till Azure IoT Edge körningsmiljöer ManagedServices - Fullt hanterade tjänster där utgivaren hanterar infrastruktur och drift ContainerApps - Program som skapats för Azure Container Apps serverlös containerplattform DynamicsOps - Microsoft Dynamics 365 Finance and Operations-program och tillägg DynamicsCE - Microsoft Dynamics 365 Customer Engagement-program och anpassningar DynamicsBC - Microsoft Dynamics 365 Business Central-program och tillägg PowerBI - Microsoft Power BI-rapporter, instrumentpaneler och komponenter för datavisualisering ConsultingServices - Professionella tjänsteerbjudanden, inklusive implementerings- och rådgivningstjänster CosellOnly - Produkter som endast är tillgängliga via Microsofts partnerprogram för säljförsäljning CoreVirtualMachine - Grundläggande erbjudanden för virtuella datorer med grundläggande Azure-beräkningsfunktioner PowerBIVisuals - Anpassade visualiseringar för Microsoft Power BI-rapporteringsplattformen Office365 - Microsoft 365- och Office 365-program, tillägg och integrationer AADApps - Azure Active Directory-integrerade program som stöder organisationsidentitet AzureServices - Inbyggda Azure-plattformstjänster och resursproviders AppService - Webbprogram som finns på Azure App Service-plattformen LogAnalytics - Azure Monitor Log Analytics-lösningar och konfigurationer av arbetsytor MicrosoftProduct - Förstapartsprodukter från Microsoft som är tillgängliga via Marketplace-kanaler
publisherDisplayName	string	Utgivarens visningsnamn
publisherId	string	Utgivarens id
publisherType	string	Identifierar utgivarens relation till Microsoft för klassificering av support och partnerskap. Microsoft - Förstapartsprodukt från Microsoft med direkt support och utveckling från Microsoft ThirdParty - Oberoende programvaruleverantörsprodukt med support och underhåll som tillhandahålls av utgivaren
publishingStage	string	Anger produktens tillgänglighetsstatus och kundåtkomstnivå i Azure Marketplace. Preview - Begränsad tillgänglighet för utvalda kunder för testning och utvärdering av tidig åtkomst Public - Allmän tillgänglighet för alla Azure Marketplace-kunder för produktionsdistribution
ratingAverage	number (double)	Genomsnittligt betyg för erbjudandet
ratingBuckets	string[]	Kategoriserar produkter efter tröskelvärden för kundbetyg för filtrering och upptäckt på marknadsplatsen. AboveOne - Produkter med kundbetyg som överstiger 1.0 stjärnor baserat på recensioner på marknadsplatsen AboveTwo - Produkter med kundbetyg som överstiger 2.0 stjärnor baserat på recensioner på marknadsplatsen AboveThree - Produkter med kundbetyg som överstiger 3.0 stjärnor baserat på recensioner på marknadsplatsen AboveFour - Produkter med kundbetyg som överstiger 4.0 stjärnor baserat på recensioner på marknadsplatsen
ratingCount	integer (int32)	Totalt antal omdömen för erbjudandet
service	string	Tjänstnamnet på produkten, till exempel "Virtual Machines"
serviceFamily	string	Produktens tjänstfamilj, till exempel "Compute"
smallIconUri	string	URI till den lilla produktikonen
summary	string	Sammanfattning av produkten
supportedProducts	string[]	Mappar till listan över kompatibla produkter
uniqueProductId	string	Unik produktidentifierare

ProductSummaryListResult

Objekt

Det anpassade svaret för en liståtgärd.

Name	Typ	Description
nextLink	string	Länken till nästa sida med objekt
value	ProductSummary[]	Objekten på den här sidan