Get a product by ID
Gets the specified product resource using a product ID.
Prerequisites
Credentials as described in Partner Center authentication. This scenario supports authentication with both standalone App and App+User credentials.
A product ID.
C#
To find a specific product by ID, use your IAggregatePartner.Products collection, select the country by using the ByCountry() method, then call the ById() method. Finally, call the Get() or GetAsync() method to return the product.
// IAggregatePartner partnerOperations;
Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();
Java
The Partner Center Java SDK can be used to manage Partner Center resources. It's an open-source project maintained by the partner community and not officially supported by Microsoft. You can get help from the community or open an issue on GitHub if you experience a problem.
To find a specific product by ID, use your IAggregatePartner.getProducts function, select the country by using the byCountry() function, then call the byId() function. Finally, call the get() function to return the product.
// IAggregatePartner partnerOperations;
Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();
PowerShell
The Partner Center PowerShell module can be used to manage Partner Center resources. It's an open-source project maintained by the partner community and not officially supported by Microsoft. You can get help from the community or open an issue on GitHub if you experience a problem.
To find a specific product by ID, execute the Get-PartnerProduct command and specify the ProductId parameter. The CountryCode parameter is options, if it isn't specified then the country associated with the reseller will be used.
Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'
REST request
Request syntax
Method | Request URI |
---|---|
GET | {baseURL}/v1/products/{product-id}?country={country} HTTP/1.1 |
URI parameter
Use the following path parameters to get the specified product.
Name | Type | Required | Description |
---|---|---|---|
product-id | string | Yes | A string that identifies the product. |
country | string | Yes | A country/region ID. |
Request headers
For more information, see Partner Center REST headers.
Request body
None.
Request example
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 response
If successful, the response body contains a Product resource.
Response success and error codes
Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use a network trace tool to read this code, error type, and additional parameters. For the full list, see Partner Center error codes.
This method returns the following error codes:
HTTP Status Code | Error code | Description |
---|---|---|
404 | 400013 | Product was not found. |
Response example for Azure VM reservation (Azure plan)
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": []
}
}
}
Response example for new commerce license-based product
Note
The new commerce experiences for license-based services include many new capabilities and are available to all Cloud Solution Provider (CSPs). For more information, see new commerce experiences overview.
{
"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": []
}
}
}