Überprüfen des Inventars anhand des Ressourcentyps mithilfe von Partner Center-APIs

So überprüfen Sie den Bestand auf Katalogelemente, die nach einem bestimmten Ressourcentyp gefiltert sind.

Voraussetzungen

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

• Eine oder mehrere Produkt-IDs. Optional können auch SKU-IDs angegeben werden.

• Ein gültiger resourceType Wert (erforderlich). Die vollständige Liste der akzeptierten Werte finden Sie unter "Unterstützte Ressourcentypen ".

• Jeder zusätzliche Kontext, der für die Überprüfung des Inventars der SKUs erforderlich ist, auf die von den bereitgestellten Produkt-/SKU-IDs verwiesen wird. Diese Anforderungen können je nach Produkt-/SKU-Typ variieren und anhand der InventoryVariables-Eigenschaft der SKU bestimmt werden.

REST-Anforderung

Anforderungssyntax

URI-Parameter

Verwenden Sie die folgenden Abfrageparameter, um den Bestand nach Ressourcentyp zu überprüfen.

Unterstützte Ressourcentypen

Anfrage-Header

Weitere Informationen finden Sie unter Partner Center REST-Header.

Anforderungstext

Die Bestandsanforderungsdetails, bestehend aus einer InventoryCheckRequest-Ressource , die eine oder mehrere InventoryItem-Ressourcen enthält.

Stellen Sie sicher, dass das im Anforderungshauptteil angegebene Azure-Abonnement registriert und für den Kauf von Azure-Reservierungen aktiviert ist. Details zum Registrierungsprozess finden Sie unter Registrieren eines Abonnements .

Beispielanfrage

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

REST-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext eine Sammlung von InventoryItem-Objekten , die mit den Einschränkungsdetails aufgefüllt sind, falls zutreffend.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-Fehlercodes.

Antwortbeispiel

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

Verwandte Inhalte

• Produktressourcen
• Inventar überprüfen
• Registrieren eines Abonnements
• Partner Center REST-API-Referenz