Ottenere un elenco di prodotti (per paese/area geografica)
Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti
È possibile utilizzare i metodi seguenti per ottenere una raccolta di prodotti disponibili in un determinato paese/area geografica.
Prerequisiti
Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
Paese/area geografica.
C#
Per ottenere un elenco di prodotti:
Usare la raccolta IAggregatePartner.Products per selezionare il paese o l'area geografica usando il metodo ByCountry().
Selezionare la vista del catalogo usando il metodo ByTargetView().
(Facoltativo) Selezionare l'ambito della prenotazione usando il metodo ByReservationScope().
(Facoltativo) Selezionare il segmento di destinazione usando il metodo ByTargetSegment().
Chiamare il metodo Get() o GetAsync() per restituire la raccolta.
IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();
// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();
// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();
Java
L'SDK Java del 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. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.
Per ottenere un elenco di prodotti:
Usare la funzione IAggregatePartner.getProducts per selezionare il paese usando la funzione byCountry().
Selezionare la vista del catalogo usando la funzione byTargetView().
(Facoltativo) Selezionare il segmento di destinazione usando la funzione byTargetSegment().
Chiamare la funzione get() per restituire la raccolta.
// IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();
PowerShell
Il modulo PowerShell del 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. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.
Per ottenere un elenco di prodotti:
Eseguire il comando Get-PartnerProduct.
Selezionare il catalogo specificando il parametro Catalog .
(Facoltativo) Selezionare il segmento di destinazione specificando il parametro Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
Richiesta REST
Sintassi della richiesta
metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
Parametri URI
Usare il percorso e i parametri di query seguenti per ottenere un elenco di prodotti.
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
country | string | Sì | ID del paese o dell'area. |
targetView | string | Sì | Identifica la visualizzazione di destinazione del catalogo. I valori supportati sono: Azure, che include tutti gli elementi di Azure AzureReservations, che include tutti gli elementi della prenotazione di Azure AzureReservationsVM, che include tutti gli elementi della prenotazione di macchine virtuali (VM) AzureReservationsSQL, che include tutti gli elementi della prenotazione SQL AzureReservationsCosmosDb, che include tutti gli elementi della prenotazione del database Cosmos MicrosoftAzure, che include gli elementi per le sottoscrizioni di Microsoft Azure (MS-AZR-0145P) e i piani di Azure OnlineServices, che include tutti gli elementi del servizio online, ad esempio i servizi tradizionali basati su licenze e i nuovi servizi basati sulle licenze commerciali. Software, che include tutti gli elementi software SoftwareSUSELinux, che include tutti gli elementi software SUSE Linux SoftwarePerpetual, che include tutti gli elementi software perpetui SoftwareSubscriptions, che include tutti gli elementi della sottoscrizione software SpecializedOffers, che include offerte specializzate che sono state rese disponibili ad alcuni partner MarketplaceSaaS, che include tutte le offerte del marketplace commerciale pubblicate dai fornitori di software indipendenti (ISV) |
targetSegment | string | No | Identifica il segmento di destinazione. Visualizzazione per gruppi di destinatari diversi. I valori supportati sono: commerciale educazione governo no profit |
reservationScope | string | No | Quando si esegue una query per un elenco di prodotti per prenotazioni di Azure, specificare reservationScope=AzurePlan per ottenere un elenco di prodotti applicabili ai piani di Azure. Escludere questo parametro per ottenere un elenco di prodotti per le prenotazioni di Azure, applicabili alle sottoscrizioni di Microsoft Azure (MS-AZR-0145P). |
Intestazioni delle richieste
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Testo della richiesta
Nessuno.
Esempi di richiesta
Prodotti per paese
Seguire questo esempio per ottenere un elenco di prodotti per paese per le sottoscrizioni e i piani di Azure (MS-AZR-0145P).
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Prenotazioni di macchine virtuali di Azure (piano di Azure)
Seguire questo esempio per ottenere un elenco di prodotti per paese per le prenotazioni di macchine virtuali di Azure applicabili ai piani di Azure.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Prenotazioni di macchine virtuali di Azure per le sottoscrizioni di Microsoft Azure (MS-AZR-0145P)
Seguire questo esempio per ottenere un elenco di prodotti per paese per le prenotazioni di macchine virtuali di Azure applicabili alle sottoscrizioni di Microsoft Azure (MS-AZR-0145P).
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Nuovi servizi basati su licenze commerciali
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 la panoramica delle nuove esperienze commerciali.
Seguire questo esempio per ottenere un elenco di prodotti per paese per i nuovi servizi basati sulle licenze commerciali come parte della nuova esperienza commerciale Technical Preview. I nuovi servizi basati sulle licenze commerciali verranno identificati in base all'ID e ai valori displayNames di OnlineServicesNCE. Vedere l'esempio di risposta seguente.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices 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 raccolta di risorse Product.
Codici di errore e di esito della risposta
Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. 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 Centro per i partner.
Questo metodo restituisce i codici di errore seguenti:
Codice di stato HTTP | Codice errore | Descrizione |
---|---|---|
403 | 400030 | L'accesso alla destinazione richiestaSegment non è consentito. |
403 | 400036 | L'accesso a targetView richiesto non è consentito. |
Esempio di risposta per le prenotazioni di macchine virtuali di Azure (piano di Azure)
{
"totalCount": 19,
"items": [
{
"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": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=Azure",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Esempio di risposta per i nuovi servizi basati 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 la panoramica delle nuove esperienze commerciali.
{
"totalCount": 19,
"items": [{
"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": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=OnlineServices",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}