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

C#

Per ottenere un elenco di prodotti:

  1. Usare la raccolta 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();

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:

  1. Usare la funzione IAggregatePartner.getProducts per selezionare il paese usando 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 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:

  1. Eseguire il comando Get-PartnerProduct.

  2. Selezionare il catalogo specificando il parametro Catalog .

  3. (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 ID del paese o dell'area.
targetView string 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"
  }
}