Hämta en lista över produkter (efter land/region)
Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
Du kan använda följande metoder för att hämta en samling produkter som är tillgängliga i ett visst land/en viss region.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett land/en region.
C#
Så här hämtar du en lista över produkter:
Använd samlingen IAggregatePartner.Products för att välja land/region med hjälp av metoden ByCountry().
Välj katalogvyn med hjälp av metoden ByTargetView().
(Valfritt) Välj reservationsomfånget med hjälp av metoden ByReservationScope().
(Valfritt) Välj målsegmentet med hjälp av metoden ByTargetSegment().
Anropa metoden Get() eller GetAsync() för att returnera samlingen.
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
Java SDK för Partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.
Så här hämtar du en lista över produkter:
Använd funktionen IAggregatePartner.getProducts för att välja land med hjälp av funktionen byCountry().
Välj katalogvyn med hjälp av funktionen byTargetView().
(Valfritt) Välj målsegmentet med hjälp av funktionen byTargetSegment().
Anropa funktionen get() för att returnera samlingen.
// 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
PowerShell-modulen partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.
Så här hämtar du en lista över produkter:
Välj katalogen genom att ange parametern Katalog .
(Valfritt) Välj målsegmentet genom att ange parametern Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
REST-begäran
Syntax för begäran
| Metod | URI för förfrågan |
|---|---|
| GET | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
URI-parametrar
Använd följande sökväg och frågeparametrar för att hämta en lista över produkter.
| Namn | Typ | Obligatoriskt | Beskrivning |
|---|---|---|---|
| land | string | Ja | Lands-/region-ID. |
| targetView | sträng | Ja | Identifierar katalogens målvy. De värden som stöds är: Azure, som innehåller alla Azure-objekt AzureReservations, som innehåller alla Azure-reservationsobjekt AzureReservationsVM, som innehåller alla reservationsobjekt för virtuella datorer (VM) AzureReservationsSQL, som innehåller alla SQL-reservationsobjekt AzureReservationsCosmosDb, som innehåller alla Cosmos-databasreservationsobjekt MicrosoftAzure, som innehåller objekt för Microsoft Azure-prenumerationer (MS-AZR-0145P) och Azure-abonnemang OnlineServices, som innehåller alla onlinetjänstobjekt som traditionella licensbaserade tjänster och nya handelslicensbaserade tjänster. Programvara, som innehåller alla programvaruobjekt SoftwareSUSELinux, som innehåller alla SUSE Linux-objekt för programvara SoftwarePerpetual, som innehåller alla eviga programvaruobjekt SoftwareSubscriptions, som innehåller alla programprenumerationsobjekt SpecializedOffers, som inkluderar specialiserade erbjudanden som har gjorts tillgängliga för vissa partner MarketplaceSaaS, som innehåller alla erbjudanden på den kommersiella marknadsplatsen som publicerats av oberoende programvaruleverantörer (ISV:er) |
| targetSegment | sträng | Nej | Identifierar målsegmentet. Vyn för olika målgrupper. De värden som stöds är: Kommersiella Utbildning Regeringen Ideell |
| reservationScope | sträng | Nej | När du frågar efter en lista över produkter för Azure-reservationer anger du reservationScope=AzurePlan för att hämta en lista över produkter som är tillämpliga på Azure-planer. Undanta den här parametern för att hämta en lista över produkter för Azure-reservationer, som gäller för Microsoft Azure-prenumerationer (MS-AZR-0145P). |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Inga.
Exempel på begäran
Produkter efter land
Följ det här exemplet för att hämta en lista över produkter per land för Microsoft Azure-prenumerationer (MS-AZR-0145P) och Azure-planer.
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-reservationer (Azure-plan)
Följ det här exemplet för att hämta en lista över produkter per land för azure VM-reservationer som gäller för Azure-planer.
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-reservationer för Microsoft Azure-prenumerationer (MS-AZR-0145P)
Följ det här exemplet för att hämta en lista över produkter per land för Azure VM-reservationer som gäller för Microsoft Azure-prenumerationer (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
Nya licensbaserade tjänster för handel
Kommentar
De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Molnlösningsleverantör (CSP:er). Mer information finns i översikten över nya handelsupplevelser.
Följ det här exemplet för att få en lista över produkter per land för nya licensbaserade tjänster för handel som en del av den nya tekniska förhandsversionen av handelsupplevelsen. Nya licensbaserade tjänster för handel identifieras med ID- och displayNames-värden för OnlineServicesNCE. Se svarsexemplet nedan.
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-svar
Om det lyckas innehåller svarstexten en samling produktresurser.
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder för Partnercenter.
Den här metoden returnerar följande felkoder:
| HTTP-statuskod | Felkod | beskrivning |
|---|---|---|
| 403 | 400030 | Åtkomst till det begärda targetSegment tillåts inte. |
| 403 | 400036 | Åtkomst till den begärda targetView tillåts inte. |
Svarsexempel för Azure VM-reservationer (Azure-plan)
{
"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"
}
}
Svarsexempel för nya licensbaserade tjänster för handel
Kommentar
De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Molnlösningsleverantör (CSP:er). Mer information finns i översikten över nya handelsupplevelser.
{
"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
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för