Comprobación del inventario por tipo de recurso mediante las API del Centro de partners

Cómo comprobar el inventario de los elementos de catálogo filtrados por un tipo de recurso específico.

Requisitos previos

• Credenciales según se describen en Partner Center authentication. 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 identificadores de SKU.

• Un valor válido resourceType (obligatorio). Consulte Tipos de recursos admitidos para obtener la lista completa de valores aceptados.

• Cualquier contexto adicional necesario para comprobar el inventario de las SKU a las que hace referencia el producto o los identificadores de 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

Parámetros de URI

Use los parámetros de consulta siguientes para comprobar el inventario por tipo de recurso.

Tipos de recurso compatibles

Cabeceras de solicitud

Para obtener más información, consulta Encabezados REST de Partner Center.

Cuerpo de la solicitud

Los detalles de la solicitud de inventario, que constan 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 Azure RIs. 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/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"}}

Respuesta REST

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

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

Contenido relacionado

• Recursos del producto
• Comprobación del inventario
• Registro de una suscripción
• Referencia de la API de REST del Centro de partners