Price Sheet - Download By Billing Account

Referência

Serviço:: Cost Management

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

Gera a tabela de preços para o período de cobrança fornecido de forma assíncrona com base na ID de Registro. Isso é para clientes do Contrato Enterprise.

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 tabela de preços fornece informações adicionais e inclui preços para RI (Instâncias Reservadas do Azure) para o período de cobrança atual. Recomendamos baixar uma Tabela de Preços do Azure para ao entrar em um novo período de cobrança se você manter um registro contínuo de preços anteriores da RI (Instância Reservada do Azure).

A tabela de preços do Azure do EA está disponível para períodos de cobrança nos últimos 13 meses. Para solicitar uma tabela de preços para um período de cobrança com mais de 13 meses, entre em contato com o suporte.

A experiência de download da tabela 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 75 MB. 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 do Microsoft.Consumption Azure Price Sheet – Download by Billing Account (incluindo 2022-06-01, 2021-10-01, 2020-01-01-preview, 2019-10-01, 2019-05-01) estão programados para serem desativados em 01 de junho de 2026 e não terão mais suporte 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 de URI

Nome Em Obrigatório Tipo Description

Nome	Em	Obrigatório	Tipo	Description
billingAccountId	path	True	string	BillingAccount ID
billingPeriodName	path	True	string	Nome do período de cobrança. 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

BillingAccount ID

billingPeriodName

path

True

string

Nome do período de cobrança.

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

api-version

query

True

string

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

Respostas

Nome	Tipo	Description
200 OK	OperationStatus	OKEY. A solicitação foi bem-sucedida.
202 Accepted		Aceitado. Cabeçalhos Location: string Retry-After: string
Other Status Codes	ErrorResponse	Resposta de erro que descreve por que a operação falhou.

Nome

Tipo

Description

200 OK

OperationStatus

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

202 Accepted

Aceitado.

Cabeçalhos

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

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

EAPriceSheetForBillingPeriod

Solicitação de exemplo

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 de exemplo

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

Nome	Description
EAPriceSheetProperties	As propriedades da tabela de preços EA. As propriedades compatíveis 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 é 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".
OperationStatus	O status da operação de execução prolongada.
OperationStatusType	O status da operação de execução prolongada.

EAPriceSheetProperties

As propriedades da tabela de preços EA. As propriedades compatíveis com a versão 2024-08-01 são as seguintes

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
currencyCode	string	Moeda na qual o Contrato Enterprise foi assinado
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
enrollmentNumber	string	Identificador exclusivo para a conta de cobrança do EA.
includedQuantity	string	Quantidades de um serviço específico ao qual um cliente EA tem o direito de consumir sem encargos incrementais.
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. Observação: 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 para o medidor. Por exemplo, serviços de nuvem, rede etc.
meterId	string	Identificador exclusivo do medidor
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
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 de parte associado ao 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.
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)
unitOfMeasure	string	Como o uso é medido para o serviço. Observação: o campo "Unidade" foi removido com a versão 2023-11-01 como uma duplicata de "UnitofMeasure", use o campo "UnitOfMeasure".
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).

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.

OperationStatus

O status da operação de execução prolongada.

Nome	Tipo	Description
properties.downloadFileProperties	EAPriceSheetProperties	As propriedades no arquivo baixado
properties.downloadUrl	string	O link (url) para baixar a tabela de preços.
properties.validTill	string	Baixar a validade do link.
status	OperationStatusType	O status da operação de execução prolongada.

OperationStatusType

O status da operação de execução prolongada.

Nome	Tipo	Description
Completed	string
Failed	string
Running	string

Compartilhar via

Price Sheet - Download By Billing Account

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

EAPriceSheetForBillingPeriod

Solicitação de exemplo

Resposta de exemplo

Definições

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

Recursos adicionais