Termékek listájának lekérése (ország/régió szerint)
A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont a Microsoft Cloud for US Government számára
Az alábbi módszerekkel beszerezheti egy adott országban/régióban elérhető termékek gyűjteményét.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Egy ország/régió.
C#
A termékek listájának lekérése:
Az IAggregatePartner.Products gyűjtemény használatával válassza ki az országot/régiót a ByCountry() metódussal.
Válassza ki a katalógusnézetet a ByTargetView() metódussal.
(Nem kötelező) Válassza ki a foglalási hatókört a ByReservationScope() metódussal.
(Nem kötelező) Válassza ki a célszegmenst a ByTargetSegment() metódussal.
Hívja meg a Get() vagy a GetAsync() metódust a gyűjtemény visszaadásához.
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
A Partnerközpont Java SDK-val kezelheti a Partnerközpont erőforrásait. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, segítséget kérhet a közösségtől, vagy problémákat nyithat meg a GitHubon.
A termékek listájának lekérése:
Az IAggregatePartner.getProducts függvény használatával válassza ki az országot a byCountry() függvény használatával.
Válassza ki a katalógusnézetet a byTargetView() függvény használatával.
(Nem kötelező) Válassza ki a célszegmenst a byTargetSegment() függvénnyel.
Hívja meg a get() függvényt a gyűjtemény visszaadásához.
// 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
A Partnerközpont PowerShell-modulja a Partnerközpont erőforrásainak kezelésére használható. Ez egy nyílt forráskódú projekt, amelyet a partnerközösség tart fenn, és amelyet a Microsoft hivatalosan nem támogat. Ha problémát tapasztal, segítséget kérhet a közösségtől, vagy problémákat nyithat meg a GitHubon.
A termékek listájának lekérése:
Hajtsa végre a Get-PartnerProduct parancsot.
Válassza ki a katalógust a katalógus paraméterének megadásával.
(Nem kötelező) Válassza ki a célszegmenst a Szegmens paraméter megadásával.
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
REST-kérés
Kérés szintaxisa
| Metódus | Kérés URI-ja |
|---|---|
| GET | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
URI-paraméterek
A termékek listájának lekéréséhez használja az alábbi elérési utat és lekérdezési paramétereket.
| Name | Type | Kötelező | Leírás |
|---|---|---|---|
| Ország | sztring | Igen | Az ország/régió azonosítója. |
| targetView | sztring | Igen | Azonosítja a katalógus célnézetét. A támogatott értékek a következők: Azure, amely az összes Azure-elemet tartalmazza AzureReservations, amely az összes Azure-foglalási elemet tartalmazza AzureReservationsVM, amely magában foglalja az összes virtuálisgép-foglalási elemet AzureReservationsSQL, amely az összes SQL-foglalási elemet tartalmazza AzureReservationsCosmosDb, amely tartalmazza az összes Cosmos-adatbázis-foglalási elemet MicrosoftAzure, amely a Microsoft Azure-előfizetések (MS-AZR-0145P) és az Azure-csomagok elemeit tartalmazza OnlineServices, amely magában foglalja az összes online szolgáltatáselemet, például a hagyományos licencalapú szolgáltatásokat és az új kereskedelmi licencalapú szolgáltatásokat. Szoftver, amely tartalmazza az összes szoftverelemet SoftwareSU Standard kiadás Linux, amely tartalmazza az összes szoftver SU Standard kiadás Linux-elemet SoftwarePerpetual, amely tartalmazza az összes állandó szoftverelemet SoftwareSubscriptions, amely tartalmazza az összes szoftver-előfizetési elemet SpecialOffers, amely egyes partnerek számára elérhetővé tett speciális ajánlatokat tartalmaz MarketplaceSaaS, amely magában foglalja a független szoftverszállítók (ISV-k) által közzétett összes kereskedelmi piactéri ajánlatot |
| targetSegment | karakterlánc | Nem | Azonosítja a célszegmenst. A különböző célközönségek nézete. A támogatott értékek a következők: Kereskedelmi Oktatás Kormány Nonprofit |
| reservationScope | karakterlánc | Nem | Az Azure Reservationshez tartozó termékek listájának lekérdezésekor adja meg reservationScope=AzurePlan , hogy lekérje az Azure-csomagokra vonatkozó termékek listáját. A paraméter kizárásával lekérheti az Azure-foglalások termékeinek listáját, amelyek a Microsoft Azure-előfizetésekre (MS-AZR-0145P) vonatkoznak. |
Kérésfejlécek
További információ: Partnerközpont – REST fejlécek.
Kérés törzse
Nincs.
Példák kérésére
Termékek országonként
Kövesse ezt a példát a Microsoft Azure -előfizetések és Azure-csomagok termékek országonkénti listájának lekéréséhez.
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
Azure-beli virtuálisgép-foglalások (Azure-csomag)
Ezt a példát követve országonként lekérheti az Azure-beli virtuálisgép-foglalások termékeinek listáját, amelyek az Azure-csomagokra vonatkoznak.
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
Azure-beli virtuálisgép-foglalások Microsoft Azure-előfizetésekhez (MS-AZR-0145P)
Kövesse ezt a példát a Microsoft Azure-előfizetésekre (MS-AZR-0145P) vonatkozó Azure-beli virtuálisgép-foglalások termékeinek országonkénti listájához.
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
Új kereskedelmi licencalapú szolgáltatások
Megjegyzés:
A licencalapú szolgáltatások új kereskedelmi szolgáltatásai számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi szolgáltatások áttekintését.
Ezt a példát követve országonként lekérheti az új kereskedelmi licencalapú szolgáltatásokhoz tartozó termékek listáját az új kereskedelmi felület technikai előzetes verziójának részeként. Az új kereskedelmi licencalapú szolgáltatásokat az OnlineServicesNCE azonosító és displayNames értékei azonosítják. Lásd az alábbi válasz példáját.
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
REST-válasz
Ha sikeres, a válasz törzse termékerőforrások gyűjteményét tartalmazza.
Válasz sikeresség és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont hibakódjaiban találja.
Ez a metódus a következő hibakódokat adja vissza:
| HTTP-állapotkód | Error code | Leírás |
|---|---|---|
| 403 | 400030 | A kért targetSegment elérése nem engedélyezett. |
| 403 | 400036 | A kért targetView-hoz való hozzáférés nem engedélyezett. |
Válasz példa azure-beli virtuálisgép-foglalásokhoz (Azure-csomag)
{
"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"
}
}
Válasz példa új kereskedelmi licencalapú szolgáltatásokhoz
Megjegyzés:
A licencalapú szolgáltatások új kereskedelmi szolgáltatásai számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi szolgáltatások áttekintését.
{
"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"
}
}
Visszajelzés
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ: https://aka.ms/ContentUserFeedback.
Visszajelzés küldése és megtekintése a következőhöz: