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
Em 1º de maio de 2024, as APIs do Azure Enterprise Reporting serão desativadas. Todas as APIs de Relatórios Corporativos restantes deixarão de responder às solicitações. Os clientes precisam fazer a transição para o uso de APIs do Microsoft Cost Management antes disso. Para saber mais, veja Descrição geral sobre como migrar das APIs de Relatórios Enterprise do Azure para as APIs do Microsoft Cost Management.
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 |
---|---|---|
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 | Identificador exclusivo da conta de inscrição EA ou da conta de cobrança pré-paga. |
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 | AMF | Nome do locatário do Microsoft Entra para a assinatura do cliente. |
CustomerTenantId | AMF | 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 | Local normalizado do recurso, se diferentes locais de recurso estiverem configurados para as mesmas regiões. As compras e o uso do Marketplace podem ser mostrados como em branco ou unassigned . |
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 | Nome da localização do datacenter dos serviços com preços baseados na localização. Veja Localização. |
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 | AMF | Indica se o crédito ganho pelo parceiro foi aplicado. |
PartnerEarnedCreditRate | AMF | Taxa de desconto aplicada se houver um crédito ganho pelo parceiro (PEC), com base no acesso ao link de administrador do parceiro. |
PartnerName | AMF | Nome do locatário parceiro do Microsoft Entra. |
PartnerTenantId | AMF | 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: On Demand , Reservation , e Spot ) |
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. Os valores são Microsoft para contas MCA e Azure para contas EA e pay-as-you-go. |
Quantidade³ | Todos | O número de unidades utilizadas pelo determinado produto ou serviço para um determinado dia. |
ResellerName | AMF | O nome do revendedor associado à assinatura. |
RevendedorMpnId | AMF | 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 | Localização do datacenter onde o recurso está em execução. Consulte Location . |
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. |
ServiçoInfo¹ | 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 você possa ter em cima do preço de mercado (coluna de preço PayG) para o 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.
Reconciliar encargos para contas MCA
Os clientes MCA podem usar as seguintes informações para reconciliar cobranças entre moedas de faturamento 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.
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 deles.
- 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
O ajustamento de arredondamento não está disponível no ficheiro de detalhes de custo durante um mês aberto. O ajuste é visível quando o mês fecha e a fatura é gerada.
O registro de ajuste de arredondamento está disponível no arquivo Detalhes de custo no escopo Perfil de faturamento para um MCA ou no escopo Inscrição para EA. Como é um valor agregado disponível ao nível da fatura, não há informações no âmbito do nível inferior disponíveis para o registo. Os seguintes campos são os únicos válidos para um registo no ajuste de arredondamento:
BillingAccountId
BillingAccountName
BillingPeriodStartDate
BillingPeriodEndDate
BillingProfileId
BillingProfileName
MeterCategory
, MeterSubCategory
e ChargeType
os campos têm o valor de RoundingAdjustment
.
Aqui está um exemplo de como o ajustamento de arredondamento funciona na prática:
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 de Cost Management correspondam à fatura, o montante é mostrado no ficheiro de detalhes do custo.
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. Veja a tabela acima para obter as descrições.
Termo antigo | Novo termo |
---|---|
ConsumedQuantity | Quantidade |
IncludedQuantity | N/A |
InstanceId | ResourceId |
Tarifa | EffectivePrice |
Unit | UnitOfMeasure |
UsageDate | Date |
UsageEnd | Date |
UsageStart | Date |
Próximos passos
- 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.