Verificar inventário por tipo de recurso usando APIs do Partner Center

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

Pré-requisitos

  • Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

  • Uma ou mais IDs de produto. Opcionalmente, as IDs de SKU também podem ser especificadas.

  • Um valor válido resourceType (obrigatório). Consulte os tipos de recursos com suporte para obter a lista completa de valores aceitos.

  • Qualquer contexto adicional necessário para verificar o inventário das SKUs referenciadas pelas IDs de produto/SKU fornecidas. Esses requisitos podem variar de acordo com o tipo de produto/SKU e podem ser determinados na propriedade InventoryVariablesda SKU.

Solicitação REST

Sintaxe da solicitação

Método URI de solicitação
POST {baseURL}/v1/extensions/product/checkinventorybyresourcetype?country={country-code}&resourceType={resourceTypeValue} HTTP/1.1

Parâmetros de URI

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

Name Tipo Required Description
código do país cadeia Yes Um ID de país/região.
resourceTypeValue cadeia Yes O tipo de recurso para filtrar os resultados do inventário. Consulte os tipos de recursos com suporte para valores válidos.

Tipos de recursos suportados

Valor do tipo de recurso Description
AppService Serviço de Aplicativo
Avs Solução VMware no Azure
AzureDataExplorer Azure Data Explorer
AzureFiles Arquivos do Azure
Backup Backup do Azure
BlockBlob Armazenamento de Blobs em Blocos
CopilotCredit Crédito Copilot
CosmosDb Azure Cosmos DB
Databricks Azure Databricks
DataFactory Azure Data Factory
Anfitrião Dedicado Host Dedicado do Azure
FabricCapacity Capacidade do Microsoft Fabric
FoundryAgent Agente do Foundry
ManagedDisk Azure Managed Disk
MariaDB Banco de Dados do Azure para MariaDB
MDC Microsoft Defender para Nuvem
MySql Banco de Dados do Azure para MySQL
Nutanix Nutanix
OpenAIPTU Azure OpenAI PTU
PostgreSQL Banco de Dados do Azure para PostgreSQL
RedHat Red Hat
RedHatOsa Red Hat OpenShift no Azure
RedisCache Cache do Azure para Redis
SapHana SAP HANA no Azure
Sentinel Microsoft Sentinel
SqlDatabases Bancos de Dados SQL do Azure
SqlDataWarehouse SQL Data Warehouse do Azure
SuseLinux SUSE Linux
Synapse Azure Synapse Analytics
Máquinas Virtuais Máquinas Virtuais do Azure
VMwareCloudSimple VMware CloudSimple

Cabeçalhos de solicitação

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

Corpo da solicitação

Os detalhes da solicitação de inventário, que consistem em um recurso InventoryCheckRequest contendo um ou mais recursos InventoryItem .

Verifique se a assinatura de Azure especificada no corpo da solicitação está registrada e habilitada para comprar Azure RIs. Consulte Registrar uma Assinatura para obter detalhes sobre o processo de registro.

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

Resposta REST

Se tiver êxito, o corpo da resposta conterá uma coleção de objetos InventoryItem preenchidos com os detalhes da restrição, se houver aplicação.

Note

Se um InventoryItem de entrada representar um item que não pôde ser encontrado no catálogo ou não corresponder ao tipo de recurso especificado, ele não será incluído na coleção de saída.

Códigos de erro e êxito de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os 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 retornados em resposta

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

Se um produto não estiver disponível para a assinatura e a região especificadas, a resposta omite totalmente o produto.

Importante

Trate um produto ausente da resposta como indisponível apenas para a assinatura e a região especificadas.

Scenario Resposta de CheckInventoryByResourceType
Produto não disponível para assinatura/região Produto omitido da resposta
SKU disponível isRestricted: false
SKU restrita na região Retornado com isRestricted: true

Conteúdo relacionado

  • Last updated on