Inventaris controleren op resourcetype met behulp van Partnercentrum-API's

De inventaris controleren op catalogusitems die zijn gefilterd op een specifiek resourcetype.

Prerequisites

• Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

• Product-ID’s (optioneel). SKU-ID's (optioneel).

• Een geldige resourceType waarde (vereist). Zie Ondersteunde resourcetypen voor de volledige lijst met geaccepteerde waarden.

• Eventuele aanvullende context die nodig is voor het controleren van de inventaris van de SKU's waarnaar wordt verwezen door de opgegeven product-/SKU-id's. Deze vereisten kunnen variëren per type product/SKU en kunnen worden bepaald op basis van de eigenschap InventoryVariables van de SKU.

REST-aanvraag

Aanvraagsyntaxis

URI Parameters

Gebruik de volgende queryparameters om de inventaris te controleren op resourcetype.

Ondersteunde resourcetypen

Headers aanvragen

Voor meer informatie, zie Partner Center REST headers.

aanvraaginhoud

De details van de inventarisaanvraag, bestaande uit een InventoryCheckRequest-resource die een of meer InventoryItem-resources bevat.

Zorg ervoor dat het Azure-abonnement dat is opgegeven in de aanvraagbody is geregistreerd en is ingeschakeld om Azure RU's aan te schaffen. Zie Een abonnement registreren voor meer informatie over het registratieproces.

TargetItems is een optie. Als u het uitsluit of instelt op null of [], bevat het antwoord alle items voor het resourcetype. Als u deze opneemt, wordt het antwoord op die product-ID's gefilterd. Elke TargetItems vermelding moet een niet-lege ProductId hebben, anders retourneert de aanvraag een 400.

Best practice: Geef TargetItems alleen de product-id's door die u nodig hebt om de antwoorden kleiner, sneller en relevant te houden. Anders kunnen brede resourcetypen, zoals VirtualMachines, duizenden items retourneren.

Vraag om voorbeeld

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

Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling InventoryItem-objecten die zijn gevuld met de beperkingsgegevens, indien van toepassing.

Geslaagde antwoorden en foutcodes

Elke respons bevat een HTTP-statuscode die aangeeft of er sprake is van succes of falen, evenals aanvullende informatie voor foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie foutcodes in Partnercentrum voor de volledige lijst.

Voorbeeld van antwoord

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

Producten die niet zijn geretourneerd als reactie op

Als een product of SKU beschikbaar is voor het opgegeven abonnement en de opgegeven regio, maar onderhevig is aan beperkingen, bevat het antwoord het product met isRestricted: true en de toepasselijke beperkingsgegevens.

Als een product niet beschikbaar is voor het opgegeven abonnement en de opgegeven regio, wordt het product volledig weggelaten.

Verwante inhoud

• Productinformatie
• Inventaris controleren
• Een abonnement registreren
• Partnercentrum REST API-referentie