Pobieranie listy produktów (według kraju/regionu)
Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA
Aby uzyskać kolekcję produktów dostępnych w danym kraju/regionie, możesz użyć następujących metod.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Kraj/region.
C#
Aby uzyskać listę produktów:
Użyj kolekcji IAggregatePartner.Products, aby wybrać kraj/region przy użyciu metody ByCountry().
Wybierz widok wykazu przy użyciu metody ByTargetView().
(Opcjonalnie) Wybierz zakres rezerwacji przy użyciu metody ByReservationScope().
(Opcjonalnie) Wybierz segment docelowy przy użyciu metody ByTargetSegment().
Wywołaj metodę Get() lub GetAsync(), aby zwrócić kolekcję.
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
Zestaw SDK Java Centrum partnerskiego może służyć do zarządzania zasobami Centrum partnerskiego. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub .
Aby uzyskać listę produktów:
Użyj funkcji IAggregatePartner.getProducts, aby wybrać kraj przy użyciu funkcji byCountry().
Wybierz widok wykazu przy użyciu funkcji byTargetView().
(Opcjonalnie) Wybierz segment docelowy przy użyciu funkcji byTargetSegment().
Wywołaj funkcję get(), aby zwrócić kolekcję.
// 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
Moduł PowerShell Centrum partnerskiego może służyć do zarządzania zasobami Centrum partnerskiego. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub .
Aby uzyskać listę produktów:
Wybierz wykaz, określając parametr Katalogu .
(Opcjonalnie) Wybierz segment docelowy, określając parametr Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
Żądanie REST
Składnia żądania
| Metoda | Identyfikator URI żądania |
|---|---|
| GET | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
Parametry identyfikatora URI
Użyj następującej ścieżki i parametrów zapytania, aby uzyskać listę produktów.
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| kraj | string | Tak | Identyfikator kraju/regionu. |
| targetView | string | Tak | Identyfikuje widok docelowy wykazu. Obsługiwane wartości to: Platforma Azure obejmująca wszystkie elementy platformy Azure AzureReservations, która obejmuje wszystkie elementy rezerwacji platformy Azure Maszyna wirtualna AzureReservationsVM obejmująca wszystkie elementy rezerwacji maszyn wirtualnych AzureReservationsSQL, który obejmuje wszystkie elementy rezerwacji SQL AzureReservationsCosmosDb, który zawiera wszystkie elementy rezerwacji bazy danych Cosmos MicrosoftAzure, która obejmuje elementy subskrypcji platformy Microsoft Azure (MS-AZR-0145P) i plany platformy Azure OnlineServices, która obejmuje wszystkie elementy usług online, takie jak tradycyjne usługi oparte na licencjach i nowe usługi oparte na licencjach handlowych. Oprogramowanie, które zawiera wszystkie elementy oprogramowania SoftwareSUSELinux, który obejmuje wszystkie elementy oprogramowania SUSE Linux SoftwarePerpetual, który obejmuje wszystkie bezterminowe elementy oprogramowania Subskrypcje oprogramowania, które obejmują wszystkie elementy subskrypcji oprogramowania SpecializedOffers, w tym wyspecjalizowane oferty, które zostały udostępnione niektórym partnerom MarketplaceSaaS, która obejmuje wszystkie oferty komercyjnej platformy handlowej opublikowane przez niezależnych dostawców oprogramowania (ISV) |
| targetSegment | string | Nie | Identyfikuje segment docelowy. Widok dla różnych odbiorców docelowych. Obsługiwane wartości to: Handlowych Edukacji Rząd Non-profit |
| reservationScope | string | Nie | Podczas wykonywania zapytań dotyczących listy produktów dla rezerwacji platformy Azure określ reservationScope=AzurePlan , aby uzyskać listę produktów, które mają zastosowanie do planów platformy Azure. Wyklucz ten parametr, aby uzyskać listę produktów dla rezerwacji platformy Azure, które mają zastosowanie do subskrypcji platformy Microsoft Azure (MS-AZR-0145P). |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
Brak.
Przykłady żądań
Produkty według kraju
Postępuj zgodnie z tym przykładem, aby uzyskać listę produktów według kraju dla platformy Microsoft Azure (MS-AZR-0145P) i planów platformy Azure.
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
Rezerwacje maszyn wirtualnych platformy Azure (plan platformy Azure)
Postępuj zgodnie z tym przykładem, aby uzyskać listę produktów według kraju dla rezerwacji maszyn wirtualnych platformy Azure, które mają zastosowanie do planów platformy 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Rezerwacje maszyn wirtualnych platformy Azure dla subskrypcji platformy Microsoft Azure (MS-AZR-0145P)
Postępuj zgodnie z tym przykładem, aby uzyskać listę produktów według kraju dla rezerwacji maszyn wirtualnych platformy Azure, które mają zastosowanie do subskrypcji platformy 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Nowe usługi oparte na licencjach handlowych
Uwaga
Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.
Postępuj zgodnie z tym przykładem, aby uzyskać listę produktów według kraju dla nowych usług opartych na licencjach handlowych w ramach nowego środowiska handlowego technical preview. Nowe usługi oparte na licencjach handlowych będą identyfikowane przez wartości id i displayNames usługi OnlineServicesNCE. Zobacz przykład odpowiedzi poniżej.
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
Odpowiedź REST
W przypadku powodzenia treść odpowiedzi zawiera kolekcję zasobów produktu.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów Centrum partnerskiego.
Ta metoda zwraca następujące kody błędów:
| Kod stanu HTTP | Kod błędu | opis |
|---|---|---|
| 403 | 400030 | Dostęp do żądanego elementu docelowegoSegment jest niedozwolony. |
| 403 | 400036 | Dostęp do żądanego elementu targetView jest niedozwolony. |
Przykład odpowiedzi dla rezerwacji maszyn wirtualnych platformy Azure (plan platformy 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"
}
}
Przykład odpowiedzi dla nowych usług opartych na licencjach handlowych
Uwaga
Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich Dostawca rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.
{
"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"
}
}
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla