De inventaris van catalogusitems controleren met behulp van Partnercentrum-API's

De inventaris controleren op een specifieke set catalogusitems.

Voorwaarden

• Referenties zoals beschreven in Partnercentrum-verificatie. 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.

• 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 SKU'sInventoryVariables eigenschap.

REST-aanvraag

Aanvraagsyntaxis

URI-parameter

Gebruik de volgende queryparameter om de inventaris te controleren.

Aanvraagkoppen

Zie Partnercentrum REST-headersvoor meer informatie.

Verzoeklichaam

De details van de inventarisaanvraag, bestaande uit een InventoryCheckRequest bron met een of meer InventoryItem bronnen.

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

Voorbeeld van aanvraag

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

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

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of de aanvraag is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partnercentrum-foutcodesvoor 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": 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": []
    }
]