Ürünlerin bir listesini alma (ülkeye göre)
Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government
Belirli bir ülkede kullanılabilen ürün koleksiyonunu almak için aşağıdaki yöntemleri kullanabilirsiniz.
Önkoşullar
kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamasını destekler.
Ülke.
C#
Ürünlerin listesini almak için:
ByCountry() yöntemini kullanarak ülkeyi seçmek için IAggregatePartner.Products koleksiyonu kullanın.
ByTargetView() yöntemini kullanarak katalog görünümünü seçin.
(İsteğe bağlı) ByReservationScope() yöntemini kullanarak rezervasyon kapsamını seçin.
(İsteğe bağlı) ByTargetSegment() yöntemini kullanarak hedef segmenti seçin.
Koleksiyonu geri almak için Get()veya GetAsync() yöntemini çağırma.
IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();
// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();
// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();
Java
İş Ortağı Merkezi Java SDK'sı genellikle iş ortakları tarafından kendi kaynak kaynaklarını yönetmek İş Ortağı Merkezi kullanılır. İş ortağı topluluğu tarafından bakımı yapılan açık kaynaklı bir projedir. Bu modül iş ortağı topluluğu tarafından korundu ve Microsoft tarafından resmi olarak desteklenmiyor. Bir sorun yaşamanıza yardımcı olmakiçin topluluktan yardım GitHub bir sorun açabilirsiniz.
Ürünlerin listesini almak için:
byCountry() işlevini kullanarak ülkeyi seçmek için IAggregatePartner.getProducts işlevinizi kullanın.
byTargetView() işlevini kullanarak katalog görünümünü seçin.
(İsteğe bağlı) byTargetSegment() işlevini kullanarak hedef segmenti seçin.
Koleksiyonu geri almak için get() işlevini çağırma.
// IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();
PowerShell
PowerShell İş Ortağı Merkezi yaygın olarak iş ortakları tarafından kendi kaynaklarınızı yönetmek için İş Ortağı Merkezi kullanılır. İş ortağı topluluğu tarafından bakımı yapılan açık kaynaklı bir projedir. Bu modül iş ortağı topluluğu tarafından korundu ve Microsoft tarafından resmi olarak desteklenmiyor. Bir sorun yaşamanıza yardımcı olmakiçin topluluktan yardım GitHub bir sorun açabilirsiniz.
Ürünlerin listesini almak için:
Get-PartnerProduct komutunu yürütün.
Katalog parametresini belirterek kataloğu seçin.
(İsteğe bağlı) Segment parametresini belirterek hedef segmenti seçin.
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
REST isteği
İstek söz dizimi
| Yöntem | İstek URI'si |
|---|---|
| AL | {baseURL}/v1/products?country={country} targetView={targetView} targetSegment={targetSegment} HTTP/1.1 |
URI parametreleri
Ürünlerin listesini almak için aşağıdaki yolu ve sorgu parametrelerini kullanın.
| Ad | Tür | Gerekli | Açıklama |
|---|---|---|---|
| ülke | string | Yes | Ülke/bölge kimliği. |
| targetView | string | Yes | Kataloğun hedef görünümünü tanımlar. Desteklenen değerler: Azure, tüm Azure öğelerini içerir Tüm Azure rezervasyon öğelerini içeren AzureReservations Tüm sanal makine (VM) rezervasyon öğelerini içeren AzureReservationsVM Tüm rezervasyon öğelerini içeren AzureReservationsSQLSQL öğeleri AzureReservationsCosmosDb,veritabanı rezervasyon Cosmos öğelerini içerir Microsoft Azure abonelikleri (MS-AZR-0145P) ve Azure planları için öğeleri içeren MicrosoftAzure Tüm çevrimiçi hizmet öğelerini içeren OnlineServices. Bu targetView ticari marketi, geleneksel lisans tabanlı hizmetleri ve yeni ticari lisans tabanlı hizmetleri içerir Yazılım, tüm yazılım öğelerini içerir SoftwareSUSELinux, tüm yazılım SUSE Linux öğelerini içerir Tüm kalıcı yazılım öğelerini içeren SoftwarePerpetual Tüm yazılım aboneliği öğelerini içeren YazılımAubscriptions |
| targetSegment | dize | No | Hedef segmenti tanımlar. Farklı hedef kitlelere yönelik görünüm. Desteklenen değerler: Ticari Eğitim Hükümet Kar amacı gütme -yen |
| reservationScope | dize | No | Azure Rezervasyonları için ürünlerin listesini sorgularken, Azure planları için reservationScope=AzurePlan geçerli olan ürünlerin listesini almak için belirtin. Microsoft Azure (MS-AZR-0145P) abonelikleri için geçerli olan Azure rezervasyonlarının ürünlerinin listesini almak için bu parametreyi hariç tutabilirsiniz. |
İstek üst bilgileri
Daha fazla bilgi için bkz. İş Ortağı Merkezi REST üst bilgileri.
İstek gövdesi
Yok.
İstek örnekleri
Ülkeye göre ürünler
Microsoft Azure (MS-AZR-0145P) abonelikleri ve Azure planları için ülkeye göre ürünlerin listesini almak için bu örneği izleyin.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Azure VM rezervasyonları (Azure planı)
Azure planları için geçerli olan Azure VM rezervasyonları için ülkeye göre ürünlerin listesini almak için bu örneği izleyin.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Microsoft Azure (MS-AZR-0145P) abonelikleri için Azure VM rezervasyonları
Microsoft Azure (MS-AZR-0145P) abonelikleri için geçerli olan Azure VM rezervasyonları için ülkeye göre ürünlerin listesini almak için bu örneği izleyin.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Yeni ticari lisans tabanlı hizmetler
Not
Yeni Ticaret değişiklikleri şu anda yalnızca M365/D365 yeni ticaret deneyimi teknik önizlemesi kapsamında olan iş ortakları tarafından kullanılabilir
Yeni ticari deneyim teknik önizlemesi kapsamında yeni ticari lisans tabanlı hizmetler için ülkeye göre ürünlerin listesini almak için bu örneği izleyin. Yeni ticari lisans tabanlı hizmetler, Id ve displayNames değerlerinin OnlineServicesNCE değerine göre tanımlanır. Aşağıdaki yanıt örneğine bakın.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
REST yanıtı
Başarılı olursa, yanıt gövdesi bir ürün kaynakları koleksiyonu içerir.
Yanıt başarısı ve hata kodları
Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. Partner Center hata kodları.
Bu yöntem aşağıdaki hata kodlarını döndürür:
| HTTP durum kodu | Hata kodu | Description |
|---|---|---|
| 403 | 400030 | İstenen targetSegment erişimine izin verilmiyor. |
| 403 | 400036 | İstenen targetView 'a erişime izin verilmiyor. |
Azure VM ayırmaları için yanıt örneği (Azure planı)
{
"totalCount": 19,
"items": [
{
"id": "DZH318Z0BQ3Q",
"title": "Virtual Machines DSv2 Series",
"description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
"productType": {
"id": "Azure",
"displayName": "Azure",
"subType": {
"id": "VirtualMachines",
"displayName": "VirtualMachines"
}
},
"isMicrosoftProduct": true,
"publisherName": "Microsoft",
"links": {
"skus": {
"uri": "/products/DZH318Z0BQ3Q/skus?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BQ3Q?country=US",
"method": "GET",
"headers": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=Azure",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Yeni ticaret lisansı tabanlı hizmetler için yanıt örneği
Not
Yeni ticaret değişiklikleri şu anda yalnızca M365/D365 yeni ticaret deneyimi teknik önizlemesinin parçası olan iş ortakları tarafından kullanılabilir
{
"totalCount": 19,
"items": [{
"id": "CFQ7TTC0LH18",
"title": "Microsoft 365 Business Basic",
"description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
"productType": {
"id": "OnlineServicesNCE",
"displayName": "OnlineServicesNCE"
},
"isMicrosoftProduct": true,
"publisherName": "Microsoft Corporation",
"links": {
"skus": {
"uri": "/products/CFQ7TTC0LH18/skus?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/CFQ7TTC0LH18?country=US",
"method": "GET",
"headers": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=OnlineServices",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}