Condividi tramite

Ottenere un elenco di prodotti (per paese/area geografica)

  • Articolo

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 come descritto in Partner Center authentication. Questo scenario supporta l'autenticazione con le credenziali App autonome e App+Utente.

  • Paese/area geografica.

C#

Per ottenere un elenco di prodotti:

  1. Usare la raccolta di IAggregatePartner.Products per selezionare il paese o l'area geografica usando il metodo ByCountry().

  2. Selezionare la vista del catalogo usando il metodo ByTargetView().

  3. (Facoltativo) Selezionare l'ambito della prenotazione usando il metodo ByReservationScope().

  4. (Facoltativo) Selezionare il segmento di destinazione usando il metodo ByTargetSegment().

  5. 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();

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 ottenere un elenco di prodotti:

  1. Usare la funzione IAggregatePartner.getProducts per selezionare il paese tramite la funzione byCountry().

  2. Selezionare la vista del catalogo usando la funzione byTargetView().

  3. (Facoltativo) Selezionare il segmento di destinazione usando la funzione byTargetSegment().

  4. 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 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 ottenere un elenco di prodotti:

  1. Eseguire il comando Get-PartnerProduct.

  2. Selezionare il catalogo specificando il parametro Catalog.

  3. (Facoltativo) Selezionare il segmento di destinazione specificando il parametro segmento.

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 Digitare Obbligatorio Descrizione
paese corda Sì ID paese/area geografica.
targetView corda 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 di prenotazione delle 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 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 i componenti software

SoftwareSUSELinux, che include tutti gli elementi software SUSE Linux

SoftwarePerpetual, che include tutti gli elementi software perpetui

SoftwareSubscriptions, che includono tutti gli elementi degli abbonamenti software

SpecializedOffers, che include offerte specializzate rese disponibili ad alcuni partner

MarketplaceSaaS, che include tutte le offerte del marketplace commerciale pubblicate dai fornitori di software indipendenti (ISV)
segmento di destinazione corda No Identifica il segmento di destinazione. Visualizzazione per gruppi di destinatari diversi. I valori supportati sono:

commerciale
istruzione
governo
senza scopo di lucro
ambito della prenotazione corda 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 della richiesta

Per ulteriori informazioni, consultare le intestazioni REST del Centro partner.

Corpo 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 (VM) di Azure per abbonamenti 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 panoramica delle nuove esperienze commerciali.

Segui questo esempio per ottenere un elenco di prodotti per paese per i servizi basati su licenza della nuova esperienza di commercio nella versione di anteprima tecnica. I nuovi servizi basati sulle licenze commerciali verranno identificati dai valori ID e 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 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 Partner Center.

Questo metodo restituisce i codici di errore seguenti:

Codice di stato HTTP Codice di errore Descrizione
403 400030 L'accesso al targetSegment richiesto 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 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"
  }
}