List Skus - List Skus

Dienst:

Marketplace Catalog

API-Version:

2025-05-01

Ruft eine Liste der SKUs ab, die im Marketplace-Katalog verfügbar sind.

GET https://catalogapi.azure.com/skus?api-version=2025-05-01&service={service}&serviceFamily={serviceFamily}

Mit optionalen Parametern:

GET https://catalogapi.azure.com/skus?api-version=2025-05-01&service={service}&serviceFamily={serviceFamily}&language={language}&locations={locations}&market={market}&$select={$select}&$filter={$filter}&$orderBy={$orderBy}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string minLength: 1	Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.
service	query	True	string	Der Dienstname des Produkts, z. B. "Virtuelle Maschinen"
serviceFamily	query	True	string	Die Servicefamilie des Produkts, z. B. "Compute"
$filter	query		string	Filtert die Ergebnisse basierend auf einer booleschen Bedingung. Beispiel: $filter=productType eq 'VirtualMachine'. Beachten Sie, dass nicht alle Felder das Filtern unterstützen
$orderBy	query		string	Sortierausdruck für die Ergebnisse unter Verwendung der OData-Notation. Vermeiden Sie die Verwendung von orderby, es sei denn, dies ist unbedingt erforderlich, da dies die Latenz Ihrer Anfrage beeinträchtigen kann. Beispiel: $orderby=productDisplayName desc. Diese API unterstützt nur die Sortierung nach einem einzelnen Feld. Beachten Sie, dass derzeit nicht alle Felder orderBy unterstützen
$select	query		string	Wählt aus, welche Eigenschaften in die Ergebnisse einbezogen werden sollen. Beispiel: $select=Anzeigename
language	query		string	Zu suchende Sprache, ISO 639-1 zweistelliger Code, mögliche Werte - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,zh-hans,zh-hant'. Der Standardwert ist "en"
locations	query		string[]	Rückgabeskus an ausgewähltem Standort verfügbar. Weitere Informationen zu Azure-Rechenzentrumsregionen finden Sie unter: https://azure.microsoft.com/regions/
market	query		string	Marktwert. Die Antwort enthält nur SKUs, die auf dem angegebenen Markt verkauft werden können. Basierend auf dem ISO-3166-Format. Mögliche Werte finden Sie unter https://docs.microsoft.com/en-us/azure/marketplace/marketplace-geo-availability-currencies. Beispiel: "US"

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
X-API-Key	True	string	Verwenden Sie den vom Marketplace-Katalogteam bereitgestellten Schlüssel als Parameter, der in der Kopfzeile angegeben wird. Details zum Erhalt des Schlüssels finden Sie unter https://aka.ms/DiscoveryAPI/keys

Antworten

Name	Typ	Beschreibung
200 OK	DiscoveryApiPagedSkusResult	Die Anforderung war erfolgreich.
Other Status Codes	DiscoveryErrorPayload	Unerwartete Fehlerantwort.

Sicherheit

X-API-Key

Verwenden Sie den vom Marketplace-Katalogteam bereitgestellten Schlüssel als Parameter, der in der Kopfzeile angegeben wird. Details zum Erhalt des Schlüssels finden Sie unter https://aka.ms/DiscoveryAPI/keys

Typ: apiKey
In: header

Beispiele

Lists publically available skus in the marketplace.

Beispielanforderung

HTTP

GET https://catalogapi.azure.com/skus?api-version=2025-05-01&service=Virtual Machines&serviceFamily=Compute&language=en&locations=eastus2,westus2&$filter=productType eq 'VirtualMachine'

Beispiel für eine Antwort

Statuscode:

200

