Obter um SKU por IDGet a SKU by ID

Aplica-se aApplies To

  • Partner CenterPartner Center

Obtém um SKU para o produto especificado usando a ID de SKU especificada.Gets a SKU for the specified product using the specified SKU 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.

  • UMA ID DE SKU.A SKU ID.

C#C#

Para obter os detalhes de um SKU específico, comece seguindo as etapas em obter um produto por ID para obter a interface para as operações específicas de um produto.To get the details of a specific SKU, start by following the steps in Get a product by ID to get the interface for a specific product's operations. Na interface resultante, selecione a propriedade SKUs para obter uma interface com as operações disponíveis para SKUs.From the resulting interface, select the Skus property to obtain an interface with the available operations for SKUs. Passe a ID do SKU para o método ById () e chame Get () ou getasync () para recuperar os detalhes da SKU.Pass the SKU ID to the ById() method, and call Get() or GetAsync() to retrieve the SKU details.

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;

// Get the SKU details.
var sku = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Get();

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/Products/{product-ID}/SKUs/{SKU-ID}? Country = {país-código} http/1.1{baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code} HTTP/1.1

Parâmetro do URIURI parameter

Use o caminho e os parâmetros de consulta a seguir para obter uma SKU para o produto especificado usando a ID de SKU especificada.Use the following path and query parameters to get a SKU for the specified product using the specified SKU ID.

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.
ID do SKUsku-id stringstring SimYes Uma cadeia de caracteres que identifica a SKU.A string that identifies the SKU.
código do paíscountry-code 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 http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3V/skus/00G1?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f
MS-CorrelationId: 956eae17-7650-4470-94d2-4f61b9b02a23
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com

Resposta RESTREST response

Se for bem-sucedido, o corpo da resposta conterá um recurso de SKU .If successful, the response body contains a SKU 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.
404404 400018400018 SKU não encontrado.Sku was not found.

Exemplo de respostaResponse example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 956eae17-7650-4470-94d2-4f61b9b02a23,956eae17-7650-4470-94d2-4f61b9b02a23
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f,e0ae69a5-6322-4d7e-809d-59e02b51d71f
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNWXHNrdXNcMDBHMQ==?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 17:43:25 GMT
Content-Length: 1108

{
    "id": "00G1",
    "productId": "DZH318Z0BQ3V",
    "title": "Reserved VM Instance, Standard_D32s_v3, US West 2, 3 Years",
    "description": "Reserved Virtual Machines Instance, Standard_D32s_v3, US West 2, 3 Years",
    "minimumQuantity": 1,
    "maximumQuantity": 999999999,
    "isTrial": false,
    "supportedBillingCycles": [
        "one_time"
    ],
    "purchasePrerequisites": [
        "AzureSubscriptionRegistration",
        "InventoryCheck"
    ],
    "inventoryVariables": [
        "CustomerId",
        "AzureSubscriptionId"
    ],
    "provisioningVariables": [
        "Scope",
        "SubscriptionId"
    ],
    "dynamicAttributes": {
        "armSkuName": "Standard_D32s_v3",
        "cores": "32",
        "ram": "128",
        "skuDisplayName": "D32s v3",
        "category": "General purpose",
        "armRegionName": "westus2",
        "duration": "3Years",
        "region": "US West 2",
        "diskType": "Ssd"
    },
    "links": {
        "availabilities": {
            "uri": "/products/DZH318Z0BQ3V/skus/00G1/availabilities?country=us",
            "method": "GET",
            "headers": []
        },
        "self": {
            "uri": "/products/DZH318Z0BQ3V/skus/00G1?country=us",
            "method": "GET",
            "headers": []
        }
    }
}