Een lijst met producten ophalen (per land/regio)
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:
Gebruik uw verzameling IAggregatePartner.Products om het land/de regio te selecteren met behulp van de methode ByCountry().
Selecteer de catalogusweergave met behulp van de methode ByTargetView().
(Optioneel) Selecteer het reserveringsbereik met behulp van de methode ByReservationScope().
(Optioneel) Selecteer het doelsegment met behulp van de methode ByTargetSegment().
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:
Gebruik de functie IAggregatePartner.getProducts om het land te selecteren met behulp van de functie byCountry().
Selecteer de catalogusweergave met behulp van de functie byTargetView().
(Optioneel) Selecteer het doelsegment met behulp van de functie byTargetSegment().
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:
Voer de opdracht Get-PartnerProduct uit.
Selecteer de catalogus door de catalogusparameter op te geven.
(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: Commerciële 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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"
}
}
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor