Compreender os campos de detalhes de custo
Este documento descreve os campos de detalhes de custo (anteriormente conhecidos como detalhes de uso) encontrados em arquivos do uso do download do portal do Azure, Exportações do Gerenciamento de Custos ou a API de Detalhes de Custo . Para obter mais informações sobre as práticas recomendadas 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 de APIs de Detalhes de Uso Corporativo
- Migrar de APIs EA para MCA
- Migrar da API de Detalhes de Uso de Consumo
Nota
Todas as APIs do Azure Enterprise Reporting são desativadas. Você deve migrar para as APIs do Microsoft Cost Management 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 Microsoft Online Services), Enterprise Agreement (EA), Microsoft Customer Agreement (MCA) e Microsoft Partner Agreement (MPA).
As contas MPA têm todos os termos MCA, além dos termos MPA, conforme descrito na tabela a seguir. Para identificar o tipo de conta que você é, consulte Ofertas suportadas do Microsoft Azure.
Termo | Tipo de conta | Description |
---|---|---|
AccountId | EA, pré-pago conforme o uso | Identificador exclusivo para a conta de inscrição do EA. |
AccountName | EA, pré-pago conforme o uso | Nome de exibição da conta de inscrição EA ou da conta de cobrança pré-paga. |
AccountOwnerId¹ | EA, pré-pago conforme o uso | O ID de e-mail do proprietário da conta de inscrição EA. |
AdicionalInfo¹ | Todos | Metadados específicos do serviço. Por exemplo, um tipo de imagem de uma máquina virtual. |
AvailabilityZone | Conta externa | Válido apenas para dados de custo obtidos a partir do conector cross-cloud. O campo exibe a zona de disponibilidade na qual o serviço da AWS é implantado. |
BenefitId¹ | EA, MCA | Identificador exclusivo para a instância do plano de poupança comprado. |
Nome do Benefício | EA, MCA | Identificador exclusivo para a instância do plano de poupança comprado. |
BillingAccountId¹ | Todos | Identificador exclusivo da conta de faturação raiz. |
BillingAccountName | Todos | Nome da conta de faturação. |
BillingCurrency | Todos | Moeda associada à conta de faturação. |
FaturaçãoMoedaCódigo | Todos | Veja BillingCurrency. |
BillingPeriod | EA, pré-pago conforme o uso | O período de faturação do custo. |
BillingPeriodEndDate | Todos | A data de fim do período de faturação. |
BillingPeriodStartDate | Todos | A data de início do período de faturação. |
BillingProfileId¹ | Todos | Identificador exclusivo da inscrição EA, assinatura pré-paga, perfil de faturamento MCA ou conta consolidada AWS⁴. |
BillingProfileName | Todos | Nome da inscrição EA, assinatura pré-paga, perfil de faturamento MCA ou conta consolidada AWS⁴. |
ChargeType | Todos | Indica se o custo representa a utilização (Utilização), uma compra (Compra) ou um reembolso (Reembolso). |
ConsumedService | Todos | Nome do serviço ao qual o custo está associado. |
CustoCenter¹ | EA, MCA | O centro de custos definido para a subscrição para controlar os custos (apenas disponível nos períodos de faturação abertos para as contas MCA). |
Custo | EA, pré-pago conforme o uso | Veja CostInBillingCurrency. |
CostAllocationRuleName | EA, MCA | Nome da regra de Alocação de Custos aplicável ao registro. |
CostInBillingCurrency | EA, MCA | Custo do encargo na moeda de faturação antes dos créditos ou dos impostos. |
CostInPricingCurrency | MCA | Custo do encargo na moeda do preço antes dos créditos ou dos impostos. |
Moeda | EA, pré-pago conforme o uso | 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. |
Data¹ | Todos | A data de utilização ou de compra à qual corresponde o custo. |
Preço² Efetivo³ | Todos | 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 utilizada para converter o custo da moeda do preço na moeda de faturação. |
Frequência | Todos | Indica se é esperado que um encargo se repita. O encargo pode ocorrer uma vez (OneTime), repetir-se mensalmente ou anualmente (Recorrente) ou basear-se na utilização (UsageBased). |
InvoiceId | pagamento conforme o uso, MCA | O ID exclusivo do documento listado no PDF da fatura. |
InvoiceSection | MCA | Consulte InvoiceSectionName . |
InvoiceSectionId¹ | EA, MCA | Identificador exclusivo do departamento do EA ou da secção da fatura do MCA. |
InvoiceSectionName | EA, MCA | Nome do departamento do EA ou da secção da fatura do MCA. |
IsAzureCreditEligible | Todos | Indica se a cobrança é elegível para ser paga pelo uso de créditos do 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 é baseado estritamente no local do recurso enviado pelos RPs nos dados de uso e é programaticamente normalizado para mitigar 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 cloud e Rede. As compras e o uso do Marketplace podem ser mostrados como 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 como em branco ou unassigned . |
MeterRegion | Todos | O nome da região do Azure associada ao medidor. Geralmente, ele se alinha com a localização do recurso, exceto para certos medidores globais que são compartilhados entre regiões. Nesses casos, a região do medidor indica a região primária do medidor. Nota: O contador é utilizado para acompanhar a utilização de serviços ou recursos específicos, principalmente para efeitos de faturação. Cada serviço, recurso e região do Azure tem sua própria ID de medidor de cobrança que reflete com precisão 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 como em branco ou unassigned . |
OfferId¹ | EA, pré-pago conforme o uso | 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 suportada. |
Preço² ³ | Todos | O preço de mercado, também referido como preço de venda a retalho ou preço de tabela, para um determinado produto ou serviço. Para obter mais informações, consulte Comportamento de preços em detalhes de custo. |
PartnerEarnedCreditApplied | MPA | Indica se o crédito ganho pelo parceiro foi aplicado. |
PartnerEarnedCreditRate | MPA | Taxa de desconto aplicada se houver um crédito ganho pelo parceiro (PEC), com base no acesso ao link de administrador do parceiro. |
PartnerName | MPA | Nome do locatário parceiro do Microsoft Entra. |
PartnerTenantId | MPA | Identificador do locatário do Microsoft Entra do parceiro. |
Número da peça¹ | EA, pré-pago conforme o uso | Identificador utilizado para obter preços específicos do medidor. |
PlanName | EA, pré-pago conforme o uso | Nome do plano do Marketplace. |
PreviousInvoiceId | MCA | Referência a uma fatura original se o item de linha for um reembolso. |
PricingCurrency | MCA | Moeda utilizada aquando da classificação baseada nos preços negociados. |
PricingModel | Todos | Identificador que indica como é definido o preço do medidor. (Valores: OnDemand , Reservation , Spot , e SavingsPlan ) |
Produto | Todos | Nome do produto. |
ProductId¹ | MCA | Identificador exclusivo do produto. |
ProductOrderId | Todos | Identificador exclusivo da encomenda do produto. |
ProductOrderName | Todos | Nome exclusivo da encomenda do produto. |
Provider | MCA | Identificador para categoria de produto ou linha de negócios. Por exemplo, Azure, Microsoft 365 e AWS⁴. |
PublisherId | MCA | O ID do editor. Só está disponível depois de a fatura ser gerada. |
Nome do Editor | Todos | O nome do editor. Para serviços primários, o valor deve ser listado como Microsoft ou Microsoft Corporation . |
PublisherType | Todos | Valores suportados: Microsoft, Azure, AWS⁴, Marketplace. Para contas MCA, o valor pode ser Microsoft para encargos de primeira parte e Marketplace para encargos de terceiros. Para contas EA e pay-as-you-go, o valor é Azure . |
Quantidade³ | Todos | O número de unidades utilizadas pelo determinado produto ou serviço para um determinado dia. |
ResellerName | MPA | O nome do revendedor associado à assinatura. |
RevendedorMpnId | MPA | ID do revendedor associado à subscrição. |
ReservationId¹ | EA, MCA | Identificador exclusivo da instância da reserva comprada. |
ReservationName | EA, MCA | Nome da instância da reserva comprada. |
ResourceGroup | Todos | Nome do grupo de recursos no qual se encontra o recurso. Nem todos os custos provêm de recursos implementados em grupos de recursos. As cobranças que não têm um grupo de recursos são mostradas como nulas ou vazias, Outras ou Não aplicáveis. |
ResourceId¹ | Todos | Identificador exclusivo do recurso Azure Resource Manager. |
ResourceLocation¹ | Todos | A região do Azure onde o recurso é implantado, também conhecida como o local do datacenter onde o recurso está sendo executado. Para obter um exemplo usando máquinas virtuais, consulte Qual é a diferença entre MeterRegion e ResourceLocation. |
ResourceLocationNormalizado | Todos | Formato padronizado da região do Azure onde o recurso é implantado, também conhecido como o local do datacenter onde o recurso está sendo executado. O local normalizado é usado para resolver inconsistências em nomes de região enviados por diferentes Provedores de Recursos (RPs) do Azure. |
ResourceName | EA, pré-pago conforme o uso | Nome do recurso. Nem todos os custos são provenientes de recursos implementados. As cobranças que não têm um tipo de recurso são mostradas como nulas/vazias, Outras ou Não aplicáveis. |
ResourceType | MCA | Tipo da instância do recurso. Nem todos os custos são provenientes de recursos implementados. As cobranças que não têm um tipo de recurso são mostradas como nulas/vazias, Outras ou Não aplicáveis. |
RoundingAdjustment | EA, MCA | O ajustamento de arredondamento representa a quantização que ocorre durante o cálculo de custo. Quando os custos calculados são convertidos para o total faturado, podem ocorrer pequenos erros de arredondamento. Os erros de arredondamento são representados para rounding adjustment garantir que os custos mostrados no Gerenciamento de custos estejam alinhados à fatura. Para obter mais informações, consulte Detalhes do ajuste de arredondamento. |
ServiceFamily | MCA | Família de serviços à qual o serviço pertence. |
ServiceInfo1 | Todos | Metadados específicos do serviço. |
ServiceInfo2 | Todos | Campo legado com metadados opcionais e específicos do serviço. |
ServicePeriodEndDate | MCA | A data de fim do período de classificação que definiu e bloqueou o preço do 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 do serviço consumido ou comprado. |
SubscriptionId¹ | Todos | Identificador exclusivo da subscrição do Azure. |
SubscriptionName | Todos | Nome da subscrição do Azure. |
Tags¹ | Todos | Etiquetas atribuídas ao recurso. Não inclui etiquetas de grupos de recursos. Podem ser utilizada para agrupar ou distribuir encargos para estorno interno. Para obter mais informações, veja Organize your Azure resources with tags (Organizar os recursos do Azure com etiquetas). |
Termo | Todos | Apresenta o termo da validade da oferta. Por exemplo: Para instâncias reservadas, ele exibe 12 meses como o Termo. Para compras únicas ou recorrentes, o prazo é de um mês (SaaS, Suporte do Marketplace). Não aplicável ao consumo do Azure. |
UnitOfMeasure | Todos | Unidade de medida da faturação do serviço. Por exemplo, os serviços de computação são faturados à hora. |
PreçoUnitário² ³ | Todos | O preço de um determinado produto ou serviço, incluindo qualquer desconto negociado que possa ter em cima do preço de mercado (PayG coluna de preço) do seu contrato. Para obter mais informações, consulte Comportamento de preços em detalhes de custo. |
¹ Campos usados para criar um ID exclusivo para um único registro de custo. Cada registro em seu arquivo de detalhes de custo deve ser considerado único.
² Para clientes MCA, os preços são mostrados na moeda de preço nos relatórios de Custo Real e Custo Amortizado. Em contraste, para os clientes EA, as moedas de faturamento e preço são as mesmas.
³ Para obter mais informações sobre termos e definições de preços, consulte Comportamento de preços em detalhes de custo.
⁴ O conector para AWS no serviço de gerenciamento de custos é 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 desativará a capacidade de adicionar novos conectores para AWS para todos os clientes. Para obter mais informações, consulte Desativar o conector da Amazon Web Services (AWS).
O arquivo de detalhes de custo em si não identifica exclusivamente registros individuais com um ID. Em vez disso, você pode usar campos no arquivo sinalizado com ¹ para criar um ID exclusivo por conta própria.
Alguns campos podem diferir em invólucro e espaçamento entre tipos de conta. As versões mais antigas dos ficheiros de detalhes de custos pré-pagos têm secções separadas para o extrato e o custo diário.
Os números de peça na fatura EA também estão no arquivo de custo e uso
Os registros no arquivo de custo e uso e outras experiências de gerenciamento de custos, como análise de custos, incluem números de peça que os combinam com os números de peça na fatura do EA. Os números de peça no arquivo de custo e uso são mostrados apenas para clientes EA.
- Os números de peça são mostrados para todos os registros de uso.
- Os números de peça são mostrados para todos os registros de compra e reembolso.
Os números de peça 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 Economia do Azure e as reservas de pré-compra. Atualmente, eles não têm um número de peça no arquivo de detalhes de custo e uso.
Reconciliar cobranças no arquivo de detalhes de custo e uso
Os clientes do Contrato de Cliente Microsoft (MCA) podem usar as seguintes informações para reconciliar cobranças entre moedas de cobrança e preços.
Calcule manualmente o
CostInPricingCurrency
por:(EffectivePrice)
*(Quantity)
Converta o calculado
CostInPricingCurrency
em porCostInBillingCurrency
:(CalculatedCostInPricingCurrency)
*(ExchangeRatePricingToBilling)
Resuma os valores calculados e
CostInBillingCurrency
compare-os com a fatura.
Os clientes do Enterprise Agreement (EA) podem reconciliar seus encargos usando o seguinte cálculo:
Calcule manualmente o custo multiplicando o Preço Efetivo pela Quantidade:
Cost
= (EffectivePrice)
* (Quantity)
Reconciliar compras de reserva com registos de utilização
Cada registro de compra e uso de reserva tem dois IDs associados: ReservationId
e ProductOrderId
.
- Registos de compra de reserva (
PricingModel
=Reservation
, ):ChargeType
=Purchase
- Os registros carregam o ID da ordem de compra como
ProductOrderId
. - Além disso, eles carimbam o mesmo ID de ordem de compra que
ReservationId
o .
- Os registros carregam o ID da ordem de compra como
- Registos de utilização de reservas (
PricingModel
=Reservation
, ):ChargeType
=Usage
/UnusedReservation
- Como os registros de compra, os registros de uso também carregam o ID da ordem de compra como
ProductOrderId
. - No entanto, o
ReservationId
pode diferir, pois é atribuído aos recursos que se beneficiaram da reserva. - Lembre-se de que ações como dividir, mesclar, reembolsar parcialmente ou trocar podem criar novas reservas.
- Como os registros de compra, os registros de uso também carregam o ID da ordem de compra como
Embora o ReservationId
próprio possa diferir, ainda faz parte da mesma ordem. Portanto, o ProductOrderId
pode ser efetivamente utilizado para associar a compra ao registro de uso, facilitando a conciliação entre compras de reserva e uso.
Tipo de registo | ReservationId |
ProductOrderId |
---|---|---|
Registo de compra de reserva (custo real) | ID da nota de encomenda | ID da nota de encomenda |
Registo de utilização da reserva (custo amortizado e real) | ID de reserva diferente | ID da nota de encomenda |
Para obter mais informações, veja Gerir reservas para recursos do Azure.
Identificar cobranças de EA para a quantidade incluída
Quantidade incluída (QI) refere-se à quantidade de um recurso medido que pode ser consumido sem incorrer em qualquer custo extra em um Enterprise Agreement. Ao lidar com QI, considere os seguintes pontos:
Características do medidor - Os medidores associados ao QI apresentam características específicas no arquivo de custos, pois permitem o consumo sem encargos extras. No arquivo de custos, um medidor com QI tem:
- ChargeType: Uso, PricingModel: OnDemand.
- Preço unitário, preço efetivo e Custo definido como 0, porque você não é cobrado pelo consumo.
- A quantidade não é zero. Mostra o consumo real do contador.
- No entanto, o preço PayG (pay-as-you-go) ainda mostra o preço de varejo, que é diferente de zero.
Detalhes do ajuste de arredondamento
Por que razão temos um ajustamento de arredondamento?
Todo sistema financeiro envolve lógica de arredondamento, o que pode causar alguma variância. As faturas agregam os custos mensais ao nível do contador, com custos arredondados consoante a 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 custos em um nível agregado sempre que a fatura está pronta, garantindo que os custos totais em ambos os arquivos correspondam.
Nota: Dois ajustes de arredondamento separados são fornecidos, um para registros primários e outro para registros de mercado. Esses ajustes não estão disponíveis durante um mês aberto e ficam visíveis quando o mês fecha e a fatura é gerada.
Os clientes podem distribuir o ajuste de arredondamento por detalhes mais precisos, como recursos individuais, grupos de recursos ou assinaturas inteiras. Você pode usar uma média ponderada ou usar técnicas semelhantes.
Registro de ajuste de arredondamento no arquivo de custo
O registro de ajuste de arredondamento está disponível no arquivo de custo no escopo Perfil de Cobrança do Contrato de Cliente Microsoft (MCA) ou no escopo Inscrição do Enterprise Agreement (EA). Como é um valor agregado no nível da fatura, não há informações de nível inferior para o registro. Os seguintes campos são válidos para um registo de ajuste de arredondamento:
BillingAccountId
BillingAccountName
BillingPeriodStartDate
BillingPeriodEndDate
BillingProfileId
BillingProfileName
MeterCategory
, MeterSubCategory
e ChargeType
os campos têm o valor de 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. Utiliza ambos os recursos por 10 horas num dia, portanto, o custo total de cada recurso é:
- Recurso A: $0.1234 x 10 = $1.234
- Recurso B: $0,5678 x 10 = $5,678
O custo total para o dia é $1.234 + $5.678 = $6.912.
No entanto, quando a fatura é gerada, os custos são arredondados para duas casas decimais, de modo a que 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 $0,002, que é o ajuste de arredondamento. Para garantir que os custos do Gerenciamento de Custos correspondam à fatura, um valor de -0,002 USD é mostrado no arquivo de custo como o ajuste de arredondamento após a geração da fatura.
Lista de termos das APIs mais antigas
A tabela a seguir estabelece a correspondência entre os termos utilizados nas APIs mais antigas e os novos termos. Consulte a tabela anterior para obter descrições.
Termo antigo | Novo termo |
---|---|
ConsumedQuantity | Quantidade |
IncludedQuantity | N/A |
InstanceId | ResourceId |
Tarifa | EffectivePrice |
Unit | UnitOfMeasure |
UsageDate | Date |
UsageEnd | Date |
UsageStart | Date |
Conteúdos relacionados
- Obtenha uma visão geral de como ingerir dados de custos.
- Saiba mais sobre Escolha uma solução de detalhes de custo.
- Crie e gerencie dados exportados no portal do Azure com Exportações.
- Automatize a criação e ingestão de exportação em escala usando a API.
- Saiba como Obter conjuntos de dados de pequeno custo sob demanda.