Kontrollera inventering efter resurstyp med hjälp av API:er för Partnercenter

Så här kontrollerar du inventeringen för katalogobjekt som filtrerats efter en viss resurstyp.

Förutsättningar

• Autentiseringsuppgifter enligt beskrivningen i Partner Center-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.

• Produkt-ID:n (valfritt). SKU-ID:n (valfria).

• Ett giltigt resourceType värde (krävs). Se Resurstyper som stöds för den fullständiga listan över godkända värden.

• Eventuella ytterligare kontexter som behövs för att verifiera inventeringen av SKU:erna som refereras av de angivna produkt-/SKU-ID:n. Dessa krav kan variera beroende på typ av produkt/SKU och kan fastställas från SKU:nsInventoryVariables-egenskap .

REST-begäran

Begärningssyntax

URI parametrar

Använd följande frågeparametrar för att kontrollera inventeringen efter resurstyp.

Resurstyper som stöds

Förfrågningsrubriker

Mer information finns i REST-huvuden för Partner Center.

Begärandetext

Information om inventeringsbegäran som består av en InventoryCheckRequest-resurs som innehåller en eller flera InventoryItem-resurser .

Kontrollera att den Azure prenumeration som anges i begärandetexten är registrerad och aktiverad för att köpa Azure-RU:er. Mer information om registreringsprocessen finns i Registrera en prenumeration .

TargetItems är valfritt. Om du exkluderar den eller anger den till null eller [] innehåller svaret alla objekt för resurstypen. Om du inkluderar det filtreras svaret till dessa produkt-ID:er. Varje TargetItems post måste ha ett produkt-ID som inte är tomt, eller så returnerar begäran 400.

Bästa praxis: Skicka med TargetItems bara de produkt-ID:n som du behöver för att hålla svaren mindre, snabbare och relevanta. Annars kan breda resurstyper som VirtualMachines returnera tusentals objekt.

Exempel på begäran

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-svar

Om det lyckas innehåller svarstexten en samling InventoryItem-objekt som fyllts i med begränsningsinformationen, om det finns några.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder för Partnercenter.

Svarsexempel

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": []
    }
]

Produkter som inte returneras som svar

Om en produkt eller SKU är tillgänglig för den angivna prenumerationen och regionen men omfattas av begränsningar, innehåller svaret produkten med isRestricted: true och relevant begränsningsinformation.

Om en produkt inte är tillgänglig för den angivna prenumerationen och regionen utelämnar svaret produkten helt.

Relaterat innehåll

• Produktresurser
• Kontrollera lagersaldo
• Registrera en prenumeration
• REST API-referens för Partnercenter