Mendapatkan daftar produk (menurut negara/wilayah)

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Anda dapat menggunakan metode berikut untuk mendapatkan koleksi produk yang tersedia di negara/wilayah tertentu.

Prasyarat

• Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.

• Negara/wilayah.

C#

Untuk mendapatkan daftar produk:

1. Gunakan koleksi IAggregatePartner.Products Anda untuk memilih negara/wilayah dengan menggunakan metode ByCountry().

2. Pilih tampilan katalog menggunakan metode ByTargetView().

3. (Opsional) Pilih cakupan reservasi menggunakan metode ByReservationScope().

4. (Opsional) Pilih segmen target menggunakan metode ByTargetSegment().

5. Panggil metode Get() atau GetAsync() untuk mengembalikan koleksi.

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();

Jawa

Java SDK Pusat Mitra dapat digunakan untuk mengelola sumber daya Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda dapat mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.

Untuk mendapatkan daftar produk:

1. Gunakan fungsi IAggregatePartner.getProducts Anda untuk memilih negara dengan menggunakan byCountry() .

2. Pilih tampilan katalog menggunakan fungsi byTargetView().

3. (Opsional) Pilih segmen target menggunakan fungsi byTargetSegment().

4. Panggil fungsi get() untuk mengembalikan koleksi.

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

Modul Partner Center PowerShell dapat digunakan untuk mengelola sumber daya Pusat Mitra. Ini adalah proyek sumber terbuka yang dikelola oleh komunitas mitra dan tidak didukung secara resmi oleh Microsoft. Anda dapat mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.

Untuk mendapatkan daftar produk:

1. Jalankan perintahGet-PartnerProduct.

2. Pilih katalog dengan menentukan parameter Katalog.

3. (Opsional) Pilih segmen target dengan menentukan parameter Segmen.

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

Permintaan REST

Sintaks permohonan

Parameter URI

Gunakan parameter jalur dan kueri berikut untuk mendapatkan daftar produk.

Header permintaan

Untuk informasi selengkapnya, lihat header REST di Pusat Mitra.

Isi permintaan

Tidak.

Permintaan contoh

Produk menurut negara

Ikuti contoh ini untuk mendapatkan daftar produk menurut negara untuk langganan Microsoft Azure (MS-AZR-0145P) dan paket Azure.

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: aaaa0000-bb11-2222-33cc-444444dddddd

Reservasi Mesin Virtual Azure (rencana Azure)

Ikuti contoh ini untuk mendapatkan daftar produk menurut negara untuk reservasi Azure VM yang berlaku untuk paket Azure.

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: aaaa0000-bb11-2222-33cc-444444dddddd

Reservasi Azure VM untuk langganan Microsoft Azure (MS-AZR-0145P)

Ikuti contoh ini untuk mendapatkan daftar produk menurut negara untuk reservasi Azure VM yang berlaku untuk langganan Microsoft Azure (MS-AZR-0145P).

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: aaaa0000-bb11-2222-33cc-444444dddddd

Layanan berbasis lisensi perdagangan baru

Ikuti contoh ini untuk mendapatkan daftar produk menurut negara untuk layanan berbasis lisensi perdagangan baru sebagai bagian dari pratinjau teknis pengalaman perdagangan baru. Layanan berbasis lisensi perdagangan baru akan diidentifikasi oleh nilai ID dan nama tampilan dari OnlineServicesNCE. Lihat contoh respons di bawah ini.

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: aaaa0000-bb11-2222-33cc-444444dddddd

Respons REST

Jika berhasil, isi respons berisi kumpulan sumber daya Produk.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat kode kesalahan Pusat Mitra .

Metode ini mengembalikan kode kesalahan berikut:

Contoh respons untuk reservasi Azure VM (paket Azure)

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

Contoh respons untuk layanan berbasis lisensi perdagangan baru

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