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.

• Een of meer product-id's. U kunt desgewenst ook SKU-id's opgeven.

• 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.

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":"Europe"}}

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