Aracılığıyla paylaş

Ürünlerin listesini alma (ülkeye/bölgeye göre)

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Belirli bir ülkede/bölgede kullanılabilen bir ürün koleksiyonunu almak için aşağıdaki yöntemleri kullanabilirsiniz.

Önkoşullar

  • İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Ülke/bölge.

C#

Ürünlerin listesini almak için:

  1. ByCountry() yöntemini kullanarak ülkeyi/bölgeyi seçmek için IAggregatePartner.Products koleksiyonunuzu kullanın.

  2. ByTargetView() yöntemini kullanarak katalog görünümünü seçin.

  3. (İsteğe bağlı) ByReservationScope() yöntemini kullanarak rezervasyon kapsamını seçin.

  4. (İsteğe bağlı) ByTargetSegment() yöntemini kullanarak hedef kesimi seçin.

  5. Koleksiyonu döndürmek için Get() veya GetAsync() yöntemini çağırın.

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ı, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.

Ürünlerin listesini almak için:

  1. byCountry() işlevini kullanarak ülkeyi seçmek için IAggregatePartner.getProducts işlevinizi kullanın.

  2. byTargetView() işlevini kullanarak katalog görünümünü seçin.

  3. (İsteğe bağlı) byTargetSegment() işlevini kullanarak hedef segmenti seçin.

  4. Koleksiyonu döndürmek için get() işlevini çağırın.

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

İş Ortağı Merkezi PowerShell modülü, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.

Ürünlerin listesini almak için:

  1. Get-PartnerProduct komutunu yürütür.

  2. Katalog parametresini belirterek kataloğu seçin.

  3. (İsteğe bağlı) Segment parametresini belirterek hedef segmenti seçin.

Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'

REST isteği

İstek söz dizimi

Metot İstek URI'si
GET {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 Zorunlu 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 şunlardır:

Tüm Azure öğelerini içeren Azure

Tüm Azure rezervasyon öğelerini içeren AzureReservations

Tüm sanal makine (VM) rezervasyon öğelerini içeren AzureReservationsVM

Tüm SQL rezervasyon öğelerini içeren AzureReservationsSQL

Tüm Cosmos veritabanı rezervasyon öğelerini içeren AzureReservationsCosmosDb

Microsoft Azure abonelikleri (MS-AZR-0145P) ve Azure planları için öğeleri içeren MicrosoftAzure

Geleneksel lisans tabanlı hizmetler ve yeni ticari lisans tabanlı hizmetler gibi tüm çevrimiçi hizmet öğelerini içeren OnlineServices.

Tüm yazılım öğelerini içeren yazılım

Tüm yazılım SUSE Linux öğelerini içeren SoftwareSUSELinux

Tüm kalıcı yazılım öğelerini içeren SoftwarePerpetual

Tüm yazılım aboneliği öğelerini içeren SoftwareSubscriptions

Bazı iş ortaklarının kullanımına sunulan özel teklifler içeren SpecializedOffers

Bağımsız Yazılım Satıcıları (ISV) tarafından yayımlanan tüm ticari market tekliflerini içeren MarketplaceSaaS
targetSegment Dize Hayır Hedef segmenti tanımlar. Farklı hedef kitleler için görünüm. Desteklenen değerler şunlardır:

ticari
eğitim
hükümet
kar amacı gütmeyen kuruluş
reservationScope Dize Hayır Azure Rezervasyonları için ürünlerin listesini sorgularken, Azure planları için geçerli olan ürünlerin listesini almak için belirtin reservationScope=AzurePlan . Microsoft Azure (MS-AZR-0145P) abonelikleri için geçerli olan Azure rezervasyonlarının ürünlerinin listesini almak için bu parametreyi hariç tutun.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

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ına uygun 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ının ülkeye göre ürünlerinin 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 ticaret lisans tabanlı hizmetler

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

Yeni ticaret deneyimi teknik önizlemesinin bir parçası olarak yeni ticaret lisansı tabanlı hizmetler için ülkeye göre ürünlerin listesini almak için bu örneği izleyin. Yeni ticaret lisans tabanlı hizmetler, OnlineServicesNCE id ve displayNames değerleriyle 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ılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi hata kodları.

Bu yöntem aşağıdaki hata kodlarını döndürür:

HTTP Durum Kodu Hata kodu Açıklama
Kategori 403 400030 İstenen targetSegment öğesine erişime izin verilmiyor.
Kategori 403 400036 İstenen targetView'a erişime izin verilmiyor.

Azure VM rezervasyonları 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 ticari lisans tabanlı hizmetler için yanıt örneği

Not

Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.

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