Product List - List By Subscription

Hizmet:

Marketplace Catalog

API Sürümü:

2025-05-01

Abonelik için ürünleri listeler.

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

İsteğe bağlı parametrelerle:

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.
$expand	query		string	İlişkili varlıkları satır içi olarak genişletir
$filter	query		string	Boole koşuluna göre sonuçları filtreler. Örnek: $filter=productType eq 'VirtualMachine'. Filtrelenebilecek alanlar şunlardı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	OData gösterimini kullanarak sonuçlar için sıralama ifadesi. İsteğinizin gecikmesini etkileyebileceğinden, gerekli olmadıkça orderby'yi kullanmaktan kaçının. Örnek: $orderby=displayName desc. Bu API yalnızca tek bir alana göre sıralamayı destekler. Sıralanabilecek alanlar şunlardır: lastModifiedDateTime uniqueProductId productType displayName publisherId'
$search	query		string	İsteğe bağlı olarak görünen ad, yayıncı görünen adı veya anahtar sözcüklere göre arama. Örnek $search=Microsoft
$select	query		string	Sonuçlara hangi özelliklerin dahil edileceğini seçer. Örnek: $select=displayName
excludePublicOffersAndPublicPlans	query		boolean	Halka açık tekliflerin ve halka açık planların yanıtın dışında tutulup tutulmayacağı. Varsayılan değer yanlıştır, yani halka açık teklifler ve halka açık planlar yanıta dahil edilir. true olarak ayarlanırsa yalnızca özel planlar döndürülür.
language	query		string	Aranacak dil, ISO 639-1 iki harfli kod, olası değerler - 'en,cs,de,es,fr,hu,it,ja,ko,nl,pl,pt-br,pt-pt,ru,sv,tr,id,zh-hans,zh-hant'. Varsayılan "en" dir

Yanıtlar

Name	Tür	Description
200 OK	ProductSummaryListResult	İstek başarılı oldu.
Other Status Codes	DiscoveryErrorPayload	Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Akışı.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

ProductList_ListBySubscription

Örnek isteği

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

Örnek yanıt

Durum kodu:

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

Tanımlar

Name	Description
Attribute	Bir anahtar ve değerden oluşan bir SKU özniteliğini temsil eder. Öznitelikler çeşitli hizmetler arasında farklılık gösterebilir.
DiscoveryErrorDetails	DiscoveryErrorPayload'da döndürülen hata ayrıntıları
DiscoveryErrorPayload	Market Discovery API'leri tarafından döndürülen hata yükü
PlanMetadata	Ek meta veriler
PlanSummary	Plan özniteliklerinin bir alt kümesini döndürür
ProductSummary	Ürün özniteliklerinin bir alt kümesini döndürür
ProductSummaryListResult	Liste işleminin özel yanıtı.

Attribute

Nesne

Bir anahtar ve değerden oluşan bir SKU özniteliğini temsil eder. Öznitelikler çeşitli hizmetler arasında farklılık gösterebilir.

Name	Tür	Description
key	string	Öznitelik anahtarı
value	string	Öznitelik değeri

DiscoveryErrorDetails

Nesne

DiscoveryErrorPayload'da döndürülen hata ayrıntıları

Name	Tür	Description
code	string	HTTP hata kodu
message	string	Hata iletisi

DiscoveryErrorPayload

Nesne

Market Discovery API'leri tarafından döndürülen hata yükü

Name	Tür	Description
error	DiscoveryErrorDetails	Hata ayrıntıları nesnesi

PlanMetadata

Nesne

Ek meta veriler

Name	Tür	Description
altStackReference	string	Alternatif yığın başvurusunu tutan bir planId'ye işaret etme
generation	string	VM görüntüsü oluşturma (yalnızca Sanal Makine ürünleri için geçerlidir)

PlanSummary

Nesne

Plan özniteliklerinin bir alt kümesini döndürür

