Obter um produto por ID
Obtém o recurso de produto especificado com um ID de produto.
Pré-requisitos
Credenciais conforme descrito na autenticação do Centro de Parceiros. Este cenário suporta a autenticação com credenciais autónomas da Aplicação e da Aplicação+Utilizador.
Um ID de produto.
C#
Para localizar um produto específico por ID, utilize a coleção IAggregatePartner.Products , selecione o país utilizando o método ByCountry() e, em seguida, chame o método ById( ). Por fim, chame o método Get() ou GetAsync() para devolver o produto.
// IAggregatePartner partnerOperations;
Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();
Java
O SDK Java do Centro de Parceiros pode ser utilizado para gerir recursos do Centro de Parceiros. É um projeto open source mantido pela comunidade de parceiros e não é oficialmente suportado pela Microsoft. Pode obter ajuda da comunidade ou abrir um problema no GitHub se ocorrer um problema.
Para localizar um produto específico por ID, utilize a função IAggregatePartner.getProducts , selecione o país utilizando a função byCountry() e, em seguida, chame a função byId( ). Por fim, chame a função get() para devolver o produto.
// IAggregatePartner partnerOperations;
Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();
PowerShell
O módulo do PowerShell do Centro de Parceiros pode ser utilizado para gerir recursos do Centro de Parceiros. É um projeto open source mantido pela comunidade de parceiros e não é oficialmente suportado pela Microsoft. Pode obter ajuda da comunidade ou abrir um problema no GitHub se ocorrer um problema.
Para localizar um produto específico por ID, execute o comando Get-PartnerProduct e especifique o parâmetro ProductId . O parâmetro CountryCode é opções, se não for especificado, o país associado ao revendedor será utilizado.
Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'
Pedido REST
Sintaxe do pedido
Método | URI do pedido |
---|---|
GET | {baseURL}/v1/products/{product-id}?country={country} HTTP/1.1 |
Parâmetro URI
Utilize os seguintes parâmetros de caminho para obter o produto especificado.
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
id do produto | string | Yes | Uma cadeia que identifica o produto. |
país | string | Yes | Um ID de país/região. |
Cabeçalhos do pedido
Para obter mais informações, veja Cabeçalhos REST do Centro de Parceiros.
Corpo do pedido
Nenhum.
Exemplo de pedido
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
Resposta do REST
Se for bem-sucedido, o corpo da resposta contém um recurso de Produto .
Códigos de erro e êxito da resposta
Cada resposta inclui um código de estado HTTP que indica êxito ou falha e informações adicionais de depuração. Utilize uma ferramenta de rastreio de rede para ler este código, tipo de erro e parâmetros adicionais. Para obter a lista completa, veja Códigos de erro do Centro de Parceiros.
Este método devolve os seguintes códigos de erro:
Código de Estado HTTP | Código de erro | Description |
---|---|---|
404 | 400013 | O produto não foi encontrado. |
Exemplo de resposta para a reserva da VM do Azure (plano do Azure)
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": []
}
}
}
Exemplo de resposta para novo produto baseado em licenças de comércio
Nota
As novas experiências comerciais para serviços baseados em licenças incluem muitas novas capacidades e estão disponíveis para todos os Fornecedores de Soluções Cloud (CSPs). Para obter mais informações, veja New commerce experiences overview (Descrição geral das novas experiências comerciais).
{
"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": []
}
}
}
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários