Memeriksa inventaris item katalog menggunakan API Pusat Mitra

Cara memeriksa inventaris untuk kumpulan item katalog tertentu.

Penting

API ini akan dihentikan pada 25 September 2026. Mitra harus bermigrasi ke Periksa inventori baru menurut jenis sumber daya API, yang menyediakan pemfilteran yang ditingkatkan menurut jenis sumber daya.

Prasyarat

  • Detail login sebagaimana dijelaskan pada autentikasi Partner Center. 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 inventaris SKU yang dirujuk oleh ID produk/SKU yang disediakan. Persyaratan ini mungkin berbeda menurut jenis produk/SKU dan dapat ditentukan dari properti InventoryVariablesSKU.

Permintaan layanan REST

Sintaksis permintaan

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

Parameter di URI

Gunakan parameter kueri berikut untuk memeriksa inventaris.

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

Tajuk permintaan

Untuk informasi selengkapnya, lihat REST header di Partner Center.

Isi dari permintaan

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

Pastikan Langganan Azure yang ditentukan dalam isi permintaan telah terdaftar dan diaktifkan agar dapat membeli Azure RI. Lihat Daftar Langganan untuk detail tentang proses pendaftaran.

Permintaan contoh

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
Content-Type: application/json

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

Respons terhadap REST

Jika berhasil, isi respons berisi kumpulan objek InventoryItem yang diisi dengan detail pembatasan, jika ada yang berlaku.

Nota

Jika InventoryItem input mewakili item yang tidak dapat ditemukan di katalog, item tersebut 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, silakan lihat kode kesalahan di Partner Center.

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": []
    }
]
  • Last updated on