Membuat entitas peningkatan produk untuk pelanggan

Artikel
09/23/2023

Anda dapat membuat entitas peningkatan produk untuk meningkatkan pelanggan ke keluarga produk tertentu (misalnya, paket Azure) menggunakan sumber daya ProductUpgradeRequest .

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial App+User. Ikuti model aplikasi aman saat menggunakan autentikasi Aplikasi+Pengguna dengan API Pusat Mitra.
ID pelanggan (customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan , lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).
Keluarga produk yang ingin Anda tingkatkan pelanggannya.

C#

Untuk meningkatkan pelanggan ke paket Azure:

Buat objek ProductUpgradesRequest dan tentukan pengidentifikasi pelanggan dan "Azure" sebagai keluarga produk.
Gunakan koleksi IAggregatePartner.ProductUpgrades.
Panggil metode Buat dan teruskan di objek ProductUpgradesRequest, yang akan mengembalikan string header lokasi.
Ekstrak upgrade-id dari string header lokasi yang dapat digunakan untuk mengkueri status pemutakhiran.

// IAggregatePartner partnerOperations;

string selectedCustomerId = "58e2af4f-0ad3-4688-8744-be2357cd939a";

string selectedProductFamily = "Azure";

var productUpgradeRequest = new ProductUpgradesRequest
{
    CustomerId = selectedCustomerId,
    ProductFamily = selectedProductFamily
};

var productUpgradeLocationHeader = partnerOperations.ProductUpgrades.Create(productUpgradeRequest);

var upgradeId = Regex.Split(productUpgradeLocationHeader, "/")[1];

Permintaan REST

Minta sintaks

Metode	URI Permintaan
POST	{baseURL}/v1/productupgrades HTTP/1.1

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Isi permintaan harus berisi sumber daya ProductUpgradeRequest .

Contoh permintaan

POST https://api.partnercenter.microsoft.com/v1/productupgrades HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c245d5f2-1de3-4ae0-9e42-95e38e3cb8ff
MS-CorrelationId: e3f26e6a-044f-4371-ad52-0d91ce4200be
X-Locale: en-US
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 340
Expect: 100-continue
Connection: Keep-Alive
{
  "customerId": "4c721420-72ad-4708-a0a7-371a2f7b0969",
  "productFamily": "Azure"
}

Penting

Pada Juni 2023, Pusat Mitra terbaru .NET SDK rilis 3.4.0 sekarang diarsipkan. Anda dapat mengunduh rilis SDK dari GitHub, bersama dengan file readme yang berisi informasi yang berguna.

Mitra didorong untuk terus menggunakan REST API Pusat Mitra.

Respons REST

Jika berhasil, respons berisi header Lokasi yang memiliki URI yang dapat digunakan untuk mengambil status peningkatan produk. Simpan URI ini untuk digunakan dengan REST API terkait lainnya.

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 REST Pusat Mitra.

Contoh tanggapan

HTTP/1.1 202 Accepted
Content-Length: 0
Location: productUpgrades/42d075a4-bfe7-43e7-af6d-7c68a57edcb4
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 28 Sep 2019 20:35:35 GMT

Bagikan melalui