Vérifier l’inventaire des articles de catalogue à l’aide des API de l’Espace partenaires

Comment vérifier l’inventaire pour un ensemble spécifique d’articles de catalogue.

Important

Cette API sera supprimée le 25 septembre 2026. Les partenaires doivent migrer vers la nouvelle API Vérifier l’inventaire par type de ressource , qui fournit un filtrage amélioré par type de ressource.

Conditions préalables

  • Informations d’identification décrites dans l’authentification de l’Espace partenaires. Ce scénario prend en charge l'authentification avec des identifiants d'application autonomes ainsi que des identifiants combinés application+utilisateur.

  • Un ou plusieurs ID de produit. Si vous le souhaitez, vous pouvez également spécifier des ID de SKU.

  • Tout contexte supplémentaire nécessaire pour vérifier l’inventaire des SKU référencés par les ID de produit/SKU fournis. Ces exigences peuvent varier selon le type de produit/SKU et peuvent être déterminées à partir de la propriété InventoryVariablesdu SKU.

Requête REST

Syntaxe de la requête

Méthode URI de la requête
PUBLIER {baseURL}/v1/extensions/product/checkInventory ?country={country-code} HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour vérifier l’inventaire.

Nom Type Obligatoire Descriptif
country-code ficelle Oui Un identifiant de pays/région.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Les détails de la demande de stock, constitués d’une ressource InventoryCheckRequest contenant une ou plusieurs ressources InventoryItem .

Vérifiez que l’abonnement Azure spécifié dans le corps de la requête est inscrit et autorisé à acheter des instances réservées Azure. Voir Enregistrer un abonnement pour plus de détails sur le processus d’inscription.

Exemple de requête

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

Réponse REST

En cas de réussite, le corps de la réponse contient une collection d’objets InventoryItem renseignés avec les détails de la restriction, le cas échéant.

Remarque

Si un InventoryItem d’entrée représente un élément introuvable dans le catalogue, il ne sera pas inclus dans la collection de sortie.

Réussite de la réponse et codes d’erreur

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et les paramètres supplémentaires. Pour la liste complète, consultez les Codes d'erreur du Centre des partenaires.

Exemple de réponse

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": []
    }
]
  • Last updated on