Udostępnij za pośrednictwem

Pobieranie listy produktów (według kraju/regionu)

  • Artykuł

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:

  1. Użyj kolekcji IAggregatePartner.Products, aby wybrać kraj/region przy użyciu metody ByCountry().

  2. Wybierz widok wykazu przy użyciu metody ByTargetView().

  3. (Opcjonalnie) Wybierz zakres rezerwacji przy użyciu metody ByReservationScope().

  4. (Opcjonalnie) Wybierz segment docelowy przy użyciu metody ByTargetSegment().

  5. 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:

  1. Użyj funkcji IAggregatePartner.getProducts, aby wybrać kraj przy użyciu funkcji byCountry().

  2. Wybierz widok wykazu przy użyciu funkcji byTargetView().

  3. (Opcjonalnie) Wybierz segment docelowy przy użyciu funkcji byTargetSegment().

  4. 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:

  1. Wykonaj polecenie Get-PartnerProduct.

  2. Wybierz wykaz, określając parametr Katalogu .

  3. (Opcjonalnie) Wybierz segment docelowy, określając parametr Segment .

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

Żądanie REST

Składnia żądania

Method 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:

reklama
edukacja
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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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