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

• Produkt-IDs (optional). SKU-IDs (optional).

• 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 Anforderungstext angegebene Azure-Abonnement registriert und für den Kauf von Azure-RIs aktiviert ist. Details zum Registrierungsprozess finden Sie unter Registrieren eines Abonnements .

TargetItems ist optional. Wenn Sie es ausschließen oder auf null oder [] festlegen, enthält die Antwort alle Elemente für den Ressourcentyp. Wenn Sie sie einschließen, wird die Antwort auf diese Produkt-IDs gefiltert. Jeder TargetItems Eintrag muss eine nicht leere ProductId aufweisen, oder die Anforderung gibt einen HTTP-400-Fehler zurück.

Bewährte Methode: Übergeben Sie TargetItems nur die Produkt-IDs, die Sie benötigen, um die Antworten kleiner, schneller und relevant zu halten. Andernfalls können breite Ressourcentypen wie VirtualMachines Tausende von Elementen zurückgeben.

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

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

Produkte, die nicht zurückgegeben wurden

Wenn ein Produkt oder eine SKU für das angegebene Abonnement und die angegebene Region verfügbar ist, jedoch Einschränkungen unterliegen, enthält die Antwort das Produkt mit isRestricted: true und die anwendbaren Einschränkungsdetails.

Wenn ein Produkt für das angegebene Abonnement und die angegebene Region nicht verfügbar ist, wird das Produkt vollständig weggelassen.

Verwandte Inhalte

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