Partilhar via

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

  • Artigo

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for 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 na autenticação do Partner Center. Este 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:

  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 código aberto mantido pela comunidade de parceiros e não suportado oficialmente pela 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 sua função IAggregatePartner.getProducts para selecionar o país usando a função byCountry( ).

  2. Selecione a visualização do 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 código aberto mantido pela comunidade de parceiros e não suportado oficialmente pela 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'

Pedido REST

Sintaxe da solicitação

Método URI do pedido
GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1

Parâmetros de URI

Use o caminho a seguir e os parâmetros de consulta para obter uma lista de produtos.

Nome Type Obrigatório Description
país/região string Sim O ID do país/região.
vista-alvo 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 do banco de dados 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 subscrição de software

SpecializedOffers, que inclui ofertas especializadas que foram disponibilizadas a alguns parceiros

MarketplaceSaaS, que inclui todas as ofertas de marketplace comercial publicadas por ISVs (Independent Software Vendors)
targetSegment string Não Identifica o segmento-alvo. A visão para diferentes públicos-alvo. Os valores suportados são:

Comerciais
Formação Académica
Governo
sem fins lucrativos
reservationScope string Não Ao consultar uma lista de produtos para Reservas do Azure, especifique reservationScope=AzurePlan para obter uma lista de produtos que são 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 do pedido

Para obter mais informações, consulte Cabeçalhos REST do Partner Center.

Corpo do pedido

Nenhum.

Exemplos de pedidos

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

Novos serviços baseados em licenças de comércio

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

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 visualização técnica da nova experiência de comércio. Novos serviços baseados em licença de comércio serão identificados pelos valores ID e displayNames do 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 do REST

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

Códigos de sucesso e erro de resposta

Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e 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 estado HTTP Código de 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

Nota

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 (Provedor de Soluções na Nuvem). Para obter mais informações, consulte Visão geral de novas experiências comerciais.

{
  "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"
  }
}