Periksa inventarisasi item katalog menggunakan API Pusat Mitra

Artikel
09/27/2024

Cara memeriksa inventori untuk sekumpulan item katalog tertentu.

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
Satu atau beberapa ID produk. Secara opsional, ID SKU juga dapat ditentukan.
Konteks tambahan apa pun yang diperlukan untuk memverifikasi inventarisasi SKU yang dirujuk oleh ID produk/SKU yang disediakan. Persyaratan ini dapat bervariasi menurut jenis produk/SKU dan dapat ditentukan dari properti InventoryVariables SKU.

C#

Untuk memeriksa inventori, buat objek InventoryCheckRequest menggunakan objek InventoryItem untuk setiap item yang akan diperiksa. Kemudian, gunakan aksesor IAggregatePartner.Extensions, lingkup ke Produk lalu pilih negara/wilayah menggunakan metode ByCountry(). Terakhir, panggil metode CheckInventory() dengan objek InventoryCheckRequest Anda.

IAggregatePartner partnerOperations;
string customerId;
string subscriptionId;
string countryCode;
string productId;

// Build the inventory check request details object.
var inventoryCheckRequest = new InventoryCheckRequest()
{
    TargetItems = new InventoryItem[]{ new InventoryItem { ProductId = productId } },
    InventoryContext = new Dictionary<string, string>()
    {
      { "customerId", customerId },
      { "azureSubscriptionId", subscriptionId }
      { "armRegionName", armRegionName }
    }
};

// Get the inventory results.
var inventoryResults = partnerOperations.Extensions.Product.ByCountry(countryCode).CheckInventory(inventoryCheckRequest);

Permintaan REST

Minta sintaks

Metode	URI Permintaan
POST	{baseURL}/v1/extensions/product/checkInventory?country={country-code} HTTP/1.1

Parameter URI

Gunakan parameter kueri berikut untuk memeriksa inventori.

Nama	Tipe	Wajib	Deskripsi
kode negara	string	Ya	ID negara/wilayah.

Header permintaan

Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.

Isi permintaan

Detail permintaan inventori, yang terdiri dari sumber daya InventoryCheckRequest yang berisi satu atau beberapa sumber daya InventoryItem .

Pastikan Langganan Azure yang ditentukan dalam isi permintaan terdaftar dan diaktifkan untuk membeli Azure RIs. Lihat Mendaftarkan Langganan untuk detail tentang proses pendaftaran.

Contoh permintaan

POST https://api.partnercenter.microsoft.com/v1/extensions/product/checkinventory?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json

{"TargetItems":[{"ProductId":"DZH318Z0BQ3P"}],"InventoryContext":{"customerId":"d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d","azureSubscriptionId":"3A231FBE-37FE-4410-93FD-730D3D5D4C75","armRegionName":"Europe"}}

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, isi respons berisi kumpulan objek InventoryItem yang diisi dengan detail pembatasan, jika ada yang berlaku.

Catatan

Jika InventoryItem input mewakili item yang tidak dapat ditemukan dalam katalog, itu tidak akan disertakan dalam koleksi output.

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.

Contoh tanggapan

HTTP/1.1 200 OK
Content-Length: 1021
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
X-Locale: en-US
[
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0039",
        "isRestricted": true,
        "restrictions": [
            {
                "reasonCode": "NotAvailableForSubscription",
                "description": "Restriction identified of type 'Location' with values 'japanwest'.",
                "properties": {
                    "type": "Location",
                    "values": "japanwest"
                }
            }
        ]
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0038",
        "isRestricted": true,
        "restrictions": [
            {
                "reasonCode": "NotAvailableForSubscription",
                "description": "Restriction identified of type 'Location' with values 'japanwest'.",
                "properties": {
                    "type": "Location",
                    "values": "japanwest"
                }
            }
        ]
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "000S",
        "isRestricted": false,
        "restrictions": []
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0011",
        "isRestricted": false,
        "restrictions": []
    }
]

Bagikan melalui