Price Sheet - Download By Billing Account

Referência

Serviço:: Cost Management

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

Gera a folha de preços para o período de faturamento fornecido de forma assíncrona com base na ID de inscrição. Isso é para clientes do Enterprise Agreement.

Migrar para a versão 2024-08-01

Você pode usar a versão da API 2024-08-01 com o novo URI:

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

Com um novo esquema detalhado abaixo, a nova versão da planilha de preços fornece informações adicionais e inclui preços para Instâncias Reservadas (RI) do Azure para o período de cobrança atual. Recomendamos baixar uma Planilha de Preços do Azure para quando inserir um novo período de cobrança se você mantiver um registro contínuo de preços anteriores da Instância Reservada (RI) do Azure.

A folha de preços do EA Azure está disponível para períodos de faturação nos últimos 13 meses. Para solicitar uma planilha de preços para um período de faturamento superior a 13 meses, entre em contato com o suporte.

A experiência de download da folha de preços do Azure foi atualizada de um único arquivo .csv para um arquivo zip contendo vários arquivos .csv, cada um com tamanho máximo de 75MB. A versão 2023-11-01 foi atualizada para usar o método http POST; os detalhes podem ser encontrados abaixo.

Todas as versões da Folha de Preços do Azure.Consumption - Download por Conta de Cobrança (incluindo 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) estão programadas para serem desativadas em 01 de junho de 2026 e não serão mais suportadas após essa data.

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

Parâmetros do URI

Name Em Necessário Tipo Description

Name	Em	Necessário	Tipo	Description
billingAccountId	path	True	string	FaturaçãoID da conta
billingPeriodName	path	True	string	Nome do período de faturamento. Padrão Regex: `^[0-9]*$`
api-version	query	True	string	A versão da API a ser usada para esta operação.

billingAccountId

path

True

string

FaturaçãoID da conta

billingPeriodName

path

True

string

Nome do período de faturamento.

Padrão Regex: ^[0-9]*$

api-version

query

True

string

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

Respostas

Name	Tipo	Description
200 OK	OperationStatus	OK. O pedido foi bem-sucedido.
202 Accepted		Aceito. Cabeçalhos Location: string Retry-After: string
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Name

Tipo

Description

200 OK

OperationStatus

OK. O pedido foi bem-sucedido.

202 Accepted

Aceito.

Cabeçalhos

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

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

EAPriceSheetForBillingPeriod

Pedido de amostra

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

Resposta da amostra

Código de estado:: 202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

Código de estado:: 200

{
  "status": "Completed",
  "properties": {
    "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",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

Definições

Name	Description
EAPriceSheetProperties	As propriedades da tabela de preços do EA. As propriedades suportadas com a versão 2024-08-01 são as seguintes:
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".
OperationStatus	O status da operação de longa duração.
OperationStatusType	O status da operação de longa duração.

EAPriceSheetProperties

As propriedades da tabela de preços do EA. As propriedades suportadas com a versão 2024-08-01 são as seguintes:

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
currencyCode	string	Moeda em que o Enterprise Agreement foi assinado
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
enrollmentNumber	string	Identificador exclusivo da conta de faturação da EA.
includedQuantity	string	Quantidades de um serviço específico que um cliente EA tem direito a consumir sem encargos adicionais.
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. Nota: Para clientes EA sem negociações, o preço de mercado pode parecer arredondado para uma precisão decimal diferente do preço unitário.
meterCategory	string	Nome da categoria de classificação do contador. Por exemplo, serviços na nuvem, redes, etc.
meterId	string	Identificador único do contador
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
offerId	string	Determina a oferta do Azure associada a esse medidor. [Saiba mais sobre as ofertas do Azure] (https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	Número da peça associado ao 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.
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)
unitOfMeasure	string	Como o uso é medido para o serviço. Nota: O campo "Unidade" foi removido com a versão 2023-11-01 como uma duplicata de "UnitofMeasure", por favor use o campo "UnitOfMeasure".
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).

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.

OperationStatus

O status da operação de longa duração.

Name	Tipo	Description
properties.downloadFileProperties	EAPriceSheetProperties	As propriedades no arquivo baixado
properties.downloadUrl	string	O link (url) para baixar a folha de preços.
properties.validTill	string	Validade do link para download.
status	OperationStatusType	O status da operação de longa duração.

OperationStatusType

O status da operação de longa duração.

Name	Tipo	Description
Completed	string
Failed	string
Running	string

Partilhar via

Price Sheet - Download By Billing Account

Parâmetros do URI

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

EAPriceSheetForBillingPeriod

Pedido de amostra

Resposta da amostra

Definições

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

Recursos adicionais