Verifique o inventário por tipo de recurso usando as APIs do Partner Center

Como verificar o inventário para itens de catálogo filtrados por um tipo específico de recurso.

Pré-requisitos

• Credenciais conforme descrito na autenticação no Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

• IDs de produto (opcional). IDs de SKU (opcionais).

• Um valor válido resourceType (obrigatório). Consulte Tipos de recursos suportados para a lista completa de valores aceites.

• Qualquer contexto adicional necessário para verificar o inventário dos SKUs referenciados pelos IDs do produto/SKU fornecidos. Estes requisitos podem variar consoante o tipo de produto/SKU e podem ser determinados a partir da propriedade InventoryVariablesdo SKU.

Pedido de REST

Sintaxe da solicitação

Parâmetros de URI

Use os seguintes parâmetros de consulta para verificar o inventário por tipo de recurso.

Tipos de recursos suportados

Cabeçalhos da requisição

Para mais informações, consulte os cabeçalhos REST do Partner Center .

Corpo da solicitação

Os detalhes do pedido de inventário, consistindo num recurso InventoryCheckRequest contendo um ou mais recursos InventoryItem .

Certifique-se de que a subscrição do Azure especificada no corpo do pedido está registada e ativada para comprar RIs do Azure. Consulte Registar uma Subscrição para detalhes sobre o processo de registo.

TargetItems é opcional. Se o excluires ou definires como null ou [], a resposta inclui todos os itens do tipo de recurso. Se o incluir, a resposta é filtrada para esses IDs de produto. Cada TargetItems entrada deve ter um ProductID não em branco, caso contrário o pedido devolve um 400.

Boas práticas: Passe TargetItems apenas com os IDs de produto necessários para manter as respostas mais pequenas, rápidas e relevantes. Caso contrário, tipos de recursos amplos como as VirtualMachines podem devolver milhares de itens.

Exemplo de solicitação

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

Resposta do REST

Se for bem-sucedido, o corpo da resposta contém uma coleção de objetos InventoryItem preenchidos com os detalhes das restrições, caso existam.

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro do Partner Center.

Exemplo de resposta

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

Produtos não devolvidos em resposta

Se um produto ou SKU estiver disponível para a subscrição e região especificadas, mas estiver sujeito a restrições, a resposta inclui o produto com isRestricted: true e os detalhes da restrição aplicáveis.

Se um produto não estiver disponível para a subscrição e região especificadas, a resposta omite completamente o produto.

Conteúdo relacionado

• Recursos do produto
• Verificar inventário
• Registar uma subscrição
• Referência da API REST do Partner Center