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

Článek
09/27/2024

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 popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
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().
Zavolejte metodu Get() nebo GetAsync() a vrať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 Java SDK Partnerského centra je možné 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 problém 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 PowerShellu v Partnerském centru se dá 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 problém 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	Identifikátor URI žádosti
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.

Name	Type	Požadováno	Popis
country	string	Ano	ID země/oblasti.
targetView	string	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 Virtuální počítač 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í licenční 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 Podsítě softwaru, 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)
targetSegment	string	No	Identifikuje cílový segment. Zobrazení pro různé cílové skupiny Podporované hodnoty jsou: komerční vzdělávání vláda neziskový
reservationScope	string	No	Při dotazování na seznam produktů pro rezervace Azure zadejte `reservationScope=AzurePlan` seznam produktů, které se vztahují k plánům Azure. Pokud chcete získat seznam produktů pro rezervace Azure, které se vztahují k předplatným Microsoft Azure (MS-AZR-0145P), vylučte tento parametr.

Záhlaví žádosti

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Nezaokrouhlovat.

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á 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 přehledu nových obchodních prostředí.

Podle tohoto příkladu získáte seznam produktů podle země pro nové služby založené na obchodních licencích jako součást nového komerčního prostředí Technical Preview. Nové služby založené na obchodních licencích budou identifikovány hodnotami ID a displayNames funkce 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 text odpovědi obsahuje kolekci prostředků produktu .

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ě. Úplný seznam najdete v tématu Kódy chyb v Partnerském centru.

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íliSegment 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

Záhlaví žádosti

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