Mendapatkan status peningkatan produk untuk pelanggan

Artikel
09/23/2023

Anda dapat menggunakan sumber daya ProductUpgradeRequest untuk mendapatkan status peningkatan ke keluarga produk baru. Sumber daya ini berlaku saat Anda meningkatkan pelanggan dari langganan Microsoft Azure (MS-AZR-0145P) ke paket Azure. Permintaan yang berhasil mengembalikan sumber daya ProductUpgradesEligibility.

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.
Id peningkatan permintaan peningkatan.

C#

Untuk memeriksa apakah pelanggan memenuhi syarat untuk meningkatkan ke paket Azure:

Buat objek ProductUpgradesRequest dan tentukan pengidentifikasi pelanggan dan "Azure" sebagai keluarga produk.
Gunakan koleksi IAggregatePartner.ProductUpgrades.
Panggil metode ById dan berikan id-peningkatan.
Panggil metode CheckStatus dan teruskan objek ProductUpgradesRequest, yang akan mengembalikan objek ProductUpgradeStatus.

// IAggregatePartner partnerOperations;

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

string selectedProductFamily = "azure";

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

ProductUpgradesStatus productUpgradeStatus = partnerOperations.ProductUpgrades.ById(selectedUpgradeId).CheckStatus(productUpgradeRequest);

if (productUpgradeEligibility.IsEligibile)
{
    ....
}

Permintaan REST

Minta sintaks

Metode	URI Permintaan
POST	{baseURL}/v1/productUpgrades/{upgrade-id}/status HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk menentukan pelanggan tempat Anda mendapatkan status peningkatan produk.

Nama	Tipe	Wajib	Deskripsi
upgrade-id	GUID	Ya	Nilainya adalah pengidentifikasi peningkatan berformat GUID. Anda dapat menggunakan pengidentifikasi ini untuk menentukan peningkatan yang akan dilacak.

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/42d075a4-bfe7-43e7-af6d-7c68a57edcb4/status  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"
  }
  "Attributes": {
  "ObjectType": "ProductUpgradeRequest"
  }
}

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, metode ini mengembalikan sumber daya ProductUpgradesEligibility dalam isi.

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 200 Ok
Content-Length: 150
MS-CorrelationId: 772871a9-399b-4f3b-b8c7-38f550e4f22a
MS-RequestId: cb82f7d6-f0d9-44d4-82f9-f6eee6e68390
MS-CV: iqOqN0FnaE2y0HcD.0
MS-ServerId: 030020525
Date: Thu, 04 Oct 2019 20:35:35 GMT

{
    "id": "42d075a4-bfe7-43e7-af6d-7c68a57edcb4",
    "status": "Completed",
    "productFamily": "Azure",
    "lineItems": [
        {
            "sourceProduct": {
                "id": "b1beb621-3cad-4d7a-b360-62db33ce028e",
                "name": "AzureSubscription"
            },
            "targetProduct": {
                "id": "d231908e-31c1-de0e-027b-bc5ce11f09d9",
                "name": "Microsoft Azure plan"
            },
            "upgradedDate": "2019-08-29T23:47:28.8524555Z",
            "status": "Completed"
        }
    ]
}

Bagikan melalui