Obter os preços do Microsoft AzureGet prices for Microsoft Azure

Aplica-se aApplies To

  • Partner CenterPartner Center
  • Partner Center do Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Partner Center do Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Como obter um cartão de taxas do Azure com preços em tempo real para uma oferta do Azure.How to get an Azure Rate Card with real-time prices for an Azure offer. O preço do Azure é bastante dinâmico e muda com frequência.Azure pricing is quite dynamic and changes frequently.

Para acompanhar o uso e ajudar a prever sua fatura mensal e as listas de clientes individuais, você pode combinar essa consulta de cartão de taxas do Azure para obter preços para Microsoft Azure com uma solicitação para obter os registros de utilização do cliente para o Azure.To track usage and help predict your monthly bill and the bills for individual customers, you can combine this Azure Rate Card query to get prices for Microsoft Azure with a request to Get a customer's utilization records for Azure.

Os preços diferem pelo mercado e pela moeda, e essa API leva o local em consideração.Prices differ by market and currency, and this API takes location into consideration. Por padrão, a API usa as configurações de perfil de parceiro no Partner Center e o idioma do navegador, e essas configurações são personalizáveis.By default, the API uses your partner profile settings in Partner Center and your browser language, and those settings are customizable. O reconhecimento de local é especialmente relevante se você gerencia vendas em vários mercados de um único escritório centralizado.The location awareness is especially relevant if you manage sales in multiple markets from a single, centralized office. Para obter mais informações, consulte parâmetros de URI.For more information, see URI parameters.

C#C#

Para obter o cartão de taxas do Azure, chame o método IAzureRateCard. Get para retornar um recurso AzureRateCard que contém os preços do Azure.To obtain the Azure Rate Card, call the IAzureRateCard.Get method to return an AzureRateCard resource that contains the Azure prices.

// IAggregatePartner partnerOperations;

var azureRateCard = partner.RateCards.Azure.Get();

Exemplo: aplicativo de teste do console.Sample: Console test app. Projeto: classede exemplos do SDK do Partner Center: GetAzureRateCard.csProject: Partner Center SDK Samples Class: GetAzureRateCard.cs

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 obter o cartão de taxas do Azure, chame a função IAzureRateCard. Get para retornar detalhes do cartão de taxa que contém os preços do Azure.To obtain the Azure Rate Card, call the IAzureRateCard.get function to return rate card details that contains the Azure prices.

// IAggregatePartner partnerOperations;

AzureRateCard azureRateCard = partner.getRateCards().getAzure().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 obter o cartão do Azure, execute o comando Get-PartnerAzureRateCard para retornar detalhes do cartão de taxa que contém os preços do Azure.To obtain the Azure Card, execute the Get-PartnerAzureRateCard command to return rate card details that contains the Azure prices.

Get-PartnerAzureRateCard

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/ratecards/Azure? moeda = {moeda} &região = {região}{baseURL}/v1/ratecards/azure?currency={currency}&region={region}

Parâmetros do URIURI parameters

NomeName TipoType ObrigatórioRequired DescriçãoDescription
Moedacurrency Cadeia de caracteresstring NoNo Código ISO opcional de três letras para a moeda na qual as taxas de recursos serão fornecidas (por exemplo EUR ).Optional three letter ISO code for the currency in which the resource rates will be provided (for example EUR). O padrão é USD.The default is USD.
regionregion Cadeia de caracteresstring NoNo Código de país/região ISO de duas letras opcional que indica o mercado no qual a oferta é adquirida (por exemplo FR ).Optional two-letter ISO country/region code that indicates the market where the offer is purchased (for example FR). O padrão é US.The default is US.

Você pode incluir o cabeçalho X-locale opcional em sua solicitação.You can include the optional X-Locale header in your request. Se você não incluir o cabeçalho X-locale, o valor padrão ("en-US") será usado.If you don't include the X-Locale header, the default value ("en-US") is used.

  • Se você fornecer parâmetros de moeda e região em sua solicitação, o valor de X-locale será usado para determinar o idioma da resposta.If you provide currency and region parameters in your request, the value of X-Locale is used to determine the response's language.

  • Se você não fornecer parâmetros de região e moeda em sua solicitação, o valor de X-locale será usado para determinar a região, a moeda e o idioma da resposta.If you don't provide region and currency parameters in your request, the value of X-Locale is used to determine the response's region, currency, and language.

Cabeçalho da solicitaçãoRequest header

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/ratecards/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 07ced227-3f32-4eeb-8062-f0bef849a9bc
MS-CorrelationId: a687bc47-8d08-4b78-aff6-5a59aa2055c2
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Resposta RESTREST response

Se a solicitação for bem-sucedida, ela retornará um recurso do cartão de taxas do Azure .If the request is successful, it returns an Azure Rate Card 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, confira Códigos de erro REST do Partner Center.For the full list, see Partner Center REST error codes.

Exemplo de respostaResponse example

HTTP/1.1 200 OK
Content-Length: 1545508
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 57b25659-fc00-4215-87e7-2b09bac6845d
MS-RequestId: 870118d0-adbb-41a3-82d2-a3d45ade3c73
MS-CV: CYBB8PXMsEukJBIn.0
MS-ServerId: 201021413
Date: Wed, 01 Feb 2017 00:13:45 GMT

{
    "locale": "en-US",
    "currency": "USD",
    "isTaxIncluded": false,
    "meters": [{
            "id": "4b836326-7e19-46e6-8bce-1b19bb6cd91e",
            "name": "Unlimited Data - 1 Gbps",
            "rates": {
                "0": 7395.0
            },
            "tags": [],
            "category": "Networking",
            "subcategory": "ExpressRoute",
            "region": "Zone 2",
            "unit": "Connections",
            "includedQuantity": 0.0,
            "effectiveDate": "2015-09-01T00:00:00Z"
        }, {
            "id": "1e8f6d9f-8b40-4c97-80cc-cff87a290a93",
            "name": "Compute Hours",
            "rates": {
                "0": 3.9729
            },
            "tags": [],
            "category": "Cloud Services",
            "subcategory": "Standard_L16 Cloud Services",
            "region": "AU East",
            "unit": "1 Hour",
            "includedQuantity": 0.0,
            "effectiveDate": "2016-09-01T00:00:00Z"
        }, {
            "id": "7a2639ce-ae47-4413-9837-6b4f4b78be3d",
            "name": "Compute Hours",
            "rates": {
                "0": 0.1122
            },
            "tags": [],
            "category": "Virtual Machines",
            "subcategory": "Standard_D1_v2 VM (Windows)",
            "region": "BR South",
            "unit": "Hours",
            "includedQuantity": 0.0,
            "effectiveDate": "2017-01-01T00:00:00Z"
        }
    ],
    "offerTerms": [{
            "name": "Overage discount",
            "discount": 0.15,
            "excludedMeterIds": ["53cc0061-0fe2-4249-bf62-e1008c811f5c", "c82dbd27-c978-43a7-ad41-525a90d8962b"],
            "effectiveDate": "2014-01-01T00:00:00"
        }
    ],
    "attributes": {
        "objectType": "AzureRateCard"
    }
}