Product List - List By Subscription
Zobrazí seznam produktů pro předplatné.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Marketplace/products?api-version=2025-05-01GET 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}Parametry identifikátoru URI
| Name | V | Vyžadováno | Typ | Description |
|---|---|---|---|---|
|
subscription
|
path | True |
string (uuid) |
ID cílového předplatného. Hodnota musí být UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Verze rozhraní API, která se má použít pro tuto operaci. |
|
$expand
|
query |
string |
Rozbalí související entity vložené do textu. |
|
|
$filter
|
query |
string |
Filtruje výsledky na základě logické podmínky. Příklad: $filter=productType eq 'VirtualMachine'. Pole, která lze filtrovat podle:
|
|
|
$order
|
query |
string |
Výraz řazení pro výsledky pomocí zápisu OData. Vyhněte se použití orderby, pokud to není nezbytné, protože to může mít vliv na latenci vašeho požadavku. Příklad: $orderby=displayName desc. Toto rozhraní API podporuje řazení pouze podle jednoho pole. Pole, která lze seřadit podle:
|
|
|
$search
|
query |
string |
Volitelné vyhledávání podle zobrazovaného jména, zobrazovaného jména vydavatele nebo klíčových slov. Příklad $search=Microsoft |
|
|
$select
|
query |
string |
Vybere, které vlastnosti se mají zahrnout do výsledků. Příklad: $select=displayName |
|
|
exclude
|
query |
boolean |
Zda vyloučit veřejné nabídky a veřejné plány z odpovědi. Výchozí hodnota je false, což znamená, že do odpovědi jsou zahrnuty veřejné nabídky a veřejné plány. Pokud je nastavená hodnota true, vrátí se jenom soukromé plány. |
|
|
language
|
query |
string |
Jazyk pro vyhledávání, dvoupísmenný kód ISO 639-1, možné hodnoty - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant". Výchozí je "en" |
Odpovědi
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Požadavek byl úspěšný. |
|
| Other Status Codes |
Neočekávaná chybová odpověď |
Zabezpečení
azure_auth
Tok OAuth2 v Azure Active Directory
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
| Name | Description |
|---|---|
| user_impersonation | zosobnění uživatelského účtu |
Příklady
ProductList_ListBySubscription
Ukázkový požadavek
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
Ukázková odpověď
{
"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..."
}Definice
| Name | Description |
|---|---|
| Attribute |
Představuje atribut SKU, který se skládá z klíče a hodnoty. Atributy se mohou u různých služeb lišit. |
|
Discovery |
Podrobnosti o chybě vrácené v DiscoveryErrorPayload |
|
Discovery |
Datová část Error vrácená rozhraními API Marketplace Discovery |
|
Plan |
Další metadata |
|
Plan |
Vrací podmnožinu atributů plánu |
|
Product |
Vrátí podmnožinu atributů produktu |
|
Product |
Vlastní odpověď operace se seznamem. |
Attribute
Představuje atribut SKU, který se skládá z klíče a hodnoty. Atributy se mohou u různých služeb lišit.
| Name | Typ | Description |
|---|---|---|
| key |
string |
Klíč atributu |
| value |
string |
Hodnota atributu |
DiscoveryErrorDetails
Podrobnosti o chybě vrácené v DiscoveryErrorPayload
| Name | Typ | Description |
|---|---|---|
| code |
string |
Kód chyby HTTP |
| message |
string |
Chybová zpráva |
DiscoveryErrorPayload
Datová část Error vrácená rozhraními API Marketplace Discovery
| Name | Typ | Description |
|---|---|---|
| error |
Objekt s podrobnostmi o chybě |
PlanMetadata
Další metadata
| Name | Typ | Description |
|---|---|---|
| altStackReference |
string |
Ukazuje na planId, který obsahuje alternativní odkaz na zásobník |
| generation |
string |
Generování bitové kopie virtuálního počítače (platí pouze pro produkty virtuálních počítačů) |
PlanSummary
Vrací podmnožinu atributů plánu
| Name | Typ | Description |
|---|---|---|
| altArchitectureReference |
string |
Alternativní odkaz na architekturu |
| altStackReference |
string |
Alternativní odkaz na zásobník |
| categoryIds |
string[] |
ID kategorií plánu |
| cspState |
string |
Řídí dostupnost plánu a přístup partnerů v rámci programu Microsoft Cloud Solution Provider (CSP).
|
| description |
string |
Popis plánu / SKU |
| displayName |
string |
Zobrazovaný název plánu / SKU |
| displayRank |
string |
Pořadí, ve kterém je plán zobrazen v tabulce "Plány" |
| hasProtectedArtifacts |
boolean |
Nastavte na true, pokud plán obsahuje artefakty, které mají být skryty pro neověřené uživatele |
| hasRi |
boolean |
Údaj o tom, zda SKU podporuje rezervace |
| isPrivate |
boolean |
Označení, že plán je přístupný pouze omezené cílové skupině |
| metadata |
Rozšířená metadata plánu/SKU. |
|
| planId |
string |
Identifikátor plánu |
| planType |
string |
Určuje primární model nasazení a architekturu hostování pro produkt marketplace. Aktuálně podporované hodnoty jsou:
|
| pricingTypes |
string[] |
Označuje modely fakturace a nákladové struktury, které jsou pro plán k dispozici.
|
| skuId |
string |
ID SKU |
| stackType |
string |
Typ zásobníku: Classic, Gen1, Gen2 |
| summary |
string |
Souhrnný text plánu |
| uniquePlanId |
string |
Jedinečný identifikátor plánu, který má předponu kombinací uniqueProductId a PlanId bez oddělovače mezi nimi |
| vmArchitectureType |
string |
Určuje architekturu a generaci procesoru virtuálního počítače. Platí výhradně pro typy produktů virtuálních počítačů.
|
| vmSecuritytypes |
string[] |
Definuje úroveň zvýšení zabezpečení pro nasazení virtuálních počítačů. Platí výhradně pro typy produktů virtuálních počítačů.
|
ProductSummary
Vrátí podmnožinu atributů produktu
| Name | Typ | Description |
|---|---|---|
| applicableProducts |
string[] |
Kategorie produktů, do kterých nabídka patří |
| attributes |
Sada atributů produktů |
|
| azureBenefit |
string |
Označuje, jestli se nákupy produktů započítávají do výhod závazku využití Azure pro podnikové zákazníky.
|
| badges |
string[] |
Zobrazuje certifikační a kvalifikační odznaky získané produktem pro zviditelnění na trhu.
|
| categoryIds |
string[] |
Pole kategorií produktů |
| cspLegalTermsUri |
string |
Právní podmínky produktu pro poskytovatele kryptografických služeb |
| description |
string |
Text popisu produktu |
| displayName |
string |
Zobrazovaný název produktu |
| hasMarketplaceFootprint |
boolean |
Údaj o tom, zda má produkt zastoupení na trhu |
| hasRiPlans |
boolean |
Údaj o tom, zda má produkt plány s výhradami |
| industryIds |
string[] |
Seznam ID odvětví, do kterého položka patří |
| lastModifiedDateTime |
string |
Poslední datum aktualizace produktu |
| locations |
string[] |
Seznam umístění, která jsou k dispozici na SKU |
| longSummary |
string |
Dlouhý souhrn produktu |
| operatingSystems |
string[] |
Informace o operačním systému pro tento produkt |
| plans |
Úplná sada atributů plánu/SKU |
|
| popularity |
number (double) |
Oblíbenost produktu |
| pricingTypes |
string[] |
Označuje modely fakturace a nákladové struktury, které jsou pro plán k dispozici.
|
| privacyPolicyUri |
string |
Zásady ochrany osobních údajů produktu |
| productFamily |
string |
Produktová řada |
| productId |
string |
Jedinečné ID produktu |
| productSubType |
string |
Podtyp produktu |
| productType |
string |
Určuje primární model nasazení a architekturu hostování pro produkt Marketplace uložený v katalogu Marketplace.
|
| publisherDisplayName |
string |
Zobrazovaný název aplikace Publisher |
| publisherId |
string |
ID vydavatele |
| publisherType |
string |
Identifikuje vztah vydavatele se společností Microsoft pro účely podpory a klasifikace partnerství.
|
| publishingStage |
string |
Označuje stav dostupnosti produktu a úroveň přístupu zákazníka v rámci Azure Marketplace.
|
| ratingAverage |
number (double) |
Průměrné hodnocení nabídky |
| ratingBuckets |
string[] |
Kategorizuje produkty podle prahových hodnot hodnocení zákazníků pro filtrování a objevování na trhu.
|
| ratingCount |
integer (int32) |
Celkový počet hodnocení pro nabídku |
| service |
string |
Název služby produktu, například "Virtuální počítače" |
| serviceFamily |
string |
Skupina služeb produktu, například "Compute" |
| smallIconUri |
string |
Identifikátor URI k ikoně malého produktu |
| summary |
string |
Souhrn produktů |
| supportedProducts |
string[] |
Mapuje se na seznam kompatibilních produktů |
| uniqueProductId |
string |
Jedinečný identifikátor produktu |
ProductSummaryListResult
Vlastní odpověď operace se seznamem.
| Name | Typ | Description |
|---|---|---|
| nextLink |
string |
Odkaz na další stránku položek |
| value |
Položky na této stránce |