Termékváltozat lekérése azonosító alapján
Lekéri a megadott termék SKU-ját a megadott SKU-azonosítóval.
Előfeltételek
A hitelesítő adatok, ahogyan a Partnerközpont hitelesítése leírja . 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.
Termékazonosító.
Termékváltozat azonosítója.
C#
Egy adott termékváltozat részleteinek lekéréséhez először kövesse az Termék lekérése azonosító alapján lépéseit, hogy lekérje egy adott termék műveleteinek felületét. Az eredményként kapott felületen válassza ki a Skus tulajdonságot, és szerezze be az SKU-khoz elérhető műveleteket tartalmazó felületet. Adja át az SKU-azonosítót a ById() metódusnak, és hívja meg Get() vagy GetAsync() a termékváltozat részleteinek lekéréséhez.
IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
// Get the SKU details.
var sku = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Get();
REST-kérés
Kérés szintaxisa
Módszer | URI kérése |
---|---|
SZEREZD MEG | {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code} HTTP/1.1 |
URI-paraméter
A megadott termék termékváltozatának lekéréséhez használja az alábbi elérési utat és lekérdezési paramétereket a megadott termékváltozat-azonosító használatával.
Név | Típus | Szükséges | Leírás |
---|---|---|---|
termékazonosító | karakterlánc | Igen | A terméket azonosító sztring. |
SKU-azonosító | húr | Igen | Az SKU-azonosítót megadó karakterlánc. |
országkód | húr | Igen | Egy ország/régió azonosítója. |
Kérelemfejlécek
További információkért lásd a Partnerközpont REST-fejlécei.
Kérelem tartalma
Egyik sem.
Példa kérése
GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3V/skus/00G1?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com
Fontos
2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást a GitHub töltheti le, valamint egy hasznos információkat tartalmazó olvasófájlt.
A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.
REST-válasz
Ha sikeres, a válasz törzs tartalmaz egy SKU erőforrást.
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 lista megtekintéséhez lásd: Partnerközpont hibakódjai.
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ó. |
404 | 400018 | SKU nem található. |
Példa válasza az Azure virtuális gép foglalásokhoz (Azure-csomag)
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f,e0ae69a5-6322-4d7e-809d-59e02b51d71f
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNWXHNrdXNcMDBHMQ==?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 17:43:25 GMT
Content-Length: 1108
{
"id": "00G1",
"productId": "DZH318Z0BQ3V",
"title": "Reserved VM Instance, Standard_D32s_v3, US West 2, 3 Years",
"description": "Reserved Virtual Machines Instance, Standard_D32s_v3, US West 2, 3 Years",
"minimumQuantity": 1,
"maximumQuantity": 999999999,
"isTrial": false,
"supportedBillingCycles": [
"one_time"
],
"purchasePrerequisites": [
"AzureSubscriptionRegistration",
"InventoryCheck"
],
"inventoryVariables": [
"CustomerId",
"AzureSubscriptionId"
],
"provisioningVariables": [
"Scope",
"SubscriptionId"
],
"dynamicAttributes": {
"armSkuName": "Standard_D32s_v3",
"cores": "32",
"ram": "128",
"skuDisplayName": "D32s v3",
"category": "General purpose",
"armRegionName": "westus2",
"duration": "3Years",
"region": "US West 2",
"diskType": "Ssd"
},
"links": {
"availabilities": {
"uri": "/products/DZH318Z0BQ3V/skus/00G1/availabilities?country=us",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BQ3V/skus/00G1?country=us",
"method": "GET",
"headers": []
}
}
}
Válasz példa új kereskedelmi licencalapú szolgáltatásokhoz
Jegyzet
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ó: új kereskedelmi szolgáltatások áttekintése.
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee,bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 18b41adf-29b5-48eb-b14f-c9683a4e5b7d,18b41adf-29b5-48eb-b14f-c9683a4e5b7d
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTVTXHNrdXM=?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 21:06:03 GMT
Content-Length: 50917
{
"id": "0001",
"productId": "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.",
"minimumQuantity": 1,
"maximumQuantity": 300,
"isTrial": false,
"supportedBillingCycles": [
"annual",
"monthly"
],
"purchasePrerequisites": [
"MicrosoftCloudAgreement"
],
"inventoryVariables": [],
"provisioningVariables": [],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"hasConstraints": true,
"isAddon": false,
"prerequisiteSkus": [],
"isSoftwareAssuranceApplicable": false,
"upgradeTargetOffers": [
"CFQ7TTC0LDPB:0001",
"CFQ7TTC0LF8Q:0001"
…
],
"provisioningId": "3b555118-da6a-4418-894f-7df1e2096870",
"internal": false
},
"links": {
"availabilities": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/CFQ7TTC0LH18/skus/0001?country=US",
"method": "GET",
"headers": []
}
}
}