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

• Az Partnerközpont hitelesítései ahogyan az aszakaszban le van írva. 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ó.

C#

Ha azonosító alapján szeretne megkeresni egy adott terméket, használja a 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 GetAsync() metódust a termék visszaküldéséhez.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

Jáva

A Partnerközpont Java SDK használható a Partnerközpont erőforrásainak kezelésére. 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, kérhet segítséget a közösségtől, vagy nyisson meg egy problémát a GitHub.

Egy adott termék azonosító szerinti megkereséséhez használja a 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 visszaküldéséhez.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();

PowerShell

A Partnerközpont PowerShell-modulja használható a Partnerközpont erőforrásainak kezelésére. 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, kérhet segítséget a közösségtől, vagy jelentsen 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ásai, ha nincs megadva, akkor a rendszer a viszonteladóhoz társított országot fogja használni.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

REST-kérés

Kérés szintaxisa

URI-paraméter

A megadott termék lekéréséhez használja az alábbi elérésiút-paramétereket.

Kérelemfejlécek

További információ: Partnerközpont REST-fejlécei.

Kérelem tartalma

Egyik sem.

Példa kérése

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: aaaa0000-bb11-2222-33cc-444444dddddd

REST-válasz

Ha sikeres, a válasz törzse egy Termék erőforrást tartalmaz.

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 lásd Partnerközpont hibakódjai.

Ez a metódus a következő hibakódokat adja vissza:

Válasz példa 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: aaaa0000-bb11-2222-33cc-444444dddddd
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": []
        }
    }
}

Válasz példa új kereskedelmi licencalapú termékhez

{
    "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": []
        }
    }
}