Obter um produto por IDGet a product by ID

Aplica-se aApplies To

  • Partner CenterPartner Center

Obtém o recurso de produto especificado usando uma ID de produto.Gets the specified product resource using a product ID.

Pré-requisitosPrerequisites

  • Credenciais, conforme descrito em Autenticação do Partner Center.Credentials as described in Partner Center authentication. Esse cenário dá suporte à autenticação com aplicativos autônomos e aplicativos + credenciais de usuário.This scenario supports authentication with both standalone App and App+User credentials.

  • Uma ID de produto.A product ID.

C#C#

Para localizar um produto específico por ID, use sua coleção IAggregatePartner. Products , selecione o país usando o método ByCountry () e, em seguida, chame o método ById () .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. Por fim, chame o método Get () ou getasync () para retornar o produto.Finally, call the Get() or GetAsync() method to return the product.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.Products.ByCountry("US").ById("DZH318Z0BQ3Q").Get();

JavaJava

O SDK do Java do Partner Center geralmente é usado por parceiros para gerenciar os recursos do Partner Center.The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. É um projeto de software livre mantido pela comunidade de parceiros.It's an open-source project maintained by the partner community. Esse módulo é mantido pela comunidade de parceiros e, por isso, não tem suporte oficial da Microsoft.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.You can get help from the community or open an issue on GitHub if you experience a problem.

Para localizar um produto específico por ID, use a função IAggregatePartner. GetProducts , selecione o país usando a função byCountry () e, em seguida, chame a função byId () .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. Por fim, chame a função Get () para retornar o produto.Finally, call the get() function to return the product.

// IAggregatePartner partnerOperations;

Product productDetail = partnerOperations.getProducts().byCountry("US").byId("DZH318Z0BQ3Q").get();

PowerShellPowerShell

O módulo PowerShell do Partner Center é normalmente usado por parceiros para gerenciar os recursos do Partner Center.The Partner Center PowerShell module is commonly used by partners to manage their Partner Center resources. É um projeto de software livre mantido pela comunidade de parceiros.It's an open-source project maintained by the partner community. Esse módulo é mantido pela comunidade de parceiros e, por isso, não tem suporte oficial da Microsoft.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Caso se depare com um problema, você pode obter ajuda da comunidade ou abrir um problema no GitHub.You can get help from the community or open an issue on GitHub if you experience a problem.

Para localizar um produto específico por ID, execute o comando Get-PartnerProduct e especifique o parâmetro ProductID .To find a specific product by ID, execute the Get-PartnerProduct command and specify the ProductId parameter. O parâmetro CountryCode é opções, se não for especificado, o país associado ao revendedor será usado.The CountryCode parameter is options, if it isn't specified then the country associated with the reseller will be used.

Get-PartnerProduct -ProductId 'DZH318Z0BQ3Q'

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/Products/{product-ID}? país = {país} http/1.1{baseURL}/v1/products/{product-id}?country={country} HTTP/1.1

Parâmetro do URIURI parameter

Use os seguintes parâmetros de caminho para obter o produto especificado.Use the following path parameters to get the specified product.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
ID do produtoproduct-id stringstring SimYes Uma cadeia de caracteres que identifica o produto.A string that identifies the product.
countrycountry stringstring SimYes Uma ID de país/região.A country/region ID.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, confira Cabeçalhos REST do Partner Center.For more information, see Partner Center REST headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest 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: 7c1f6619-c176-4040-a88f-2c71f3ba4533

Resposta RESTREST response

Se for bem-sucedido, o corpo da resposta conterá um recurso do produto .If successful, the response body contains a Product resource.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter a lista completa, consulte códigos de erro do Partner Center.For the full list, see Partner Center error codes.

Esse método retorna os seguintes códigos de erro:This method returns the following error codes:

Código de status HTTPHTTP Status Code Código do erroError code DescriçãoDescription
404404 400013400013 Produto não encontrado.Product was not found.

Exemplo de respostaResponse example

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": []
        }
    }
}