Mendapatkan daftar produk (menurut pelanggan)

Artikel
01/31/2024

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 untuk pelanggan yang sudah ada.

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
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).

Permintaan REST

Minta sintaks

Metode	URI Permintaan
POST	{baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView} HTTP/1.1

Meminta parameter URI

Nama	Tipe	Wajib	Deskripsi
customer-tenant-id	GUID	Ya	Nilainya adalah id penyewa pelanggan berformat GUID, yang merupakan pengidentifikasi yang memungkinkan Anda menentukan pelanggan.
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. TargetView ini mencakup marketplace komersial, 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

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Tidak ada.

Contoh permintaan

Minta daftar produk berbasis penggunaan Azure yang tersedia untuk pelanggan tertentu. Produk untuk paket Microsoft Azure (MS-AZR-0145P) dan Azure akan dikembalikan untuk pelanggan di cloud publik:

GET https://api.partnercenter.microsoft.com/v1/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 83643f5e-5dfd-4375-88ed-054412460dc8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

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/wilayah 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/customers/65543400-f8b0-4783-8530-6d35ab8c6801/products?targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee

Respons rest

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	400036	Akses ke targetView yang diminta tidak diizinkan.

Contoh respons untuk paket Microsoft Azure dan Azure

HTTP/1.1 200 OK
Content-Length: 1909
Content-Type: application/json; charset=utf-8
MS-CorrelationId: cccc2222-dd33-4444-55ee-666666ffffff
MS-RequestId: ae7288e2-2673-4ad4-8c12-7aad818d5949

{
    "totalCount": 2,
    "items": [
        {
            "id": "MS-AZR-0145P",
            "productId": "9DEA7946-EC2C-441E-9FFD-E3B275F7E838",
            "title": "Microsoft Azure",
            "description": "Azure Cloud Solution Provider offer for Partner and Resellers",
            "minimumQuantity": 1,
            "maximumQuantity": 1,
            "isTrial": false,
            "supportedBillingCycles": [
                "monthly"
            ],
            "purchasePrerequisites": [
                "MicrosoftCloudAgreement"
            ],
            "actions": [
                "Refund"
            ],
            "dynamicAttributes": {
                "isMicrosoftProduct": true,
                "billingType": "usage",
                "category": "Enterprise",
                "isAddon": false,
                "prerequisiteSkus": [],
                "rank": 1413,
                "hasAddOns": false,
                "isAutoRenewable": false,
                "upgradeTargetOffers": null,
                "conversionTargetOffers": [],
                "unitType": "Usage-based",
                "limitUnitOfMeasure": "None",
                "limit": 0,
                "reselleeQualifications": [],
                "resellerQualifications": []
            },
            "links": {
                "availabilities": {
                    "uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P/availabilities?country=US&targetSegment=Commercial",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/products/9DEA7946-EC2C-441E-9FFD-E3B275F7E838/skus/MS-AZR-0145P?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        },
        {
            "id": "0001",
            "productId": "DZH318Z0BPS6",
            "title": "Microsoft Azure plan",
            "description": "Microsoft Azure plan (MS-AZR-0017G)",
            "minimumQuantity": 1,
            "maximumQuantity": 1,
            "isTrial": false,
            "supportedBillingCycles": [
                "one_time"
            ],
            "purchasePrerequisites": [
                "MicrosoftCustomerAgreement"
            ],
            "inventoryVariables": [],
            "provisioningVariables": [],
            "actions": [
                "Refund"
            ],
            "dynamicAttributes": {
                "isMicrosoftProduct": true,
                "pilotProgram": "modernazurepilot"
            },
            "links": {
                "availabilities": {
                    "uri": "/products/DZH318Z0BPS6/skus/0001/availabilities?country=US&targetSegment=Commercial",
                    "method": "GET",
                    "headers": []
                },
                "self": {
                    "uri": "/products/DZH318Z0BPS6/skus/0001?country=US",
                    "method": "GET",
                    "headers": []
                }
            }
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/e2a0c0f3-0f74-4d1c-808c-dfa511481913/products/all/skus?targetView=MicrosoftAzure&targetSegment=Commercial",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
}

Contoh respons untuk layanan berbasis lisensi perdagangan baru