Comprobación del inventario de elementos del catálogo mediante las API del Centro de partners

Cómo comprobar el inventario de un conjunto específico de artículos del catálogo.

Importante

Esta API se retirará el 25 de septiembre de 2026. Los asociados deben migrar al nuevo Inventario de comprobación por tipo de recurso API, que proporciona un filtrado mejorado por tipo de recurso.

Prerrequisitos

  • Credenciales tal como se describe en Autenticación del Centro de asociados. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.

  • Uno o varios identificadores de producto. Opcionalmente, también se pueden especificar los ID de SKU.

  • Cualquier contexto adicional necesario para verificar el inventario de los SKU a los que hacen referencia los ID de producto/SKU proporcionados. Estos requisitos pueden variar según el tipo de producto o SKU y se pueden determinar a partir de la propiedad InventoryVariablesde la SKU.

Solicitud REST

Sintaxis de la solicitud

Método Solicitud de URI
POST {baseURL}/v1/extensions/product/checkInventory?country={country-code} HTTP/1.1

Parámetro de URI

Utilice el siguiente parámetro de consulta para comprobar el inventario.

Nombre Tipo Obligatorio Descripción
código de país cuerda / cadena Sí Un ID de país o región.

Encabezados de solicitud

Para más información, consulte Encabezados REST del Centro de partners.

Cuerpo de la solicitud

Los detalles de la solicitud de inventario, que consta de un recurso InventoryCheckRequest que contiene uno o varios recursos InventoryItem .

Asegúrese de que la suscripción de Azure especificada en el cuerpo de la solicitud está registrada y habilitada para comprar las RI de Azure. Consulte Registrar una suscripción para obtener más información sobre el proceso de registro.

Ejemplo de solicitud

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

Respuesta REST

Si se realiza correctamente, el cuerpo de la respuesta contiene una colección de objetos InventoryItem rellenados con los detalles de restricción, si se aplica alguno.

Nota:

Si un InventoryItem de entrada representa un artículo que no se pudo encontrar en el catálogo, no se incluirá en la colección de salida.

Códigos de éxito y de error de la respuesta

Cada respuesta incluye un código de estado HTTP que indica el éxito o error y la información adicional de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y parámetros adicionales. Para obtener la lista completa, consulte Códigos de error del Centro de partners.

Ejemplo de respuesta

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