Delen via

Een lijst met producten ophalen (per land/regio)

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

U kunt de volgende methoden gebruiken om een verzameling producten op te halen die beschikbaar zijn in een bepaald land/bepaalde regio.

Vereisten

  • Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.

  • Een land/regio.

C#

Een lijst met producten ophalen:

  1. Gebruik uw verzameling IAggregatePartner.Products om het land/de regio te selecteren met behulp van de methode ByCountry().

  2. Selecteer de catalogusweergave met behulp van de methode ByTargetView().

  3. (Optioneel) Selecteer het reserveringsbereik met behulp van de methode ByReservationScope().

  4. (Optioneel) Selecteer het doelsegment met behulp van de methode ByTargetSegment().

  5. Roep de methode Get() of GetAsync() aan om de verzameling te retourneren.

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

De Partner Center Java SDK kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Een lijst met producten ophalen:

  1. Gebruik de functie IAggregatePartner.getProducts om het land te selecteren met behulp van de functie byCountry().

  2. Selecteer de catalogusweergave met behulp van de functie byTargetView().

  3. (Optioneel) Selecteer het doelsegment met behulp van de functie byTargetSegment().

  4. Roep de functie get() aan om de verzameling te retourneren.

// 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

De PowerShell-module partnercentrum kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.

Een lijst met producten ophalen:

  1. Voer de opdracht Get-PartnerProduct uit.

  2. Selecteer de catalogus door de catalogusparameter op te geven.

  3. (Optioneel) Selecteer het doelsegment door de parameter Segment op te geven.

Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'

REST-aanvraag

Aanvraagsyntaxis

Wijze Aanvraag-URI
GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

URI-parameters

Gebruik het volgende pad en de queryparameters om een lijst met producten op te halen.

Name Type Vereist Beschrijving
land tekenreeks Ja De land-/regio-id.
targetView tekenreeks Ja Identificeert de doelweergave van de catalogus. De ondersteunde waarden zijn:

Azure, dat alle Azure-items bevat

AzureReservations, inclusief alle Azure-reserveringsitems

AzureReservationsVM, inclusief alle reserveringsitems voor virtuele machines (VM's)

AzureReservationsSQL, dat alle SQL-reserveringsitems bevat

AzureReservationsCosmosDb, dat alle cosmos-databasereserveringsitems bevat

MicrosoftAzure, dat items bevat voor Microsoft Azure-abonnementen (MS-AZR-0145P) en Azure-abonnementen

OnlineServices, waaronder alle onlineservice-items, zoals traditionele licentieservices en nieuwe handelslicentieservices.

Software, die alle software-items bevat

SoftwareSUSELinux, inclusief alle software-SUSE Linux-items

SoftwarePerpetual, inclusief alle eeuwigdurende software-items

SoftwareSubscriptions, inclusief alle items voor softwareabonnementen

SpecializedOffers, waaronder gespecialiseerde aanbiedingen die beschikbaar zijn gesteld aan sommige partners

MarketplaceSaaS, inclusief alle commerciële marketplace-aanbiedingen die zijn gepubliceerd door Onafhankelijke SoftwareLeveranciers (ISV's)
targetSegment tekenreeks Nee Identificeert het doelsegment. De weergave voor verschillende doelgroepen. De ondersteunde waarden zijn:

commercieel
onderwijs
regering
Non-profit
reservationScope tekenreeks Nee Wanneer u een query uitvoert op een lijst met producten voor Azure Reservations, geeft u reservationScope=AzurePlan een lijst op met producten die van toepassing zijn op Azure-abonnementen. Sluit deze parameter uit om een lijst met producten voor Azure-reserveringen op te halen, die van toepassing zijn op Microsoft Azure-abonnementen (MS-AZR-0145P).

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Voorbeelden van aanvragen

Producten per land

Volg dit voorbeeld voor een lijst met producten per land voor Microsoft Azure-abonnementen (MS-AZR-0145P) en Azure-abonnementen.

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

Azure VM-reserveringen (Azure-abonnement)

Volg dit voorbeeld om een lijst met producten per land op te halen voor Azure VM-reserveringen die van toepassing zijn op Azure-abonnementen.

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

Azure VM-reserveringen voor Microsoft Azure-abonnementen (MS-AZR-0145P)

Volg dit voorbeeld voor een lijst met producten per land voor Azure VM-reserveringen die van toepassing zijn op Microsoft Azure-abonnementen (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

Nieuwe op handelslicenties gebaseerde services

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.

Volg dit voorbeeld om een lijst met producten per land op te halen voor services op basis van nieuwe commercelicenties als onderdeel van de technische preview van de nieuwe commerce-ervaring. Nieuwe commercelicentieservices worden geïdentificeerd door id- en displayNames-waarden van OnlineServicesNCE. Zie het onderstaande antwoordvoorbeeld.

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

REST-antwoord

Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling productbronnen.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie foutcodes in Partnercentrum voor de volledige lijst.

Deze methode retourneert de volgende foutcodes:

HTTP-statuscode Foutcode Beschrijving
403 400030 Toegang tot het aangevraagde targetSegment is niet toegestaan.
403 400036 Toegang tot de aangevraagde targetView is niet toegestaan.

Antwoordvoorbeeld voor Azure VM-reserveringen (Azure-abonnement)

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

Antwoordvoorbeeld voor nieuwe commercelicentieservices

Notitie

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.

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