Získání seznamu produktů (podle země/oblasti)

Článek
03/07/2025

platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Pomocí následujících metod můžete získat kolekci produktů dostupných v konkrétní zemi nebo oblasti.

Požadavky

Přihlašovací údaje, jak jsou popsány v ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace a přihlašovacích údajů typu Aplikace+Uživatel.
Země/oblast.

C#

Získání seznamu produktů:

Pomocí kolekce IAggregatePartner.Products vyberte zemi/oblast pomocí metody ByCountry().
Vyberte zobrazení katalogu pomocí metody ByTargetView().
(Volitelné) Pomocí metody ByReservationScope() vyberte rozsah rezervace.
(Volitelné) Vyberte cílový segment pomocí metody ByTargetSegment().
Voláním metody Get() nebo GetAsync() vrátíte kolekci.

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

Sadu Partner Center Java SDK lze použít ke správě prostředků Partnerského centra. Jedná se o opensourcový projekt spravovaný komunitou partnerů, který oficiálně nepodporuje Microsoft. Pokud narazíte na problém, můžete získat pomoc od komunity nebo otevřít záležitost na GitHubu.

Získání seznamu produktů:

Pomocí funkce IAggregatePartner.getProducts vyberte zemi pomocí funkce byCountry().
Vyberte zobrazení katalogu pomocí funkce byTargetView().
(Volitelné) Vyberte cílový segment pomocí funkce byTargetSegment().
Voláním funkce get() vrátíte kolekci.

// 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

Modul Partner Center PowerShell lze použít ke správě prostředků v Partnerském centru. Jedná se o opensourcový projekt spravovaný komunitou partnerů, který oficiálně nepodporuje Microsoft. Pokud narazíte na problém, můžete získat pomoc od komunity nebo otevřít záležitost na GitHubu.

Získání seznamu produktů:

Spusťte příkaz Get-PartnerProduct.
Vyberte katalog zadáním parametru katalogu.
(Volitelné) Vyberte cílový segment zadáním parametru Segment.

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

Požadavek REST

Syntaxe požadavku

Metoda	Požadavek URI
GET	{baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

Parametry identifikátoru URI

Seznam produktů získáte pomocí následující cesty a parametrů dotazu.

Jméno	Typ	Povinné	Popis
země	řetězec	Ano	ID země/oblasti.
targetView	řetězec	Ano	Identifikuje cílové zobrazení katalogu. Podporované hodnoty jsou: Azure, která zahrnuje všechny položky Azure azureReservations, která zahrnuje všechny položky rezervace Azure AzureReservationsVM, který zahrnuje všechny položky rezervace virtuálních počítačů AzureReservationsSQL, která zahrnuje všechny položky rezervace SQL AzureReservationsCosmosDb, která zahrnuje všechny položky rezervace databáze Cosmos DB MicrosoftAzure, která zahrnuje položky pro předplatná Microsoft Azure (MS-AZR-0145P) a plány Azure OnlineServices, která zahrnuje všechny položky online služeb, jako jsou tradiční licenční služby a nové komerční licencované služby. Software, který zahrnuje všechny softwarové položky SoftwareSUSELinux, která zahrnuje všechny softwarové položky SUSE Linux SoftwarePerpetual, která zahrnuje všechny položky časově neomezeného softwaru SoftwareSubscriptions, která zahrnuje všechny položky předplatného softwaru SpecializedOffers, která zahrnuje specializované nabídky, které byly zpřístupněny některým partnerům MarketplaceSaaS, která zahrnuje všechny nabídky komerčního marketplace publikované nezávislými dodavateli softwaru (ISV)
cílový segment	řetězec	Ne	Identifikuje cílový segment. Zobrazení pro různé cílové skupiny Podporované hodnoty jsou: komerční vzdělávání vláda neziskové organizace
rozsah rezervace	řetězec	Ne	Při dotazování na seznam produktů pro rezervace Azure zadejte `reservationScope=AzurePlan`, abyste získali seznam produktů, které se vztahují na plány Azure. Pokud chcete získat seznam produktů pro rezervace Azure, které se vztahují na předplatná Microsoft Azure (MS-AZR-0145P), vylučte tento parametr.

Hlavičky požadavku

Další informace najdete v části REST hlavičky Partnerského centra.

Text požadavku

Žádný.

Příklady požadavků

Produkty podle země

Podle tohoto příkladu získáte seznam produktů podle zemí pro předplatná Microsoft Azure (MS-AZR-0145P) a plány 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

Rezervace virtuálních počítačů Azure (plán Azure)

Podle tohoto příkladu získáte seznam produktů podle země pro rezervace virtuálních počítačů Azure, které se vztahují na plány 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

Rezervace virtuálních počítačů Azure pro předplatná služby Microsoft Azure (MS-AZR-0145P)

Podle tohoto příkladu získáte seznam produktů podle země pro rezervace virtuálních počítačů Azure, které platí pro předplatná 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

Nové služby založené na obchodních licencích

Poznámka

Nové komerční prostředí pro služby založené na licencích zahrnují mnoho nových funkcí a jsou k dispozici pro všechny poskytovatele cloudových řešení (CSP). Další informace najdete v tématu přehled nových obchodních prostředí.

Podle tohoto příkladu získáte seznam produktů podle země pro nové licencované služby jako součást technické ukázky nového komerčního prostředí. Nové komerční licenční služby budou identifikovány pomocí ID a hodnot displayName u OnlineServicesNCE. Podívejte se na příklad odpovědi níže.

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

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi kolekci zdrojů Product.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Pro úplný seznam se podívejte na chybové kódy Partnerského centra.

Tato metoda vrátí následující kódy chyb:

Stavový kód HTTP	Kód chyby	Popis
403	400030	Přístup k požadovanému cílovému segmentu není povolený.
403	400036	Přístup k požadovanému objektu targetView není povolený.

Příklad odpovědi pro rezervace virtuálních počítačů Azure (plán 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"
    }
}

Příklad odpovědi pro nové služby založené na obchodních licencích

Poznámka

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

Sdílet prostřednictvím

Získání seznamu produktů (podle země/oblasti)

Požadavky

C#

Java

PowerShell

Požadavek REST

Syntaxe požadavku

Parametry identifikátoru URI

Hlavičky požadavku

Text požadavku

Příklady požadavků

Produkty podle země

Rezervace virtuálních počítačů Azure (plán Azure)

Rezervace virtuálních počítačů Azure pro předplatná služby Microsoft Azure (MS-AZR-0145P)

Nové služby založené na obchodních licencích

Odpověď REST

Kódy úspěšnosti a chyb odpovědi

Příklad odpovědi pro rezervace virtuálních počítačů Azure (plán Azure)

Příklad odpovědi pro nové služby založené na obchodních licencích

Váš názor

Další materiály