Controllare l'inventario in base al tipo di risorsa usando le API del Centro per i partner

Come controllare l'inventario per gli elementi del catalogo filtrati in base a un tipo di risorsa specifico.

Prerequisiti

• Credenziali come descritto in Partner Center authentication. Questo scenario supporta l'autenticazione sia con le credenziali di App standalone che con quelle di App+Utente.

• ID prodotto (facoltativi). ID SKU (facoltativi).

• Valore valido resourceType (obbligatorio). Per l'elenco completo dei valori accettati, vedere Tipi di risorse supportati.

• Qualsiasi contesto aggiuntivo necessario per verificare l'inventario degli SKU a cui fanno riferimento gli ID prodotto/SKU forniti. Questi requisiti possono variare in base al tipo di prodotto/SKU e possono essere determinati dalla proprietà InventoryVariablesdello SKU.

Richiesta REST

Sintassi della richiesta

Parametri URI

Usare i parametri di query seguenti per controllare l'inventario in base al tipo di risorsa.

Tipi di risorse supportati

Header di richiesta

Per ulteriori informazioni, vedere Intestazioni delle API REST del Partner Center.

Corpo della richiesta

Dettagli della richiesta di inventario, costituiti da una risorsa InventoryCheckRequest contenente una o più risorse InventoryItem .

Assicurarsi che la sottoscrizione Azure specificata nel corpo della richiesta sia registrata e abilitata per acquistare istanze riservate di Azure. Per informazioni dettagliate sul processo di registrazione, vedere Registrare una sottoscrizione .

TargetItems è facoltativo. Se lo si esclude o lo si imposta su null o [], la risposta include tutti gli elementi per il tipo di risorsa. Se lo includi, la risposta viene filtrata in base a tali ID prodotto. Ogni TargetItems voce deve avere un ProductId non vuoto oppure la richiesta restituisce un errore 400.

Procedura consigliata: Passare TargetItems con solo gli ID prodotto necessari per mantenere le risposte più piccole, veloci e rilevanti. In caso contrario, i tipi di risorse generali, ad esempio VirtualMachines, possono restituire migliaia di elementi.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una raccolta di oggetti InventoryItem popolati con i dettagli delle restrizioni, se applicabili.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedere codici di errore del Partner Center.

Esempio di risposta

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

Prodotti non restituiti in risposta

Se un prodotto o uno SKU è disponibile per la sottoscrizione e l'area specificate, ma è soggetta a restrizioni, la risposta include il prodotto con isRestricted: true e i dettagli delle restrizioni applicabili.

Se un prodotto non è disponibile per la sottoscrizione e l'area specificate, la risposta omette completamente il prodotto.

Contenuti correlati

• Risorse del prodotto
• Controllare l'inventario
• Registrare una sottoscrizione
• informazioni di riferimento sulle API REST del Centro per i partner