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.

Warunki wstępne

  • Poświadczenia, zgodnie z opisem w Centrum partnerskiego uwierzytelniania. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu samodzielnych poświadczeń aplikacji, jak i poświadczeń aplikacji i użytkownika.

  • Kraj/region.

C#

Aby uzyskać listę produktów:

  1. Użyj kolekcji IAggregatePartner.Products, aby wybrać kraj/region, korzystając z 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();

Jawa

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, korzystając z 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ł programu PowerShell dla 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 katalog, określając parametr katalogu.

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

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.

Nazwa Typ Wymagane Opis
kraj struna Tak Identyfikator kraju/regionu.
targetView struna Tak Identyfikuje widok docelowy wykazu. Obsługiwane wartości to:

Azure, które obejmuje wszystkie elementy Azure

AzureReservations, które obejmują wszystkie elementy rezerwacji platformy Azure

AzureReservationsVM, które obejmuje wszystkie elementy rezerwacji maszyn wirtualnych

AzureReservationsSQL, który obejmuje wszystkie elementy rezerwacji SQL

AzureReservationsCosmosDb, która obejmuje 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 handlowe oparte na licencjach.

Softwarektóry obejmuje wszystkie elementy oprogramowania

SoftwareSUSELinux, która obejmuje wszystkie elementy oprogramowania SUSE Linux

SoftwarePerpetual, który obejmuje wszystkie bezterminowe elementy oprogramowania

SoftwareSubscriptions, która obejmuje wszystkie elementy subskrypcji oprogramowania

SpecializedOffers, w tym wyspecjalizowane oferty, które zostały udostępnione niektórym partnerom

MarketplaceSaaS, które obejmuje wszystkie oferty komercyjne opublikowane przez niezależnych dostawców oprogramowania (ISVs)
targetSegment struna Nie Identyfikuje segment docelowy. Widok dla różnych odbiorców docelowych. Obsługiwane wartości to:

komercyjne
edukacja
rząd
organizacja non-profit
zakres rezerwacji struna 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 Microsoft Azure (MS-AZR-0145P).

Nagłówki żądań

Więcej informacji znajdziesz w nagłówkach REST Centrum partnerskiego.

Treść żądania

Żaden.

Przykłady żądań

Produkty według kraju

Postępuj zgodnie z tym przykładem, aby uzyskać listę produktów dla poszczególnych krajów dla subskrypcji Microsoft Azure (MS-AZR-0145P) i planów 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 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

Notatka

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców 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 licencyjnych w ramach wersji technicznej nowego środowiska handlowego. Nowe usługi handlowe oparte na licencjach będą identyfikowane przez wartości ID oraz nazwy wyświetlane 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 Product.

Kody statusu 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 segmentu docelowego 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

Notatka

Nowe środowiska handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych doświadczeń 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"
  }
}