{
  "value": [
    {
      "productId": "canonical-0001-ubuntu-server-22-04-lts",
      "productDisplayName": "Ubuntu Server 22.04 LTS",
      "productDescription": "Ubuntu Server 22.04 LTS (Jammy Jellyfish) virtual machine images with regular security updates and patches. Optimized for cloud-native applications and enterprise workloads.",
      "serviceFamily": "Compute",
      "service": "Virtual Machines",
      "publisherId": "Canonical",
      "publisherType": "ThirdParty",
      "productType": "VirtualMachine",
      "productSubType": "LinuxServer",
      "productAttributes": [
        {
          "key": "osType",
          "value": "Linux"
        },
        {
          "key": "osDistro",
          "value": "Ubuntu"
        },
        {
          "key": "osVersion",
          "value": "22.04-LTS"
        }
      ],
      "summary": "High-performance Ubuntu 22.04 LTS server optimized for cloud workloads",
      "cspState": "OptIn",
      "hasRi": true,
      "skuName": "Standard_D8s_v5",
      "skuId": "d8sv5-ubuntu2204",
      "skuType": "OnDemand",
      "language": "en",
      "skuDescription": "General purpose compute optimized virtual machine with 8 vCPUs and 32 GiB memory. Supports Premium SSD disks and accelerated networking.",
      "skuTitle": "D8s v5 Ubuntu 22.04 LTS",
      "lastModifiedDateTime": "2025-05-01T10:00:00.0000000Z",
      "location": "US East 2",
      "armRegionName": "eastus2",
      "cloud": "Global",
      "locationType": "Region",
      "region": "US East 2",
      "skuGroupId": "Dsv5-series",
      "zone": "1,2,3",
      "feature": "Spot",
      "serviceType": "ComputeOptimized",
      "skuAttributes": [
        {
          "key": "architecture",
          "value": "x86_64"
        },
        {
          "key": "generation",
          "value": "v5"
        },
        {
          "key": "hyperVGeneration",
          "value": "V2"
        },
        {
          "key": "maxDataDiskCount",
          "value": "8"
        },
        {
          "key": "maxNetworkInterfaces",
          "value": "4"
        },
        {
          "key": "acceleratedNetworking",
          "value": "true"
        }
      ],
      "skuProperties": {
        "category": "General purpose",
        "dataDiskType": "Premium_SSD",
        "diskType": "Premium_SSD",
        "numberOfCores": "8",
        "ram": "32",
        "vCpu": "8",
        "armSkuName": "Standard_D8s_v5",
        "accessTier": "Standard"
      },
      "offeringProperties": [
        {
          "productCode": "CANONICAL-UBUNTU-22-04-LTS",
          "termId": "payg",
          "meterType": "Compute",
          "billingMeterId": "d8sv5-ubuntu-consumption",
          "offeringId": "d8sv5-ubuntu2204-offering",
          "type": "Consumption"
        }
      ]
    },
    {
      "productId": "microsoft-0001-windows-server-2022",
      "productDisplayName": "Windows Server 2022 Datacenter",
      "productDescription": "Windows Server 2022 Datacenter edition enables hybrid capabilities with Azure and comes with advanced multi-layer security. Ideal for highly virtualized enterprise workloads.",
      "serviceFamily": "Compute",
      "service": "Virtual Machines",
      "publisherId": "Microsoft",
      "publisherType": "Microsoft",
      "productType": "VirtualMachine",
      "productSubType": "WindowsServer",
      "productAttributes": [
        {
          "key": "osType",
          "value": "Windows"
        },
        {
          "key": "osVersion",
          "value": "2022-Datacenter"
        },
        {
          "key": "windowsEdition",
          "value": "Datacenter"
        }
      ],
      "summary": "Enterprise-grade Windows Server 2022 Datacenter optimized for memory-intensive workloads",
      "cspState": "OptIn",
      "hasRi": true,
      "skuName": "Standard_E16s_v5",
      "skuId": "e16sv5-win2022",
      "skuType": "OnDemand",
      "language": "en",
      "skuDescription": "Memory optimized virtual machine with 16 vCPUs and 128 GiB memory. Features Premium SSD support, accelerated networking, and enhanced security.",
      "skuTitle": "E16s v5 Windows Server 2022",
      "lastModifiedDateTime": "2025-05-01T10:00:00.0000000Z",
      "location": "US East 2",
      "armRegionName": "eastus2",
      "cloud": "Global",
      "locationType": "Region",
      "region": "US East 2",
      "skuGroupId": "Esv5-series",
      "zone": "1,2,3",
      "feature": "Spot",
      "serviceType": "MemoryOptimized",
      "skuAttributes": [
        {
          "key": "architecture",
          "value": "x86_64"
        },
        {
          "key": "generation",
          "value": "v5"
        },
        {
          "key": "hyperVGeneration",
          "value": "V2"
        },
        {
          "key": "maxDataDiskCount",
          "value": "32"
        },
        {
          "key": "maxNetworkInterfaces",
          "value": "8"
        },
        {
          "key": "acceleratedNetworking",
          "value": "true"
        },
        {
          "key": "securityType",
          "value": "TrustedLaunch"
        }
      ],
      "skuProperties": {
        "category": "Memory optimized",
        "dataDiskType": "Premium_SSD",
        "diskType": "Premium_SSD",
        "numberOfCores": "16",
        "ram": "128",
        "vCpu": "16",
        "armSkuName": "Standard_E16s_v5",
        "accessTier": "Standard"
      },
      "offeringProperties": [
        {
          "productCode": "MS-WIN-SERVER-2022-DC",
          "termId": "payg",
          "meterType": "Compute",
          "billingMeterId": "e16sv5-win2022-consumption",
          "offeringId": "e16sv5-win2022-offering",
          "type": "Consumption"
        }
      ]
    }
  ],
  "nextLink": "https://catalogapi.azure.com/skus?serviceFamily=Compute&service=Virtual%20Machines&language=en&api-version=2025-05-01&locations=eastus2,westus2&$filter=productType%20eq%20%27VirtualMachine%27&$skiptoken=W3s..."
}

Definitionen

Name	Beschreibung
Attribute	Stellt ein SKU-Attribut dar, das aus einem Schlüssel und einem Wert besteht. Die Attribute können sich je nach Dienst unterscheiden
DiscoveryApiPagedSkusResult	Ausgelagertes skuSummary-Antwortergebnis von der Ermittlungs-API
DiscoveryErrorDetails	Fehlerdetails, die in DiscoveryErrorPayload zurückgegeben werden
DiscoveryErrorPayload	Fehlernutzlast, die von Marketplace Discovery-APIs zurückgegeben wird
OfferingProperties	SKU Preis bezogene Eigenschaften
SkuProperties	Eigenschaften des SKU-Objekts
SkuSummary	Zusammenfassende Beschreibung der SKU

Attribute

Objekt

Stellt ein SKU-Attribut dar, das aus einem Schlüssel und einem Wert besteht. Die Attribute können sich je nach Dienst unterscheiden

Name	Typ	Beschreibung
key	string	Der Attributschlüssel
value	string	Der Attributwert

DiscoveryApiPagedSkusResult

Objekt

Ausgelagertes skuSummary-Antwortergebnis von der Ermittlungs-API

Name	Typ	Beschreibung
nextLink	string	Link zur nächsten Ergebnisseite, falls verfügbar
value	SkuSummary[]	Liste der Elemente auf der aktuellen Seite

DiscoveryErrorDetails

Objekt

Fehlerdetails, die in DiscoveryErrorPayload zurückgegeben werden

Name	Typ	Beschreibung
code	string	Der HTTP-Fehlercode
message	string	Die Fehlermeldung

DiscoveryErrorPayload

Objekt

Fehlernutzlast, die von Marketplace Discovery-APIs zurückgegeben wird

Name	Typ	Beschreibung
error	DiscoveryErrorDetails	Das Fehlerdetails-Objekt

OfferingProperties

Objekt

SKU Preis bezogene Eigenschaften

Name	Typ	Beschreibung
billingMeterId	string	Die ID der Abrechnungsverbrauchseinheit
meterType	string	Der Zählertyp
offeringId	string	Die Angebots-ID
productCode	string	Der Produktcode (UPN)
termId	string	Der Begriff id
type	string	Anspruch, Verbrauch oder Reservierung

SkuProperties

Objekt

Eigenschaften des SKU-Objekts

Name	Typ	Beschreibung
accessTier	string	Die Zugriffsebene, z. B. "Standard"
armSkuName	string	Der Name der ARM-SKU
category	string	Die SKU-Kategorie
dataDiskType	string	Der Typ des Datenträgers, z. B. "Ssd"
diskType	string	Der Festplattentyp, z. B. "Ssd"
numberOfCores	string	Die Anzahl der Kerne
ram	string	Der Arbeitsspeicher
vCpu	string	Die Anzahl der virtuellen CPUs

SkuSummary

Objekt

Zusammenfassende Beschreibung der SKU

Name	Typ	Beschreibung
armRegionName	string	Der Name der Armregion
cloud	string	Die Cloud, z. B. "Global"
cspState	string	Steuert die Verfügbarkeit von Plänen und den Partnerzugriff innerhalb des Microsoft Cloud Solution Provider (CSP)-Programms. OptIn - Ermöglicht allen autorisierten Cloud Solution Provider-Partnern, das Produkt an Kunden weiterzuverkaufen und bereitzustellen OptOut - Vom Cloud Solution Provider-Programm ausgeschlossen, das nur über direkte Kanäle verfügbar ist SelectiveOptIn - Exklusiv für vom Herausgeber ausgewählte Cloud Solution Provider-Partner verfügbar
feature	string	Das Feature
hasRi	boolean	Angabe, ob die SKU Reservierungen unterstützt
language	string	Language
lastModifiedDateTime	string	Datum der letzten Aktualisierung der SKU
location	string	Standort (Region)
locationType	string	Der Standorttyp, z. B. "Region"
offeringProperties	OfferingProperties[]	SKU Preis bezogene Eigenschaften
productAttributes	Attribute[]	Die Produktattribute
productDescription	string	Der Text der Produktbeschreibung
productDisplayName	string	Anzeigename des Produkts
productId	string	Die eindeutige ID des Produkts
productSubType	string	Gibt den Produktuntergruppentyp an, z. B.: "Azure"
productType	string	Gibt das primäre Bereitstellungsmodell und die Hostingarchitektur für das Marketplace-Produkt an. Derzeit unterstützte Werte sind: None - Nicht spezifizierter Produkttyp, der in der Regel für Produkte ohne definiertes Bereitstellungsmodell verwendet wird DevService - Entwicklungsorientierte Dienstleistungen und Tools für Software-Creation-Workflows ManagedApplication - Verwaltete Azure-Anwendungen, die Ressourcen in Kundenabonnements bereitstellen und verwalten VirtualMachine - Vorkonfigurierte VM-Images, die in der Azure-Computing-Infrastruktur bereitgestellt werden können AzureApplication - Native Azure-Anwendungen, die Plattformdienste und APIs nutzen Container - Containerisierte Anwendungen, die über Azure Container Instances oder ähnliche Dienste bereitgestellt werden SaaS - Software-as-a-Service-Lösungen, die vom Herausgeber gehostet und verwaltet werden SolutionTemplate - Azure Resource Manager-Vorlagen, die mehrere Azure-Ressourcen bereitstellen IotEdgeModules - Module, die für die Bereitstellung in Azure IoT Edge-Laufzeitumgebungen entwickelt wurden ManagedServices - Vollständig verwaltete Services, bei denen der Herausgeber die Infrastruktur und den Betrieb übernimmt ContainerApps - Anwendungen, die für die serverlose Containerplattform Azure Container Apps erstellt wurden VisualStudioExtension - Erweiterungen, die in die Visual Studio-IDE-Funktionalität integriert werden können DynamicsOps - Microsoft Dynamics 365 Finance and Operations-Anwendungen und -Erweiterungen DynamicsCE - Microsoft Dynamics 365 Customer Engagement-Anwendungen und -Anpassungen DynamicsBC - Microsoft Dynamics 365 Business Central-Anwendungen und -Add-ons PowerBI - Microsoft Power BI-Berichte, Dashboards und Datenvisualisierungskomponenten ConsultingServices - Professionelle Dienstleistungen, einschließlich Implementierungs- und Beratungsdienste CosellOnly - Produkte, die exklusiv über Microsoft-Co-Selling-Partnerprogramme erhältlich sind CoreVirtualMachine - Kernangebote für virtuelle Computer mit grundlegenden Azure-Computefunktionen PowerBIVisuals - Benutzerdefinierte Visualisierungen für die Microsoft Power BI-Berichtsplattform Office365 - Microsoft 365- und Office 365-Anwendungen, Add-Ins und Integrationen AADApps - Integrierte Azure Active Directory-Anwendungen, die die Organisationsidentität unterstützen AzureServices - Native Azure-Plattformdienste und Ressourcenanbieter AppService - Webanwendungen, die auf der Azure App Service-Plattform gehostet werden LogAnalytics - Azure Monitor Log Analytics-Lösungen und Arbeitsbereichskonfigurationen MicrosoftProduct - Microsoft-Produkte von Erstanbietern, die über Marketplace-Kanäle verfügbar sind
publisherId	string	Herausgeber-ID
publisherType	string	Gibt die Herausgeberbeziehung zu Microsoft für die Support- und Partnerschaftsklassifizierung an. Microsoft - Microsoft-First-Party-Produkt mit direktem Microsoft-Support und -Entwicklung ThirdParty - Unabhängiges Softwareprodukt mit Support und Wartung durch den Publisher
region	string	Die Region
service	string	Der Dienstname des Produkts, z. B. "Virtuelle Maschinen"
serviceFamily	string	Die Servicefamilie des Produkts, z. B. "Compute"
serviceType	string	Der Diensttyp
skuAttributes	Attribute[]	Die SKU-Attribute
skuDescription	string	Beschreibung lokalisiert
skuGroupId	string	Die SKU-Gruppen-ID
skuId	string	SKU-ID
skuName	string	SKU-Name
skuProperties	SkuProperties	Die SKU-Eigenschaften
skuTitle	string	SKU-Titel lokalisiert
skuType	string	SKU-Typ
summary	string	Produktübersicht
zone	string	Die Zone, z. B. "Zone 1"