Obter uma lista de produtos (por país/região)

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para Microsoft Cloud for US Government

Você pode usar os métodos a seguir 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 dá 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:

  1. Use sua coleção IAggregatePartner.Products para selecionar o país/região usando o método ByCountry( ).

  2. Selecione a exibição de catálogo usando o método ByTargetView( ).

  3. (Opcional) Selecione o escopo da reserva usando o método ByReservationScope( ).

  4. (Opcional) Selecione o segmento de destino usando o método ByTargetSegment( ).

  5. 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 software livre mantido pela comunidade de parceiros e não tem suporte oficial da Microsoft. Você pode obter ajuda da comunidade ou abrir um problema no GitHub se tiver um problema.

Para obter uma lista de produtos:

  1. Use a função IAggregatePartner.getProducts para selecionar o país usando a função byCountry( ).

  2. Selecione a exibição de catálogo usando a função byTargetView( ).

  3. (Opcional) Selecione o segmento de destino usando a função byTargetSegment( ).

  4. 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 software livre mantido pela comunidade de parceiros e não tem suporte oficial da Microsoft. Você pode obter ajuda da comunidade ou abrir um problema no GitHub se tiver um problema.

Para obter uma lista de produtos:

  1. Execute o comando Get-PartnerProduct .

  2. Selecione o catálogo especificando o parâmetro Catalog .

  3. (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 de solicitação
GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

Parâmetros de URI

Use os seguintes parâmetros de caminho e consulta para obter uma lista de produtos.

Nome Tipo Obrigatório Description
country cadeia Yes A ID do país/região.
targetView cadeia Yes Identifica a exibição de destino do catálogo. Os valores com suporte 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 VM (máquina virtual)

AzureReservationsSQL, que inclui todos os itens de reserva do 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 SUSE Linux de software

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 do Microsoft Marketplace publicadas por ISVs (Fornecedores Independentes de Software)
targetSegment cadeia Não Identifica o segmento de destino. A exibição para diferentes públicos-alvo. Os valores com suporte são:

comercial
educação
governo
sem fins lucrativos
reservationScope cadeia 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 às assinaturas do Microsoft Azure (MS-AZR-0145P).

Cabeçalhos da solicitação

Para mais informações, consulte os 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: aaaa0000-bb11-2222-33cc-444444dddddd

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

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

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

Resposta REST

Se bem-sucedido, o corpo da resposta contém uma coleção de recursos do Produto .

Códigos de erro e êxito 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 os 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 Description
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 na 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"
  }
}
  • Last updated on