如何檢查特定目錄項目的庫存。
重要
此 API 將於 2026 年 9 月 25 日退休。 合作夥伴應遷移至新的資源 類型檢查清單 API，該 API 提供更佳的資源類型篩選功能。
先決條件
合作夥伴中心驗證中所述的憑證。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
一或多個產品標識碼。 您也可以選擇指定 SKU 識別碼。
驗證所提供的產品或 SKU ID 參考的 SKU 庫存時需要的其他上下文。 這些需求可能會因產品/SKU 類型而異，而且可以從 SKU 的InventoryVariables 屬性來判斷。
REST 要求
要求語法
| 方法 | 要求 URI |
|---|---|
| 貼文 | {baseURL}/v1/extensions/product/checkInventory？country={country-code} HTTP/1.1 |
URI 參數
使用下列查詢參數來檢查清查。
| 名字 | 類型 | 必填 | 描述 |
|---|---|---|---|
| 國碼 | 字串 | 是的 | 國家/地區標識碼。 |
請求標頭
如需詳細資訊，請參閱 合作夥伴中心 REST 標頭。
請求主體
清查請求詳細信息，其中的 InventoryCheckRequest 資源包含一個或多個 InventoryItem 資源。
請確定要求本文中指定的 Azure 訂用帳戶已註冊並啟用以購買 Azure RI。 如需註冊過程的詳情，請參閱 註冊訂用帳戶。
要求範例
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"}}
REST 回應
如果成功，回應內容會包含一組 InventoryItem 物件，並且會包含適用的限制詳細資料。
備註
如果輸入的 InventoryItem 代表目錄中無法找到的項目，則不會包含在輸出集合中。
回應成功和錯誤碼
每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。 使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。 如需完整清單，請參閱 合作夥伴中心錯誤碼。
回應範例
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": []
}
]