Name	Tür	Description
altArchitectureReference	string	Alternatif mimari başvurusu
altStackReference	string	Alternatif yığın başvurusu
categoryIds	string[]	Plan CategoryIds
cspState	string	Microsoft Bulut Çözümü Sağlayıcısı (CSP) programı içinde plan kullanılabilirliğini ve iş ortağı erişimini denetler. OptIn - Tüm yetkili Bulut Çözümü Sağlayıcısı iş ortaklarının ürünü müşterilere yeniden satmasına ve dağıtmasına olanak tanır OptOut - Bulut Çözümü Sağlayıcı programından hariç tutulmuştur, yalnızca doğrudan kanallar aracılığıyla kullanılabilir SelectiveOptIn - Yeniden satış ve müşteri dağıtımı için yalnızca belirli Bulut Çözümü Sağlayıcısı iş ortakları tarafından kullanılabilir
description	string	Plan / sku açıklaması
displayName	string	Planın / sku'nun görünen adı
displayRank	string	Planın 'Planlar' tablosunda görüntülenme sırası
hasProtectedArtifacts	boolean	Planın kimliği doğrulanmamış kullanıcılar için gizlenecek yapıtları varsa true olarak ayarlayın
hasRi	boolean	SKU'nun rezervasyonları destekleyip desteklemediğini gösterme
isPrivate	boolean	Planın yalnızca kısıtlı kitle tarafından erişilebilir olduğuna dair gösterge
metadata	PlanMetadata	Genişletilmiş plan/SKU meta verileri.
planId	string	Plan tanımlayıcısı
planType	string	Market ürünü için birincil dağıtım modelini ve barındırma mimarisini belirtir. Şu anda desteklenen değerler şunlardır: None - Belirtilmemiş ürün türü, genellikle tanımlanmış bir dağıtım modeli olmayan ürünler için kullanılır DevService - Yazılım oluşturma iş akışları için geliştirme odaklı hizmetler ve araçlar ManagedApplication - Müşteri aboneliklerindeki kaynakları dağıtan ve yöneten Azure Yönetilen Uygulamaları VirtualMachine - Azure işlem altyapısına dağıtılabilen önceden yapılandırılmış sanal makine görüntüleri AzureApplication - Platform hizmetlerinden ve API'lerden yararlanan yerel Azure uygulamaları Container - Azure Container Instances veya benzer hizmetler aracılığıyla dağıtılan kapsayıcılı uygulamalar SaaS - Yayıncı tarafından barındırılan ve yönetilen Hizmet Olarak Yazılım çözümleri SolutionTemplate - Birden çok Azure kaynağı sağlayan Azure Resource Manager şablonları IotEdgeModules - Azure IoT Edge çalışma zamanı ortamlarına dağıtım için tasarlanmış modüller ManagedServices - Yayıncının altyapı ve operasyonları yönettiği tam olarak yönetilen hizmetler ContainerApps - Azure Container Apps sunucusuz kapsayıcı platformu için oluşturulmuş uygulamalar VisualStudioExtension - Visual Studio IDE işlevselliğiyle tümleşen uzantılar DynamicsOps - Microsoft Dynamics 365 Finance and Operations uygulamaları ve uzantıları DynamicsCE - Microsoft Dynamics 365 Customer Engagement uygulamaları ve özelleştirmeleri DynamicsBC - Microsoft Dynamics 365 Business Central uygulamaları ve eklentileri PowerBI - Microsoft Power BI raporları, panoları ve veri görselleştirme bileşenleri ConsultingServices - Uygulama ve danışmanlık hizmetleri de dahil olmak üzere profesyonel hizmet teklifleri CosellOnly - Yalnızca Microsoft ortak satış iş ortağı programları aracılığıyla kullanılabilen ürünler CoreVirtualMachine - Temel Azure işlem özelliklerine sahip temel sanal makine teklifleri PowerBIVisuals - Microsoft Power BI raporlama platformu için özel görselleştirmeler Office365 - Microsoft 365 ve Office 365 uygulamaları, eklentileri ve tümleştirmeleri AADApps - Kurumsal kimliği destekleyen Azure Active Directory tümleşik uygulamaları AzureServices - Yerel Azure platform hizmetleri ve kaynak sağlayıcıları AppService - Azure App Service platformunda barındırılan web uygulamaları LogAnalytics - Azure İzleyici Log Analytics çözümleri ve çalışma alanı yapılandırmaları MicrosoftProduct - Market kanalları aracılığıyla sunulan birinci taraf Microsoft ürünleri
pricingTypes	string[]	Plan için kullanılabilen faturalama modellerini ve maliyet yapılarını gösterir. Free - Genellikle topluluk sürümleri veya temel hizmet katmanları için plan kullanımı için ücret alınmaz FreeTrial - Ücretli faturalandırma modeline geçmeden önce zaman sınırlı ücretsiz erişim süresi Byol - Müşterilerin mevcut yazılım lisanslarını sağladığı Kendi Lisansını Getir modeli Payg - Kullandıkça Öde gerçek kaynak kullanımı üzerinden hesaplanan tüketime dayalı faturalandırma Ri - İndirimli uzun vadeli fiyatlandırma için peşin taahhütle Rezerve Edilmiş Bulut Sunucusu faturalaması
skuId	string	SKU kimliği
stackType	string	Yığın türü : Klasik, Gen1, Gen2
summary	string	Plan özet metni
uniquePlanId	string	Arada ayırıcı olmadan uniqueProductId ve PlanId birleştirilerek ön eki olan benzersiz plan tanımlayıcısı
vmArchitectureType	string	Sanal makine işlemci mimarisini ve neslini belirtir. Yalnızca Sanal Makine ürün türleri için geçerlidir. X64Gen1 - 1. nesil sanal makine ürün yazılımı ve BIOS desteği ile x64 işlemci mimarisi X64Gen2 - 2. nesil sanal makine ürün yazılımı ve UEFI desteği ile x64 işlemci mimarisi Arm64 - Enerji verimliliği ve bulutta yerel iş yükleri için optimize edilmiş ARM 64 bit işlemci mimarisi
vmSecuritytypes	string[]	Sanal makine dağıtımları için güvenlik geliştirme düzeyini tanımlar. Yalnızca Sanal Makine ürün türleri için geçerlidir. None - Ek koruma özellikleri olmadan standart sanal makine güvenliği Trusted - Güvenli önyükleme ve sanal Güvenilir Platform Modülü özellikleriyle Güvenilir Başlatma güvenliği Confidential - Hassas iş yükleri için bellek şifreleme ve doğrulama ile gizli bilgi işlem

