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:
Gunakan koleksi IAggregatePartner.Products Anda untuk memilih negara/wilayah dengan menggunakan metode ByCountry().
Pilih tampilan katalog menggunakan metode ByTargetView().
(Opsional) Pilih cakupan reservasi menggunakan metode ByReservationScope().
(Opsional) Pilih segmen target menggunakan metode ByTargetSegment().
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();
Java
SDK Java 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 bisa mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.
Untuk mendapatkan daftar produk:
Gunakan fungsi IAggregatePartner.getProducts Anda untuk memilih negara dengan menggunakan fungsi byCountry().
Pilih tampilan katalog menggunakan fungsi byTargetView().
(Opsional) Pilih segmen target menggunakan fungsi byTargetSegment().
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 Pusat Mitra 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 bisa mendapatkan bantuan dari komunitas atau membuka masalah di GitHub jika Anda mengalami masalah.
Untuk mendapatkan daftar produk:
Jalankan perintah Get-PartnerProduct .
Pilih katalog dengan menentukan parameter Katalog .
(Opsional) Pilih segmen target dengan menentukan parameter Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
Permintaan REST
Minta sintaks
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
Parameter URI
Gunakan parameter jalur dan kueri berikut untuk mendapatkan daftar produk.
| Nama | Jenis | Wajib | Deskripsi |
|---|---|---|---|
| negara | string | Ya | ID negara/wilayah. |
| targetView | string | Ya | Mengidentifikasi tampilan target katalog. Nilai yang didukung adalah: Azure, yang mencakup semua item Azure AzureReservations, yang mencakup semua item reservasi Azure AzureReservationsVM, yang mencakup semua item reservasi komputer virtual (VM) AzureReservationsSQL, yang mencakup semua item reservasi SQL AzureReservationsCosmosDb, yang mencakup semua item reservasi database Cosmos MicrosoftAzure, yang mencakup item untuk langganan Microsoft Azure (paket MS-AZR-0145P) dan Azure OnlineServices, yang mencakup semua item layanan online seperti layanan berbasis lisensi tradisional dan layanan berbasis lisensi perdagangan baru. Perangkat lunak, yang mencakup semua item perangkat lunak SoftwareSUSELinux, yang mencakup semua perangkat lunak item SUSE Linux SoftwarePerpetual, yang mencakup semua item perangkat lunak abadi SoftwareSubscriptions, yang mencakup semua item langganan perangkat lunak SpecializedOffers, yang mencakup penawaran khusus yang telah tersedia untuk beberapa mitra MarketplaceSaaS, yang mencakup semua penawaran marketplace komersial yang diterbitkan oleh Vendor Perangkat Lunak Independen (ISV) |
| targetSegment | string | No | Mengidentifikasi segmen target. Tampilan untuk audiens target yang berbeda. Nilai yang didukung adalah: Komersial Pendidikan Pemerintah Nirlaba |
| reservationScope | string | No | Saat mengkueri daftar produk untuk Reservasi Azure, tentukan reservationScope=AzurePlan untuk mendapatkan daftar produk yang berlaku untuk paket Azure. Kecualikan parameter ini untuk mendapatkan daftar produk untuk reservasi Azure, yang berlaku untuk langganan Microsoft Azure (MS-AZR-0145P). |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tidak ada.
Contoh permintaan
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Reservasi Azure VM (paket 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Layanan berbasis lisensi perdagangan baru
Catatan
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman 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 displayNames 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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:
| Kode Status HTTP | Kode kesalahan | Deskripsi |
|---|---|---|
| 403 | 400030 | Akses ke targetSegment yang diminta tidak diizinkan. |
| 403 | 400036 | Akses ke targetView yang diminta tidak diizinkan. |
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
Catatan
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman 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"
}
}
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk