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.

• Identificadores de producto (opcional). Identificadores de SKU (opcional).

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

TargetItems es opcional. Si se excluye o se establece en null o [], la respuesta incluye todos los elementos para el tipo de recurso. Si lo incluye, la respuesta se filtra para mostrar solo esos identificadores de producto. Cada entrada TargetItems debe tener un ProductId no vacío o la solicitud devuelve un error 400.

Procedimiento recomendado: Pase TargetItems solo con los identificadores de producto que necesita para mantener las respuestas más pequeñas, más rápidas y relevantes. De lo contrario, los tipos de recursos amplios, como VirtualMachines, pueden devolver miles de elementos.

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

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

Productos no devueltos en respuesta

Si un producto o SKU está disponible para la suscripción y región especificadas, pero está sujeta a restricciones, la respuesta incluye el producto con isRestricted: true y los detalles de restricción aplicables.

Si un producto no está disponible para la suscripción y región especificadas, la respuesta omite completamente el producto.

Contenido relacionado

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