Price Sheet - Download By Billing Profile

Referência

Serviço:: Cost Management

Versão da API:: 2024-08-01

Obtém uma URL para baixar a tabela de preços do mês atual para um perfil de cobrança. A operação tem suporte para contas de cobrança com o tipo de contrato Microsoft Partner Agreement ou Contrato de Cliente da Microsoft.

Você pode usar a nova versão da API 2023-09-01 para períodos de cobrança em janeiro de 2023 em diante. O preço da RI (Instância Reservada do Azure) só está disponível por meio da nova versão da API.

Devido ao crescimento do produto do Azure, a experiência de download da folha de preços do Azure nesta versão prévia será atualizada de um único arquivo csv/json para um arquivo Zip que contém vários arquivos csv/json, cada um com tamanho máximo de 75 MB.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description

billingAccountName

path

True

string

A ID que identifica exclusivamente uma conta de cobrança.

Padrão Regex: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

A ID que identifica exclusivamente um perfil de cobrança.

Padrão Regex: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

A versão da API a ser usada para esta operação.

Respostas

Nome

Tipo

Description

200 OK

PricesheetDownloadProperties

OKEY. A solicitação foi bem-sucedida.

202 Accepted

Aceitado.

Cabeçalhos

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

PricesheetDownloadByBillingProfile

Solicitação de exemplo

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Resposta de exemplo

Código de status:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

Código de status:: 200

{
  "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
  "expiryTime": "2018-07-21T17:32:28Z"
}

Definições

Nome	Description
ErrorDetails	Os detalhes do erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro. Algumas respostas de erro: 429 TooManyRequests – A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiceUnavailable – O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
MCAPriceSheetProperties	As propriedades da tabela de preços.
PricesheetDownloadProperties	A URL para baixar o relatório gerado.

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Description
code	string	Código de erro.
message	string	Mensagem de erro indicando por que a operação falhou.

ErrorResponse

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada. O motivo é fornecido na mensagem de erro.

Algumas respostas de erro:

429 TooManyRequests – A solicitação é limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiceUnavailable – O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Nome	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

MCAPriceSheetProperties

As propriedades da tabela de preços.

Nome	Tipo	Description
basePrice	string	O preço unitário no momento em que o cliente se conectar ou o preço unitário no momento da inicialização de GA do medidor de serviço, se for após o logon. Isso é aplicável para usuários do Contrato Enterprise
billingAccountID	string	Identificador exclusivo para a conta de cobrança.
billingAccountName	string	Nome do perfil de cobrança configurado para receber faturas. Os preços na tabela de preços estão associados a esse perfil de cobrança.
billingCurrency	string	Moeda na qual os encargos são postados.
billingProfileId	string	Identificador exclusivo para o perfil de cobrança.
billingProfileName	string	Nome do perfil de cobrança configurado para receber faturas. Os preços na tabela de preços estão associados a esse perfil de cobrança.
currency	string	Moeda na qual todos os preços são refletidos.
effectiveEndDate	string	Data de término efetiva do período de cobrança da Tabela de Preços
effectiveStartDate	string	Data de início efetiva do período de cobrança da Planilha de Preços
marketPrice	string	O preço de lista atual de um determinado produto ou serviço. Esse preço é sem nenhuma negociação e se baseia no tipo de Contrato da Microsoft. Para o Consumo de PriceType, o preço de mercado é refletido como o preço pago conforme o uso. Para o Plano de Poupança PriceType, o preço de mercado reflete o benefício do plano de poupança em cima do preço pago conforme o uso para o termo de compromisso correspondente. Para PriceType ReservedInstance, o preço de mercado reflete o preço total do compromisso de 1 ou 3 anos.
meterCategory	string	Nome da categoria de classificação para o medidor. Por exemplo, serviços de nuvem, rede etc.
meterName	string	Nome do medidor. O medidor representa o recurso implantável de um serviço do Azure.
meterRegion	string	Nome da região do Azure em que o medidor do serviço está disponível.
meterSubCategory	string	Nome da categoria de subclassificação do medidor.
meterType	string	Nome do tipo de medidor
priceType	string	Tipo de preço para um produto. Por exemplo, um recurso do Azure com uma taxa paga conforme o uso com priceType como Consumo. Outros tipos de preço incluem ReservedInstance e Savings Plan.
product	string	Nome do produto que acumula os encargos.
productId	string	Identificador exclusivo para o produto cujo medidor é consumido.
productOrderName	string	Nome do plano de produto comprado. Indica se esse preço é preço padrão do Plano do Azure, Preço de Desenvolvimento/Teste etc. Atualmente indisponível para medidores de terceiros e ReservedInstance do Azure.
serviceFamily	number	Tipo de serviço do Azure. Por exemplo, Computação, Análise e Segurança.
skuId	string	Identificador exclusivo da SKU
term	string	Duração do prazo para o plano de poupança do Azure ou prazo de reserva – um ano ou três anos (P1Y ou P3Y)
tierMinimumUnits	string	Define o limite inferior do intervalo de camadas para o qual os preços são definidos. Por exemplo, se o intervalo for de 0 a 100, tierMinimumUnits será 0.
unitOfMeasure	string	Como o uso é medido para o serviço
unitPrice	string	O preço por unidade no momento da cobrança de um determinado produto ou serviço, incluindo quaisquer descontos negociados sobre o preço de mercado. Para PriceType ReservedInstance, o preço unitário reflete o custo total do compromisso de 1 ou 3 anos, incluindo descontos. Observação: o preço unitário não é o mesmo que o preço efetivo nos downloads de detalhes de uso quando os serviços têm preços diferenciais entre camadas. Se os serviços tiverem preços de várias camadas, o preço efetivo será uma taxa combinada entre as camadas e não mostrará um preço unitário específico da camada. O preço combinado ou o preço efetivo é o preço líquido da quantidade consumida que abrange as várias camadas (em que cada camada tem um preço unitário específico).

PricesheetDownloadProperties

A URL para baixar o relatório gerado.

Nome	Tipo	Description
downloadFileProperties	MCAPriceSheetProperties	As propriedades no arquivo baixado
downloadUrl	string	A URL para baixar o relatório gerado.
expiryTime	string	A hora em que a URL do relatório se torna inválida/expira em UTC, por exemplo, 2020-12-08T05:55:59.4394737Z.