Mendapatkan produk berdasarkan ID

Artikel
01/31/2024

Mendapatkan sumber daya produk yang ditentukan menggunakan ID produk.

Prasyarat

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

C#

Untuk menemukan produk tertentu berdasarkan ID, gunakan koleksi IAggregatePartner.Products Anda, pilih negara dengan menggunakan metode ByCountry(), lalu panggil metode ById(). Terakhir, panggil metode Get() atau GetAsync() untuk mengembalikan produk.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

Java

Partner Center Java SDK 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 menemukan produk tertentu menurut ID, gunakan fungsi IAggregatePartner.getProducts Anda, pilih negara dengan menggunakan fungsi byCountry(), lalu panggil fungsi byId(). Terakhir, panggil fungsi get() untuk mengembalikan produk.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").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 menemukan produk tertentu berdasarkan ID, jalankan perintah Get-PartnerProduct dan tentukan parameter ProductId . Parameter CountryCode adalah opsi, jika tidak ditentukan, maka negara yang terkait dengan reseller akan digunakan.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

Permintaan REST

Minta sintaks

Metode	URI Permintaan
GET	{baseURL}/v1/products/{product-id}?country={country} HTTP/1.1

Parameter URI

Gunakan parameter jalur berikut untuk mendapatkan produk yang ditentukan.

Nama	Jenis	Diperlukan	Deskripsi
product-id	string	Ya	String yang mengidentifikasi produk.
negara	string	Ya	ID negara/wilayah.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

GET https://api.partnercenter.microsoft.com/v1/products/{product-id}?country=US 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 sumber daya Produk .

Respons keberhasilan dan kode kesalahan

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
404	400013	Produk tidak ditemukan.

Contoh respons untuk reservasi Azure VM (paket Azure)

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Tue, 23 Jan 2018 23:13:01 GMT

{
    "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&reg; 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": []
        }
    }
}

Contoh respons untuk produk 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.

{
    "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": []
        }
    }
}

Bagikan melalui