ProductSummary

Nesne

Ürün özniteliklerinin bir alt kümesini döndürür

Name	Tür	Description
applicableProducts	string[]	Teklifin ait olduğu ürün kategorileri
attributes	Attribute[]	Ürün özellikleri kümesi
azureBenefit	string	Ürün satın alma işlemlerinin kurumsal müşteriler için Azure tüketim taahhüdü avantajlarına sayılıp sayılmadığını gösterir. Eligible - Ürün maliyetleri Azure tüketim taahhüdü avantajı hesaplamaları ve kredileri için geçerlidir NotEligible - Ürün maliyetleri Azure tüketim taahhüdü avantaj programları için uygun değildir
badges	string[]	Pazar görünürlüğü için ürün tarafından kazanılan sertifika ve yeterlilik rozetlerini görüntüler. PreferredSolution - Belirli kalite ve iş ortaklığı kriterlerini karşılayan Microsoft tarafından tanınan çözüm PowerBICertified - Microsoft Power BI platformuyla sertifikalı uyumluluk ve entegrasyon AdditionalPurchaseRequirement - Ürün, tam işlevsellik için ek satın alımlar veya abonelikler gerektirir
categoryIds	string[]	Ürün kategorileri dizisi
cspLegalTermsUri	string	CSP için ürünün yasal koşulları
description	string	Ürün açıklama metni
displayName	string	Ürün görünen adı
hasMarketplaceFootprint	boolean	Ürünün pazarda bir temsili olup olmadığının belirtilmesi
hasRiPlans	boolean	Ürünün rezervasyonlu planları olup olmadığını gösterme
industryIds	string[]	Öğenin ait olduğu sektör kimliklerinin listesi
lastModifiedDateTime	string	Ürünün son güncelleme tarihi
locations	string[]	SKU'larda bulunan konumların listesi
longSummary	string	Ürün uzun özeti
operatingSystems	string[]	Bu ürün için işletim sistemi bilgisi
plans	PlanSummary[]	Tam plan/SKU öznitelikleri kümesi
popularity	number (double)	Ürünün popülaritesi
pricingTypes	string[]	Plan için kullanılabilen faturalama modellerini ve maliyet yapılarını gösterir. Free - Genellikle topluluk sürümleri veya temel hizmet katmanları için plan kullanımı için ücret alınmaz FreeTrial - Ücretli faturalandırma modeline geçmeden önce zaman sınırlı ücretsiz erişim süresi Byol - Müşterilerin mevcut yazılım lisanslarını sağladığı Kendi Lisansını Getir modeli Payg - Kullandıkça Öde gerçek kaynak kullanımı üzerinden hesaplanan tüketime dayalı faturalandırma Ri - İndirimli uzun vadeli fiyatlandırma için peşin taahhütle Rezerve Edilmiş Bulut Sunucusu faturalaması
privacyPolicyUri	string	Ürünün gizlilik politikası
productFamily	string	Ürün Ailesi
productId	string	Ürünün benzersiz kimliği
productSubType	string	Ürün alt tipi
productType	string	Market Kataloğu'nda depolanan market ürünü için birincil dağıtım modelini ve barındırma mimarisini belirtir. None - Belirtilmemiş ürün türü, genellikle tanımlanmış bir dağıtım modeli olmayan ürünler için kullanılır ManagedApplication - Müşteri aboneliklerindeki kaynakları dağıtan ve yöneten Azure Yönetilen Uygulamaları VirtualMachine - Azure işlem altyapısına dağıtılabilen önceden yapılandırılmış sanal makine görüntüleri AzureApplication - Platform hizmetlerinden ve API'lerden yararlanan yerel Azure uygulamaları Container - Azure Container Instances veya benzer hizmetler aracılığıyla dağıtılan kapsayıcılı uygulamalar SaaS - Yayıncı tarafından barındırılan ve yönetilen Hizmet Olarak Yazılım çözümleri SolutionTemplate - Birden çok Azure kaynağı sağlayan Azure Resource Manager şablonları IotEdgeModules - Azure IoT Edge çalışma zamanı ortamlarına dağıtım için tasarlanmış modüller ManagedServices - Yayıncının altyapı ve operasyonları yönettiği tam olarak yönetilen hizmetler ContainerApps - Azure Container Apps sunucusuz kapsayıcı platformu için oluşturulmuş uygulamalar DynamicsOps - Microsoft Dynamics 365 Finance and Operations uygulamaları ve uzantıları DynamicsCE - Microsoft Dynamics 365 Customer Engagement uygulamaları ve özelleştirmeleri DynamicsBC - Microsoft Dynamics 365 Business Central uygulamaları ve eklentileri PowerBI - Microsoft Power BI raporları, panoları ve veri görselleştirme bileşenleri ConsultingServices - Uygulama ve danışmanlık hizmetleri de dahil olmak üzere profesyonel hizmet teklifleri CosellOnly - Yalnızca Microsoft ortak satış iş ortağı programları aracılığıyla kullanılabilen ürünler CoreVirtualMachine - Temel Azure işlem özelliklerine sahip temel sanal makine teklifleri PowerBIVisuals - Microsoft Power BI raporlama platformu için özel görselleştirmeler Office365 - Microsoft 365 ve Office 365 uygulamaları, eklentileri ve tümleştirmeleri AADApps - Kurumsal kimliği destekleyen Azure Active Directory tümleşik uygulamaları AzureServices - Yerel Azure platform hizmetleri ve kaynak sağlayıcıları AppService - Azure App Service platformunda barındırılan web uygulamaları LogAnalytics - Azure İzleyici Log Analytics çözümleri ve çalışma alanı yapılandırmaları MicrosoftProduct - Market kanalları aracılığıyla sunulan birinci taraf Microsoft ürünleri
publisherDisplayName	string	Yayıncı görünen adı
publisherId	string	Yayıncı kimliği
publisherType	string	Destek ve ortaklık sınıflandırması için yayımcının Microsoft ile ilişkisini tanımlar. Microsoft - Doğrudan Microsoft desteği ve geliştirmesi ile birinci taraf Microsoft ürünü ThirdParty - Yayıncı tarafından sağlanan destek ve bakıma sahip bağımsız yazılım satıcısı ürünü
publishingStage	string	Azure Market içindeki ürün kullanılabilirlik durumunu ve müşteri erişim düzeyini gösterir. Preview - Test ve erken erişim değerlendirmesi için seçilen müşterilere sınırlı kullanılabilirlik Public - Üretim dağıtımı için tüm Azure Market müşterileri için genel kullanılabilirlik
ratingAverage	number (double)	Teklif için ortalama puan
ratingBuckets	string[]	Ürünleri, pazar yeri filtreleme ve keşif için müşteri derecelendirme eşiklerine göre kategorilere ayırır. AboveOne - Pazar yeri incelemelerine göre müşteri puanları 1,0 yıldızı aşan ürünler AboveTwo - Pazar yeri incelemelerine göre müşteri puanları 2,0 yıldızı aşan ürünler AboveThree - Pazar yeri incelemelerine göre müşteri puanları 3,0 yıldızı aşan ürünler AboveFour - Pazar yeri incelemelerine göre müşteri puanları 4,0 yıldızı aşan ürünler
ratingCount	integer (int32)	Teklif için toplam puan sayısı
service	string	Ürünün hizmet adı (ör. 'Sanal Makineler')
serviceFamily	string	Ürünün hizmet ailesi (ör. 'Compute')
smallIconUri	string	URI'yi küçük ürün simgesine
summary	string	Ürün özeti
supportedProducts	string[]	Uyumlu ürünler listesiyle eşleşir
uniqueProductId	string	Benzersiz ürün tanımlayıcısı

ProductSummaryListResult

Nesne

Liste işleminin özel yanıtı.

Name	Tür	Description
nextLink	string	Öğelerin sonraki sayfasına bağlantı
value	ProductSummary[]	Bu sayfadaki öğeler