Price Sheet - Download By Billing Profile

Referência

Serviço:: Cost Management

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

Obtém um URL para baixar a planilha de preços do mês atual para um perfil de faturamento. A operação é suportada para contas de cobrança com tipo de contrato Contrato de Parceiro Microsoft ou Contrato de Cliente Microsoft.

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

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

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 do URI

Name Em Necessário Tipo Description

billingAccountName

path

True

string

O 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

O ID que identifica exclusivamente um perfil de faturamento.

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

Name

Tipo

Description

200 OK

PricesheetDownloadProperties

OK. O pedido foi bem-sucedido.

202 Accepted

Aceito.

Cabeçalhos

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

Other Status Codes

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

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

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

PricesheetDownloadByBillingProfile

Pedido de amostra

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 da amostra

Código de estado:: 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 estado:: 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

Name	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 está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after". 503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".
MCAPriceSheetProperties	As propriedades da folha de preços.
PricesheetDownloadProperties	O URL para baixar o relatório gerado.

ErrorDetails

Os detalhes do erro.

Name	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 está limitada. Tente novamente depois de aguardar o tempo especificado no cabeçalho "x-ms-ratelimit-microsoft.consumption-retry-after".
503 ServiçoIndisponível - O serviço está temporariamente indisponível. Tente novamente depois de aguardar o tempo especificado no cabeçalho "Retry-After".

Name	Tipo	Description
error	ErrorDetails	Os detalhes do erro.

MCAPriceSheetProperties

As propriedades da folha de preços.

Name	Tipo	Description
basePrice	string	O preço unitário no momento em que o cliente assina ou o preço unitário no momento do lançamento do GA do medidor de serviço, se for após o início de sessão. Isso é aplicável para usuários do Enterprise Agreement
billingAccountID	string	Identificador exclusivo da conta de cobrança.
billingAccountName	string	Nome do perfil de faturação configurado para receber faturas. Os preços na folha de preços estão associados a este perfil de faturação.
billingCurrency	string	Moeda na qual os encargos são lançados.
billingProfileId	string	Identificador exclusivo para o perfil de faturamento.
billingProfileName	string	Nome do perfil de faturação configurado para receber faturas. Os preços na folha de preços estão associados a este perfil de faturação.
currency	string	Moeda em que todos os preços são refletidos.
effectiveEndDate	string	Data de término efetiva do período de faturamento da Planilha de Preços
effectiveStartDate	string	Data de início efetiva do período de faturação da Folha de Preços
marketPrice	string	O preço de tabela atual para um determinado produto ou serviço. Este preço é sem qualquer negociação e baseia-se no seu tipo de Contrato Microsoft. Para PriceType Consumption, o preço de mercado é refletido como o preço pré-pago. 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 pré-pago para o prazo 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 do contador. Por exemplo, serviços na nuvem, redes, etc.
meterName	string	Nome do contador. O medidor representa o recurso implantável de um serviço do Azure.
meterRegion	string	Nome da região do Azure onde o medidor do serviço está disponível.
meterSubCategory	string	Nome da categoria de subclassificação do contador.
meterType	string	Nome do tipo de contador
priceType	string	Tipo de preço para um produto. Por exemplo, um recurso do Azure com uma taxa de pagamento conforme o uso com priceType como Consumo. Outros tipos de preços incluem ReservedInstance e Savings Plan.
product	string	Nome do produto que acumula os encargos.
productId	string	Identificador exclusivo do produto cujo medidor é consumido.
productOrderName	string	Nome do plano de produto adquirido. Indica se esse preço é padrão do Plano do Azure, preço de Desenvolvimento/Teste, etc. Atualmente indisponível para os medidores do Azure 3rd party e ReservedInstance.
serviceFamily	number	Tipo de serviço do Azure. Por exemplo, Computação, Análise e Segurança.
skuId	string	Identificador exclusivo do SKU
term	string	Duração do 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 níveis 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 unitário no momento da faturação de um determinado produto ou serviço, incluindo quaisquer descontos negociados em cima do 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. Nota: O preço unitário não é o mesmo que o preço efetivo nos downloads de detalhes de utilização quando os serviços têm preços diferenciados entre níveis. Se os serviços tiverem preços multicamadas, o preço efetivo será uma taxa combinada entre os níveis e não mostrará um preço unitário específico do nível. O preço combinado ou preço efetivo é o preço líquido da quantidade consumida abrangendo os vários níveis (em que cada nível tem um preço unitário específico).

PricesheetDownloadProperties

O URL para baixar o relatório gerado.

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