Egy termék lekérése azonosító alapján
Lekéri a megadott termékerőforrást egy termékazonosító használatával.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a különálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Egy termékazonosító.
C#
Egy adott termék azonosító szerinti megkereséséhez használja az IAggregatePartner.Products gyűjteményt, válassza ki az országot a ByCountry() metódussal, majd hívja meg a ById() metódust . Végül hívja meg a Get() vagy a GetAsync() metódust a termék visszaküldéséhez.
// IAggregatePartner partnerOperations;
Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").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 megnyithat egy problémát a GitHubon .
Egy adott termék azonosító szerinti megkereséséhez használja az IAggregatePartner.getProducts függvényt, válassza ki az országot a byCountry() függvénnyel, majd hívja meg a byId() függvényt . Végül hívja meg a get() függvényt a termék visszaadásához.
// IAggregatePartner partnerOperations;
Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").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 megnyithat egy problémát a GitHubon .
Egy adott termék azonosító szerinti megkereséséhez hajtsa végre a Get-PartnerProduct parancsot, és adja meg a ProductId paramétert . A CountryCode paraméter beállítások, ha nincs megadva, akkor a rendszer a viszonteladóhoz társított országot fogja használni.
Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'
REST-kérelem
Kérés szintaxisa
Metódus | Kérés URI-ja |
---|---|
GET | {baseURL}/v1/products/{product-id}?country={country} HTTP/1.1 |
URI-paraméter
A megadott termék lekéréséhez használja az alábbi elérésiút-paramétereket.
Név | Típus | Kötelező | Leírás |
---|---|---|---|
termékazonosító | sztring | Igen | A terméket azonosító sztring. |
ország | sztring | Igen | Egy ország/régió azonosítója. |
Kérésfejlécek
További információ: Partnerközpont REST-fejlécei.
A kérés törzse
Nincsenek.
Példa kérésre
GET https://api.partnercenter.microsoft.com/v1/products/{product-id}?country=US 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 sikerült, a válasz törzse tartalmaz egy Termék erőforrást.
Sikeres válasz é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. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Partnerközpont hibakódjai című témakörben találja.
Ez a metódus a következő hibakódokat adja vissza:
HTTP-állapotkód | Hibakód | Leírás |
---|---|---|
404 | 400013 | A termék nem található. |
Példa válasz az Azure-beli virtuális gépek foglalására (Azure-csomag)
HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Tue, 23 Jan 2018 23:13:01 GMT
{
"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": []
}
}
}
Példa válasz az új kereskedelmi licencalapú termékre
Megjegyzés
A licencalapú szolgáltatások új kereskedelmi felületei számos új képességet tartalmaznak, és minden felhőszolgáltató (CSP) számára elérhetők. További információ: Az új kereskedelmi szolgáltatások áttekintése.
{
"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": []
}
}
}
Visszajelzés
https://aka.ms/ContentUserFeedback.
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ó:Visszajelzés küldése és megtekintése a következőhöz: