Ü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:

  1. ByCountry() yöntemini kullanarak ülkeyi seçmek için IAggregatePartner.Products koleksiyonu 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 segmenti seçin.

  5. 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:

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

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

  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

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