Kontrola inventáře podle typu prostředku pomocí rozhraní API Partnerského centra

Postup kontroly inventáře položek katalogu filtrovaných podle konkrétního typu prostředku

Předpoklady

  • Přihlašovací údaje, jak jsou popsány v ověřování v Centru pro partnery. Tento scénář podporuje autentizaci pomocí samostatných přihlašovacích údajů aplikace i kombinovaných přihlašovacích údajů aplikace a uživatele.

  • Jedno nebo více ID produktů. Volitelně je možné zadat také ID skladových položek.

  • Platná resourceType hodnota (povinné). Úplný seznam přijatých hodnot najdete v části Podporované typy prostředků .

  • Veškeré další kontexty potřebné k ověření inventáře skladových položek, na které odkazují poskytnuté ID produktů nebo skladových položek. Tyto požadavky se mohou lišit podle typu produktu nebo skladové položky a lze je určit z vlastnosti InventoryVariablesskladové položky.

Požadavek REST

Syntaxe požadavku

Metoda Požadavek na URI
POST {baseURL}/v1/extensions/product/checkinventorybyresourcetype?country={country-code}&resourceType={resourceTypeValue} HTTP/1.1

Parametry identifikátoru URI

Pomocí následujících parametrů dotazu zkontrolujte inventář podle typu prostředku.

Name Typ Required Description
kód země řetězec Ano ID země/oblasti.
resourceTypeValue řetězec Ano Typ prostředku pro filtrování výsledků inventáře. Platné hodnoty najdete v části Podporované typy prostředků.

Podporované typy prostředků

Hodnota typu prostředku Description
AppService Aplikační služba
Avs Řešení Azure VMware
AzureDataExplorer Azure Data Explorer
AzureFiles Azure Files
Backup Azure Backup
BlockBlob Blokovat Blob Storage
CopilotCredit Kredit Copilotu
CosmosDb Azure Cosmos DB
Databricks Azure Databricks
DataFactory Azure Data Factory
DedicatedHost Azure Dedicated Host
Kapacita Fabricu kapacita Microsoft Fabric
FoundryAgent Foundry Agent
ManagedDisk spravovaný disk Azure
MariaDB Azure Database for MariaDB
MDC Microsoft Defender for Cloud
MySQL Azure Database for MySQL
Nutanix Nutanix
OpenAIPTU Azure OpenAI PTU
PostgreSQL Azure Database for PostgreSQL
RedHat Red Hat
RedHatOsa Red Hat OpenShift na Azure
RedisCache Azure Cache for Redis
SapHana SAP HANA na Azure
Sentinel Microsoft Sentinel
SqlDatabases databáze Azure SQL
SqlDataWarehouse Azure SQL Data Warehouse
SuseLinux SUSE Linux
Synapse Azure Synapse Analytics
Virtuální počítače Azure Virtual Machines
VMwareCloudSimple VMware CloudSimple

Hlavičky žádosti

Pro více informací se podívejte na hlavičky REST Partnerského centra .

Text požadavku

Podrobnosti požadavku na kontrolu inventáře tvoří prostředek InventoryCheckRequest obsahující jeden nebo více prostředků InventoryItem.

Ujistěte se, že předplatné Azure zadané v těle požadavku je zaregistrované a povolené k nákupu rezervovaných instancí Azure. Podrobnosti o procesu registrace najdete v části Registrace předplatného .

Požadavek příkladu

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

Odpověď REST

V případě úspěchu text odpovědi obsahuje kolekci objektů InventoryItem naplněných podrobnostmi o omezení, pokud se nějaké použijí.

Note

Pokud vstupní InventoryItem představuje položku, která nebyla nalezena v katalogu nebo neodpovídá zadanému typu prostředku, nebude zahrnuta do výstupní kolekce.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Pro úplný seznam se podívejte na chybové kódy Partnerského centra.

Příklad odpovědi

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

Produkty nevrácené v odpovědi

Pokud je produkt nebo SKU k dispozici pro zadané předplatné a oblast, ale podléhá omezením, odpověď obsahuje produkt spolu s isRestricted: true a podrobnostmi o příslušných omezeních.

Pokud produkt není k dispozici pro zadané předplatné a oblast, odpověď tento produkt zcela vynechá.

Important

Produkt, který v odpovědi chybí, považujte za nedostupný pouze pro zadané předplatné a region.

Scenario Odpověď na CheckInventoryByResourceType
Produkt není k dispozici pro předplatné nebo oblast Produkt vynechaný z odpovědi
Skladová položka k dispozici isRestricted: false
Skladová položka omezená v oblasti Vráceno pomocí isRestricted: true

Související obsah

  • Last updated on