Obter uma lista de produtos (por país/região)
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government
Você pode usar os seguintes métodos para obter uma coleção de produtos disponíveis em um determinado país/região.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Um país/região.
C#
Para obter uma lista de produtos:
Use sua coleção IAggregatePartner.Products para selecionar o país/região usando o método ByCountry().
Selecione a exibição de catálogo usando o método ByTargetView().
(Opcional) Selecione o escopo da reserva usando o método ByReservationScope().
(Opcional) Selecione o segmento de destino usando o método ByTargetSegment().
Chame o método Get() ou GetAsync() para retornar a coleção.
IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();
// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();
// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();
Java
O SDK Java do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de código aberto mantido pela comunidade de parceiros e não é oficialmente suportado pela Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.
Para obter uma lista de produtos:
Use sua função IAggregatePartner.getProducts para selecionar o país usando a função byCountry().
Selecione a exibição de catálogo usando a função byTargetView().
(Opcional) Selecione o segmento de destino usando a função byTargetSegment().
Chame a função get() para retornar a coleção.
// IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();
PowerShell
O módulo PowerShell do Partner Center pode ser usado para gerenciar recursos do Partner Center. É um projeto de código aberto mantido pela comunidade de parceiros e não é oficialmente suportado pela Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.
Para obter uma lista de produtos:
Execute o comando Get-PartnerProduct.
Selecione o catálogo especificando o parâmetro Catalog .
(Opcional) Selecione o segmento de destino especificando o parâmetro Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
Solicitação REST
Sintaxe da solicitação
| Método | URI da solicitação |
|---|---|
| GET | {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
Parâmetros do URI
Use o seguinte caminho e parâmetros de consulta para obter uma lista de produtos.
| Nome | Digitar | Obrigatória | Descrição |
|---|---|---|---|
| country | string | Sim | O ID do país/região. |
| targetView | string | Sim | Identifica a exibição de destino do catálogo. Os valores suportados são: Azure, que inclui todos os itens do Azure AzureReservations, que inclui todos os itens de reserva do Azure AzureReservationsVM, que inclui todos os itens de reserva de máquina virtual (VM) AzureReservationsSQL, que inclui todos os itens de reserva SQL AzureReservationsCosmosDb, que inclui todos os itens de reserva de banco de dados do Cosmos MicrosoftAzure, que inclui itens para assinaturas do Microsoft Azure (MS-AZR-0145P) e planos do Azure OnlineServices, que inclui todos os itens de serviço online, como serviços tradicionais baseados em licença e novos serviços baseados em licença de comércio. Software, que inclui todos os itens de software SoftwareSUSELinux, que inclui todos os itens de software SUSE Linux SoftwarePerpetual, que inclui todos os itens de software perpétuos SoftwareSubscriptions, que inclui todos os itens de assinatura de software SpecializedOffers, que inclui ofertas especializadas que foram disponibilizadas para alguns parceiros MarketplaceSaaS, que inclui todas as ofertas de marketplace comercial publicadas por ISVs (Independent Software Vendors) |
| Segmento-alvo | string | Não | Identifica o segmento alvo. A visão para diferentes públicos-alvo. Os valores suportados são: comercial education government sem fins lucrativos |
| reservaEscopo | string | Não | Ao consultar uma lista de produtos para Reservas do Azure, especifique reservationScope=AzurePlan para obter uma lista de produtos aplicáveis aos planos do Azure. Exclua esse parâmetro para obter uma lista de produtos para reservas do Azure, que são aplicáveis a assinaturas do Microsoft Azure (MS-AZR-0145P). |
Cabeçalhos da solicitação
Para obter mais informações, confira Cabeçalhos REST do Partner Center.
Corpo da solicitação
Nenhum.
Exemplos de solicitação
Produtos por país
Siga este exemplo para obter uma lista de produtos por país para assinaturas do Microsoft Azure (MS-AZR-0145P) e planos do Azure.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Reservas de VM do Azure (plano do Azure)
Siga este exemplo para obter uma lista de produtos por país para reservas de VM do Azure aplicáveis aos planos do Azure.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Reservas de VM do Azure para assinaturas do Microsoft Azure (MS-AZR-0145P)
Siga este exemplo para obter uma lista de produtos por país para reservas de VM do Azure aplicáveis a assinaturas do Microsoft Azure (MS-AZR-0145P).
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Novos serviços baseados em licenças de comércio
Observação
As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.
Siga este exemplo para obter uma lista de produtos por país para novos serviços baseados em licença de comércio como parte da nova visualização técnica da experiência de comércio. Novos serviços baseados em licença de comércio serão identificados pelos valores ID e displayNames de OnlineServicesNCE. Veja o exemplo de resposta abaixo.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Resposta REST
Se for bem-sucedido, o corpo da resposta conterá uma coleção de recursos do produto .
Códigos de êxito e de erro de resposta
Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro do Partner Center.
Esse método retorna os seguintes códigos de erro:
| Código de status HTTP | Código do erro | Descrição |
|---|---|---|
| 403 | 400030 | O acesso ao targetSegment solicitado não é permitido. |
| 403 | 400036 | O acesso ao targetView solicitado não é permitido. |
Exemplo de resposta para reservas de VM do Azure (plano do Azure)
{
"totalCount": 19,
"items": [
{
"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": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=Azure",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Exemplo de resposta para novos serviços baseados em licença de comércio
Observação
As novas experiências de comércio para serviços baseados em licença incluem muitos recursos novos e estão disponíveis para todos os CSPs (provedores de soluções em nuvem). Para obter mais informações, confira a visão geral das novas experiências de comércio.
{
"totalCount": 19,
"items": [{
"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": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=OnlineServices",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de