Condividi tramite


Ottenere un prodotto in base all'ID

Ottiene la risorsa del prodotto specificata utilizzando un ID prodotto.

Prerequisiti

  • Credenziali come descritte in Partner Centerautenticazione. Questo scenario supporta l'autenticazione con le credenziali App indipendente e App+Utente.

  • ID prodotto.

C#

Per trovare un prodotto specifico in base all'ID, utilizzare la raccolta IAggregatePartner.Products, selezionare il paese utilizzando il metodo byCountry(), quindi chiamare il metodo ById(). Chiamare infine il metodo Get() o GetAsync() per restituire il prodotto.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

Giava

Per gestire le risorse del Centro per i partner, è possibile usare Java SDK del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. È possibile ottenere assistenza dalla community o aprire un problema in GitHub se si verifica un problema.

Per trovare un prodotto specifico in base all'ID, usare la funzione di IAggregatePartner.getProducts, selezionare il paese usando la funzione byCountry(), quindi chiamare la funzione byId(). Infine, chiamare la funzione get() per restituire il prodotto.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();

PowerShell

Il modulo PowerShell centro per i partner può essere usato per gestire le risorse del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. È possibile ottenere assistenza dalla community o aprire un problema in GitHub se si verifica un problema.

Per trovare un prodotto specifico in base all'ID, eseguire il comando Get-PartnerProduct e specificare il parametro ProductId. Il parametro CountryCode è opzioni, se non viene specificato, verrà usato il paese associato al rivenditore.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

Richiesta REST

Sintassi della richiesta

Metodo URI della richiesta
GET {baseURL}/v1/products/{product-id}?country={country} HTTP/1.1

Parametro URI

Usare i parametri di percorso seguenti per ottenere il prodotto specificato.

Nome Digitare Obbligatorio Descrizione
ID prodotto corda Stringa che identifica il prodotto.
paese corda ID paese/area geografica.

Intestazioni della richiesta

Per altre informazioni, vedere intestazioni REST del Centro per i partner.

Corpo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/products/{product-id}?country=US HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Risposta REST

In caso di esito positivo, il corpo della risposta contiene una risorsa Product.

Codici di errore e esito positivo della risposta

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

Questo metodo restituisce i codici di errore seguenti:

Codice di stato HTTP Codice di errore Descrizione
404 400013 Il prodotto non è stato trovato.

Esempio di risposta per la prenotazione di macchine virtuali di Azure (piano di Azure)

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Tue, 23 Jan 2018 23:13:01 GMT

{
    "id": "DZH318Z0BQ3Q",
    "title": "Virtual Machines DSv2 Series",
    "description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
    "productType": {
        "id": "Azure",
        "displayName": "Azure",
        "subType": {
            "id": "VirtualMachines",
            "displayName": "VirtualMachines"
        }
    },
    "isMicrosoftProduct": true,
    "publisherName": "Microsoft",
    "links": {
        "skus": {
            "uri": "/products/DZH318Z0BQ3Q/skus?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/products/DZH318Z0BQ3Q?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Esempio di risposta per il nuovo prodotto basato su licenza commerciale

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere panoramica delle nuove esperienze commerciali.

{
    "id": "CFQ7TTC0LH18",
    "title": "Microsoft 365 Business Basic",
    "description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
    "productType": {
        "id": "OnlineServicesNCE",
        "displayName": "OnlineServicesNCE"
    },
    "isMicrosoftProduct": true,
    "publisherName": "Microsoft Corporation",
    "links": {
        "skus": {
            "uri": "/products/CFQ7TTC0LH18/skus?country=US",
            "method": "GET",
            "headers": []
        },
        "self": {
        "uri": "/products/CFQ7TTC0LH18?country=US",
            "method": "GET",
            "headers": []
        }
    }
}