利用合作夥伴中心 API 依資源類型檢查庫存

如何檢查庫存中以特定資源類型篩選的目錄項目。

先決條件

  • 合作夥伴中心身份驗證中所述的憑證。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。

  • 產品識別碼（選填）。 SKU IDs（可選）。

  • 有效 resourceType 值（必填）。 完整接受值清單請參閱 支援資源類型 。

  • 驗證由所提供的產品/SKU ID 所指涉之 SKU 庫存時所需的任何其他相關背景資訊。 這些要求可能因產品類型或 SKU 而異，並可從 SKU 的InventoryVariables 屬性中確定。

REST 要求

請求語法

方法 要求 URI
貼文 {baseURL}/v1/extensions/product/checkinventorybyresourcetype？country={country-code}&resourceType={resourceTypeValue} HTTP/1.1

URI 參數

請使用以下查詢參數依資源類型檢查庫存。

Name 類型 Required Description
國家代碼 字串 是的 國家/地區標識碼。
resourceTypeValue 字串 是的 篩選庫存結果的資源類型。 請參閱 支援資源類型 以獲取有效值。

支援的資源類型

資源類型值 Description 地區為必填嗎？
AppService App Service 是的
Avs Azure VMware 解決方案 是的
AzureDataExplorer Azure Data Explorer 否——排除區域，以避免出現 400 錯誤請求錯誤
AzureFiles Azure 檔案儲存體 是的
備份 Azure 備份 是的
BlockBlob 區塊 Blob 儲存體 是的
Copilot 點數 Copilot 點數 否——排除區域，以避免出現 400 Bad Request 錯誤
CosmosDb Azure Cosmos DB 否——排除區域，以避免出現 400 錯誤請求錯誤
Databricks Azure Databricks 否——排除區域，以避免出現 400 錯誤請求錯誤
DataFactory Azure Data Factory 是的
專屬主機 Azure 專用主機 是的
布料容量 Microsoft Fabric 容量 是的
FoundryAgent 鑄造代理 否——排除區域，以避免出現 400 錯誤要求錯誤
GitHubAICredit GitHub AI 額度 否——排除區域，以避免出現 400 Bad Request 錯誤
GitHubP3 GitHub P3 否——排除區域，以避免出現 400 錯誤請求錯誤
ManagedDisk Azure Managed Disk 是的
MariaDB 適用於 MariaDB 的 Azure 資料庫 是的
MDC 適用於雲端的 Microsoft Defender 否——排除區域，以避免出現 400 錯誤請求錯誤
MySql 適用於 MySQL 的 Azure 資料庫 是的
NetAppStorage Azure NetApp Files 是的
Nutanix Nutanix 是的
OpenAIPTU Azure OpenAI PTU 是的
PostgreSql 適用於 PostgreSQL 的 Azure 資料庫 是的
RedHat 紅帽 否——排除區域，以避免出現 400 錯誤請求錯誤
RedHatOsa Red Hat OpenShift on Azure 否——排除區域，以避免出現 400 錯誤請求錯誤
RedisCache Azure Cache for Redis 是的
SapHana SAP Hana on Azure 是的
Sentinel Microsoft Sentinel 否——排除區域，以避免出現 400 錯誤請求錯誤
SqlDatabases Azure SQL 資料庫 是的
SqlDataWarehouse Azure SQL 資料倉儲 是的
SuseLinux SUSE Linux 否——排除區域，以避免出現 400 Bad Request 錯誤
Synapse Azure Synapse Analytics 否——排除區域，以避免出現 400 錯誤請求錯誤
VirtualMachines Azure 虛擬機器 是的
VMwareCloudSimple VMware CloudSimple 是的

請求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

請求主體

庫存請求詳細資料，由一個 InventoryCheckRequest 資源組成，其中包含一個或多個 InventoryItem 資源。

請確保請求文中指定的 Azure 訂閱已註冊並啟用，才能購買 Azure RI。 有關註冊流程詳情，請參閱 「註冊訂閱 」。

TargetItems 是選擇性的。 如果你排除它或設為 null 或 []，回應會包含該資源類型的所有項目。 如果你包含它，回應會篩選為僅包含那些產品 ID。 每個 TargetItems 項目必須有非空白的 ProductId，否則請求會回傳 400。

最佳實務： 只傳入你需要的產品 ID TargetItems，這樣回應會更小、更快速且更具相關性。 否則，像虛擬機這類廣泛的資源類型可能會回傳數千個項目。

範例請求

POST https://api.partnercenter.microsoft.com/v1/extensions/product/checkinventorybyresourcetype?country=US&resourceType=VirtualMachines 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":"westeurope"}}

REST 響應

若成功，回應實體包含一組 InventoryItem 物件，並填充限制細節（若適用）。

Note

若輸入的 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": false,
        "restrictions": []
    }
]

未回傳的產品

若產品或SKU在指定訂閱及地區可用，但受限制，回應中包含該產品 isRestricted: true 及適用的限制細節。

如果某產品在指定的訂閱和地區無法取得，回應則會完全省略該產品。

Important

將回應中缺少的產品僅視為在指定的訂閱方案和地區不可用。

Scenario CheckInventoryByResourceType 回應
產品不支援訂閱/地區 回應中省略產品
可用的 SKU isRestricted: false
SKU 受區域限制 隨附 isRestricted: true 一併返回

相關內容

  • 上次更新時間：