Entender os campos de detalhes de custo
Este documento descreve os campos de detalhes de custo (anteriormente conhecidos como detalhes de uso) encontrados em arquivos ao usar o download do portal do Azure, as Exportações do Gerenciamento de Custos ou a API de Detalhes de Custo. Para obter mais informações sobre as melhores práticas de detalhes de custo, consulte Escolher uma solução de detalhes de custo.
Migração para novos formatos de detalhes de custo
Se você estiver usando uma solução de detalhes de custo mais antiga e quiser migrar para Exportações ou a API de Detalhes de Custo, leia os artigos a seguir.
- Migrar das APIs de Detalhes de Uso da Empresa
- Migrar do EA para APIs MCA
- Migrar da API de Detalhes de Uso do Consumo
Observação
Todas as APIs do Azure Enterprise Reporting foram descontinuadas. Você deve Migrar para as APIs de Gerenciamento de Custos da Microsoft o mais rápido possível.
Lista de campos e descrições
A tabela a seguir descreve os termos importantes usados na versão mais recente do arquivo de detalhes de custo. A lista abrange contas pré-pagas (também chamadas de Programa de Serviços Online da Microsoft), Enterprise Agreement (EA), Contrato de Cliente da Microsoft (MCA) e Contrato de Parceiro da Microsoft (MPA).
As contas de MPA têm todos os termos de MCA, além dos termos de MPA, conforme descrito na tabela a seguir. Para identificar qual tipo de conta você é, consulte as ofertas compatíveis do Microsoft Azure.
Termo | Tipo de conta | Descrição |
---|---|---|
AccountId | EA, pay-as-you-go | Identificador exclusivo para a conta de registro do EA. |
AccountName | EA, pay-as-you-go | Nome de exibição da conta de registro de EA ou da conta de cobrança pay-as-you-go. |
AccountOwnerId¹ | EA, pay-as-you-go | A ID de email do proprietário da conta de registro do EA. |
AdditionalInfo¹ | Todos | Metadados específicos ao serviço. Por exemplo, um tipo de imagem para uma máquina virtual. |
AvailabilityZone | Conta externa | Válido somente para dados de custo obtidos do conector entre nuvens. O campo exibe a zona de disponibilidade na qual o serviço da AWS é implantado. |
BenefitId¹ | EA, MCA | Identificador exclusivo da instância do plano de economia comprado. |
BenefitName | EA, MCA | Identificador exclusivo da instância do plano de economia comprado. |
BillingAccountId¹ | Todos | Identificador exclusivo da conta de cobrança raiz. |
BillingAccountName | Todos | Nome da conta de cobrança. |
BillingCurrency | Todos | Moeda associada à conta de cobrança. |
BillingCurrencyCode | Tudo | Confira BillingCurrency. |
BillingPeriod | EA, pay-as-you-go | O período de cobrança do encargo. |
BillingPeriodEndDate | Todos | A data de término do período de cobrança. |
BillingPeriodStartDate | Todos | A data de início do período de cobrança. |
BillingProfileId¹ | Tudo | Identificador exclusivo do registro de EA, assinatura de pagamento conforme o uso, perfil de cobrança do MCA ou conta consolidada da AWS⁴. |
BillingProfileName | Tudo | Nome do registro de EA, assinatura de pagamento conforme o uso, perfil de cobrança do MCA ou conta consolidada da AWS⁴. |
ChargeType | Todos | Indica se o encargo representa o uso (Usage), a compra (Purchase) ou um reembolso (Refund). |
ConsumedService | Todos | Nome do serviço ao qual a cobrança está associada. |
CostCenter¹ | EA, MCA | O centro de custo definido para a assinatura para acompanhar custos (disponível apenas em períodos de cobrança abertos para contas MCA). |
Custo | EA, pay-as-you-go | Confira CostInBillingCurrency. |
CostAllocationRuleName | EA, MCA | Nome da regra de alocação de custos aplicável ao registro. |
CostInBillingCurrency | EA, MCA | Custo do encargo na moeda da cobrança antes de créditos ou impostos. |
CostInPricingCurrency | MCA | Custo do encargo na moeda do preço antes de créditos ou impostos. |
Moeda | EA, pay-as-you-go | Consulte BillingCurrency . |
CustomerName | MPA | Nome do locatário do Microsoft Entra para a assinatura do cliente. |
CustomerTenantId | MPA | Identificador do locatário do Microsoft Entra da assinatura do cliente. |
Date¹ | Todos | A data de uso ou de compra do encargo. |
EffectivePrice² ³ | Tudo | O preço de um determinado produto ou serviço que representa a taxa real que você acaba pagando por unidade. |
ExchangeRateDate | MCA | Data em que a taxa de câmbio foi estabelecida. |
ExchangeRatePricingToBilling | MCA | Taxa de câmbio usada para converter o custo na moeda do preço na moeda de cobrança. |
Frequência | Todos | Indica se espera-se que um encargo se repita. Os encargos podem ocorrer uma vez (OneTime), repetir-se por mês ou ano (Recurring) ou ser baseados no uso (UsageBased). |
InvoiceId | pay-as-you-go, MCA | A ID de documento exclusiva listada no PDF da fatura. |
InvoiceSection | MCA | Consulte InvoiceSectionName . |
InvoiceSectionId¹ | EA, MCA | Identificador exclusivo do departamento de EA ou da seção da fatura de MCA. |
InvoiceSectionName | EA, MCA | Nome do departamento de EA ou da seção da fatura de MCA. |
IsAzureCreditEligible | Todos | Indica se o encargo está qualificado a ser pago pelo uso de créditos Azure (valores: True ou False ). |
Location | MCA | O local normalizado usado para resolver inconsistências em nomes de região enviados por diferentes Provedores de recursos (RPs) do Azure. O local normalizado baseia-se estritamente no local do recurso enviado pelos RPs nos dados de uso e é normalizado programaticamente para reduzir inconsistências. As compras e o uso do Marketplace podem ser mostrados como em branco ou não atribuídos. Por exemplo, US East . |
MeterCategory | Todos | Nome da categoria de classificação do medidor. Por exemplo, Serviços de Nuvem e Rede etc. As compras e o uso do Marketplace podem ser mostrados em branco ou unassigned . |
MeterId¹ | Todos | O identificador exclusivo do medidor. |
MeterName | Todos | O nome do medidor. As compras e o uso do Marketplace podem ser mostrados em branco ou unassigned . |
MeterRegion | Tudo | O nome da região do Azure associada ao medidor. Ele geralmente está alinhado ao local do recurso, exceto para determinados medidores globais que são compartilhados entre regiões. Nesses casos, a região do medidor indica a região primária do medidor. Observação: o medidor é usado para controlar o uso de serviços ou recursos específicos, principalmente para fins de cobrança. Cada serviço, recurso e região do Azure tem a própria ID do medidor de cobrança que reflete precisamente como seu consumo e preço são calculados. |
MeterSubCategory | Todos | Nome da categoria de subclassificação do medidor. As compras e o uso do Marketplace podem ser mostrados em branco ou unassigned . |
OfferId¹ | EA, pay-as-you-go | Nome da oferta do Azure, que é o tipo de assinatura do Azure que você tem. Para obter mais informações, consulte Detalhes da oferta do Microsoft Azure com Suporte. |
pay-as-you-goPrice² ³ | Tudo | O preço de mercado, também conhecido como preço de varejo ou de lista, para um determinado produto ou serviço. Para obter mais informações, consulte o Comportamento de preços nos detalhes de custo. |
PartnerEarnedCreditApplied | MPA | Indica se o crédito ganho pelo parceiro foi aplicado. |
PartnerEarnedCreditRate | MPA | Taxa de desconto aplicada se há um PEC (crédito ganho pelo parceiro) com base no acesso ao link de administrador do parceiro. |
PartnerName | MPA | Nome do locatário do Microsoft Entra parceiro. |
PartnerTenantId | MPA | Identificador do locatário do Microsoft Entra do parceiro. |
PartNumber¹ | EA, pay-as-you-go | Identificador usado para obter preços de medidor específicos. |
PlanName | EA, pay-as-you-go | Nome do plano do Marketplace. |
PreviousInvoiceId | MCA | Referência a uma fatura original se o item de linha for um reembolso. |
PricingCurrency | MCA | Moeda usada ao classificar com base em preços negociados. |
PricingModel | Todos | Identificador que indica como o medidor é cobrado. (Valores: OnDemand , Reservation , Spot e SavingsPlan ) |
Product | Todos | O nome do produto. |
ProductId¹ | MCA | Identificador exclusivo do produto. |
ProductOrderId | Todos | Identificador exclusivo do pedido do produto. |
ProductOrderName | Todos | Nome exclusivo do pedido do produto. |
Provedor | MCA | Identificador para categoria de produto ou linha de negócios. Por exemplo, Azure, Microsoft 365 e AWS⁴. |
PublisherId | MCA | A ID do Publicador. Só estará disponível depois que a fatura for gerada. |
PublisherName | Tudo | O nome do publicador. Para serviços de primeira parte, o valor deve ser listado como Microsoft ou Microsoft Corporation . |
PublisherType | Tudo | Valores com suporte: Microsoft, Azure, AWS⁴, Marketplace. Em contas MCA, o valor pode ser Microsoft para cobranças do usuário principal e Marketplace para cobranças de terceiros. Para contas EA e pagas conforme o uso, o valor é Azure . |
Quantity³ | Tudo | O número de unidades usadas pelo produto ou serviço especificado para um determinado dia. |
ResellerName | MPA | O nome do revendedor associado à assinatura. |
ResellerMpnId | MPA | ID do revendedor associado à assinatura. |
ReservationId¹ | EA, MCA | Identificador exclusivo da instância de reserva comprada. |
ReservationName | EA, MCA | Nome da instância de reserva comprada. |
ResourceGroup | Todos | Nome do grupo de recursos no qual o recurso está. Nem todos os encargos são provenientes de recursos implantados em grupos de recursos. Os encargos que não têm um grupo de recursos serão mostrados como nulo ou vazio, Outros ou Não aplicável. |
ResourceId¹ | Todos | Identificador exclusivo do recurso Azure Resource Manager. |
ResourceLocation¹ | Tudo | A região do Azure em que o recurso é implantado, também conhecida como o local do datacenter em que o recurso está sendo executado. Para obter um exemplo usando máquinas virtuais, consulte Qual é a diferença entre MeterRegion e ResourceLocation. |
ResourceLocationNormalized | Tudo | Formato padronizado da região do Azure em que o recurso está implantado, também chamado de local do datacenter em que o recurso está sendo executado. O local normalizado usado para resolver inconsistências em nomes de região enviados por diferentes (RPs) Provedores de Recursos do Azure. |
ResourceName | EA, pay-as-you-go | Nome do recurso. Nem todos os encargos são provenientes de recursos implantados. Os encargos que não têm um tipo de recurso serão mostrados como nulo/vazio, Outros ou Não aplicável. |
ResourceType | MCA | Tipo de instância do recurso. Nem todos os encargos são provenientes de recursos implantados. Os encargos que não têm um tipo de recurso serão mostrados como nulo/vazio, Outros ou Não aplicável. |
RoundingAdjustment | EA, MCA | O ajuste de arredondamento representa a quantificação que ocorre durante o cálculo de custo. Quando os custos calculados são convertidos no total faturado, pequenos erros de arredondamento podem ocorrer. Os erros de arredondamento são representados como rounding adjustment para garantir que os custos mostrados no Gerenciamento de Custos se alinhem à fatura. Para obter mais informações, consulte Detalhes de ajuste de arredondamento. |
ServiceFamily | MCA | Família de serviços ao qual o serviço pertence. |
ServiceInfo1 | Tudo | Metadados específicos ao serviço. |
ServiceInfo2 | Todos | Campo herdado com metadados opcionais específicos do serviço. |
ServicePeriodEndDate | MCA | A data de término do período de classificação que definiu e bloqueou o preço para o serviço consumido ou comprado. |
ServicePeriodStartDate | MCA | A data de início do período de classificação que definiu e bloqueou o preço para o serviço consumido ou comprado. |
SubscriptionId¹ | Todos | Identificador exclusivo da assinatura do Azure. |
SubscriptionName | Todos | Nome da assinatura do Azure. |
Tags¹ | Todos | Marcas atribuídas ao recurso. Não inclui marcas do grupo de recursos. Podem ser usadas para agrupar ou distribuir custos para estorno interno. Para saber mais, confira Organizar os recursos do Azure com marcas. |
Termo | Todos | Exibe o prazo de validade da oferta. Por exemplo: no caso de instâncias reservadas, exibe os 12 meses como o Prazo. Para compras avulsas ou recorrentes, o prazo é um mês (SaaS, suporte do Marketplace). Não aplicável para consumo do Azure. |
UnitOfMeasure | Todos | A unidade de medida para cobrança do serviço. Por exemplo, os serviços de computação são cobrados por hora. |
UnitPrice² | Tudo | O preço de um determinado produto ou serviço, incluindo qualquer desconto negociado que você possa ter sobre o preço de mercado (coluna de preço PayG ) para o seu contrato. Para obter mais informações, consulte o Comportamento de preços nos detalhes de custo. |
¹ Campos usados para criar uma ID exclusiva para um registro de custo único. Cada registro no arquivo de detalhes de custo deve ser considerado exclusivo.
² Para clientes do MCA, os preços são mostrados na moeda de preços nos relatórios Custo Real e Custo Amortizado. Por outro lado, para os clientes do EA, as moedas de cobrança e preços são as mesmas.
³ Para obter mais informações sobre termos e definições de preços, consulte Comportamento de preços nos detalhes de custo.
⁴O Connector for AWS no serviço Gerenciamento de Custos da Microsoft será desativado em 31 de março de 2025. Os usuários devem considerar soluções alternativas para relatórios de gerenciamento de custos da AWS. Em 31 de março de 2024, o Azure desabilitará a capacidade de adicionar novos Conectores para AWS para todos os clientes. Para obter mais informações, consulte Desativar seu conector do AWS (Amazon Web Services).
O próprio arquivo de detalhes de custo não identifica exclusivamente os registros individuais com uma ID. Em vez disso, você pode usar os campos no arquivo sinalizado com ¹ para criar uma ID exclusiva por conta própria.
Alguns campos podem ser diferentes na grafia de maiúsculas e minúsculas e no espaçamento entre os tipos de conta. Versões mais antigas de arquivos de detalhes de custo pago conforme o uso têm seções separadas para a instrução e o custo diário.
Os números de parte na fatura do EA também estão no arquivo de custo e uso
Registros no arquivo de custo e uso e outras experiências de gerenciamento de custos, como análise de custos, incluem números de parte correspondentes a eles com os números de parte na fatura do EA. Os números de parte no arquivo de custo e uso são mostrados apenas para clientes EA.
- Números de parte são mostrados para todos os registros de uso.
- Os números de parte são mostrados para todos os registros de compra e reembolso.
Os números de parte são os mesmos na fatura e nos detalhes do arquivo de custo e uso para todos os tipos de cobrança, excluindo o Plano de Poupança do Azure e as reservas de pré-compra. Atualmente, eles não têm um número de parte no arquivo de detalhes de custo e uso.
Reconciliar encargos no arquivo de detalhes de custo e uso
Os clientes do MCA (Contrato de Cliente da Microsoft) podem usar as informações a seguir para reconciliar encargos entre moedas de cobrança e preços.
Calcule manualmente o
CostInPricingCurrency
por:(EffectivePrice)
*(Quantity)
Converta o calculado
CostInPricingCurrency
para oCostInBillingCurrency
por:(CalculatedCostinPricingCurrency)
*(ExchangeRatePricingToBilling)
Resumir os valores calculados
CostInBillingCurrency
e compare-os com a fatura.
Os clientes do EA (Contrato Enterprise) podem reconciliar seus encargos usando a seguinte computação:
Calcule manualmente o custo multiplicando o Preço Efetivo pela Quantidade:
Cost
= (EffectivePrice)
* (Quantity)
Reconciliar compras de reserva com registros de uso
Cada registro de compra e uso de reserva tem duas IDs associadas: ReservationId
e ProductOrderId
.
- Registros de compra de reserva (
PricingModel
=Reservation
,ChargeType
=Purchase
):- Os registros carregam a ID do pedido de compra como
ProductOrderId
. - Além disso, eles carimbam a mesma ID do pedido de compra como
ReservationId
.
- Os registros carregam a ID do pedido de compra como
- Registros de uso de reserva (
PricingModel
=Reservation
,ChargeType
=Usage
/UnusedReservation
):- Assim como os registros de compra, os registros de uso também carregam a ID do pedido de compra como
ProductOrderId
. - No entanto, o
ReservationId
pode ser diferente, pois ele é atribuído aos recursos que se beneficiaram da reserva. - Lembre-se que ações como divisão, mesclagem, reembolso parcial ou troca podem criar novas reservas.
- Assim como os registros de compra, os registros de uso também carregam a ID do pedido de compra como
Embora o próprio ReservationId
possa ser diferente, ainda faz parte da mesma ordem. Portanto, o ProductOrderId
pode ser usado efetivamente para associar a compra ao registro de uso, facilitando a reconciliação entre compras de reserva e uso.
Tipo de registro | ReservationId |
ProductOrderId |
---|---|---|
Registro de compra de reserva (custo real) | ID da ordem de compra | ID da ordem de compra |
Registro de uso de reserva (amortizado e custo real) | ID de reserva diferente | ID da ordem de compra |
Para obter mais informações, confira Gerenciar Reservas para recursos do Azure.
Identificar encargos de EA para quantidade incluída
A IQ (quantidade incluída) refere-se à quantidade de um recurso medido que pode ser consumido sem incorrer em nenhum custo extra em um Enterprise Agreement. Ao lidar com a IQ, considere os seguintes pontos:
Características do medidor: os medidores associados à IQ exibem características específicas no arquivo de custo porque os medidores permitem o consumo sem encargos extras. No arquivo de custo, um medidor com IQ tem:
- ChargeType: Uso, PricingModel: OnDemand.
- Preço unitário, preço efetivo e Custo definido como 0, porque você não é cobrado pelo consumo.
- Quantidade não é zero. Ele mostra o consumo real do medidor.
- No entanto, o Preço PayG (pagamento conforme o uso) ainda mostra o preço de varejo, que não é zero.
Detalhes de ajuste de arredondamento
Por que temos ajuste de arredondamento?
Todo sistema financeiro envolve lógica de arredondamento, o que pode causar alguma variação. As faturas agregam custos mensais no nível do medidor, com custos arredondados dependendo da moeda. Por outro lado, o arquivo de custo contém custos no nível da instância de recurso com maior precisão. Essa diferença resulta em uma variação no custo total entre a fatura e o arquivo de custo. O ajuste de arredondamento é fornecido no arquivo de custo em um nível agregado sempre que a fatura estiver pronta, garantindo que os custos totais em ambos os arquivos correspondam.
Observação: dois ajustes de arredondamento separados são fornecidos: um para registros de primeira parte e outro para registros do marketplace. Esses ajustes não estão disponíveis durante um mês aberto e ficam visíveis quando o mês é fechado e a fatura é gerada.
Os clientes podem espalhar o ajuste de arredondamento sobre detalhes mais finos, como recursos individuais, grupos de recursos ou assinaturas inteiras. Você pode usar uma média ponderada ou usar técnicas semelhantes.
Arredondando o registro de ajuste no arquivo de custo
O registro de ajuste de arredondamento está disponível no arquivo Detalhes de Custo no escopo de Perfil de Cobrança para um MCA (Contrato de Cliente da Microsoft) ou no escopo de Registro do EA (Contrato Enterprise). Como esse é um valor agregado disponível no nível da fatura, não há informações de nível inferior de escopo disponíveis para o registro. Os seguintes campos são válidos para um registro de ajuste de arredondamento:
BillingAccountId
BillingAccountName
BillingPeriodStartDate
BillingPeriodEndDate
BillingProfileId
BillingProfileName
Os campos MeterCategory
, MeterSubCategory
e ChargeType
têm o valor como RoundingAdjustment
.
Ilustração do ajuste de arredondamento
Suponha que você tenha dois recursos em sua assinatura: A e B. O recurso A custa US$ 0,1234 por hora e o recurso B custa US$ 0,5678 por hora. Você usa os dois recursos por 10 horas por dia, portanto, o custo total de cada recurso é:
- Resource A: $0,1234 x 10 = $1,234
- Recurso B: $0,5678 x 10 = $5,678
O custo total do dia é de US$ 1,234 + US$ 5,678 = US$ 6,912.
No entanto, quando a fatura é gerada, os custos são arredondados para duas casas decimais, portanto, a fatura mostra:
- Recurso A: $1,23
- Recurso B: $5,68
- Total = $6,91
A diferença entre o total da fatura e o total real é de US$ 0,002, que é o ajuste de arredondamento. Para garantir que os custos de Gerenciamento de Custos correspondam à fatura, um valor de -US$ 0,002 é mostrado no arquivo de custo como o ajuste de arredondamento após a geração da fatura.
Lista de termos de APIs mais antigas
A tabela a seguir mapeia termos usados em APIs mais antigas para os novos termos. Consulte a tabela anterior para obter descrições.
Termo antigo | Termo novo |
---|---|
ConsumedQuantity | Quantidade |
IncludedQuantity | N/D |
InstanceId | ResourceId |
Tarifa | EffectivePrice |
Unidade | UnitOfMeasure |
UsageDate | Data |
UsageEnd | Data |
UsageStart | Data |
Conteúdo relacionado
- Obtenha uma visão geral de como ingerir dados de custo.
- Saiba mais sobre Escolher uma solução de detalhes de custo.
- Crie e gerencie dados exportados no portal do Azure com Exportações.
- Automatize a criação e a ingestão de exportação em escala usando a API.
- Veja como Obter pequenos conjuntos de dados de custo sob demanda.