你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

了解成本详细信息字段

本文档介绍通过 Azure 门户下载、从成本管理导出成本详细信息 API 在文件中找到的成本详细信息(以前称为“使用情况详细信息”)字段。 有关成本详细信息最佳做法的详细信息,请参阅选择成本详细信息解决方案

迁移到新的成本详细信息格式

如果使用的是较旧的成本详细信息解决方案,并且想要迁移到“导出”或成本详细信息 API,请阅读以下文章。

注意

2024 年 5 月 1 日,Azure Enterprise 报告 API 将停用。 任何剩余的 Enterprise 报告 API 都将停止响应请求。 客户需要在该日期之前转换为使用 Microsoft 成本管理 API。 要了解详细信息,请参阅从 Azure 企业报告迁移到 Microsoft 成本管理 API 概述

字段和说明列表

下表介绍了最新版本的成本详细信息文件中使用的重要术语。 该列表涵盖即用即付(也称为 Microsoft Online Services 计划)、企业协议 (EA)、Microsoft 客户协议 (MCA) 和 Microsoft 合作伙伴协议 (MPA) 帐户。

除了 MPA 条款外,MPA 帐户还具有所有 MCA 条款,如下表所述。 若要确定帐户类型,请参阅支持的 Microsoft Azure 产品/服务

术语 帐户类型 说明
AccountName EA、即用即付 显示 EA 注册帐户或即用即付计费帐户的名称。
AccountOwnerId¹ EA、即用即付 EA 注册帐户或即用即付计费帐户的唯一标识符。
AdditionalInfo¹ All 服务特定的元数据。 例如,虚拟机的映像类型。
AvailabilityZone 外部帐户 仅适用于从跨云连接器获取的成本数据。 该字段显示其中部署了 AWS 服务的可用性区域。
BenefitId¹ EA、MCA 购买的节省计划实例的唯一标识符。
BenefitName EA、MCA 购买的节省计划实例的唯一标识符。
BillingAccountId¹ All 根计费帐户的唯一标识符。
BillingAccountName All 计费帐户的名称。
BillingCurrency All 与计费帐户关联的货币。
BillingCurrencyCode 全部 参见 BillingCurrency。
BillingPeriod EA、即用即付 费用的计费周期。
BillingPeriodEndDate All 计费周期的结束日期。
BillingPeriodStartDate All 计费周期的开始日期。
BillingProfileId¹ All EA 注册、PAYG 订阅、MCA 计费对象信息或 AWS⁴ 合并帐户的唯一标识符。
BillingProfileName All EA 注册、PAYG 订阅、MCA 计费对象信息或 AWS⁴ 合并帐户的名称。
ChargeType All 指示费用表示使用情况 (Usage)、购买 (Purchase) 还是退款 (Refund)。
ConsumedService All 与费用相关联的服务的名称。
CostCenter¹ EA、MCA 为订阅定义的用于跟踪成本的成本中心(仅在启用计费周期适用于 MCA 帐户)。
成本 EA、即用即付 参见 CostInBillingCurrency。
CostAllocationRuleName EA、MCA 适用于记录的成本分配规则的名称。
CostInBillingCurrency EA、MCA 在应用额度或税款之前按计费货币计算的费用成本。
CostInPricingCurrency MCA 在应用额度或税款之前按定价货币计算的费用成本。
货币 EA、即用即付 请参阅 BillingCurrency
CustomerName MPA 客户的订阅的 Microsoft Entra 租户名称。
CustomerTenantId MPA 客户的订阅的 Microsoft Entra 租户标识符。
Date¹ All 费用项目的使用或购买日期。
有效价格² ³ 全部 给定产品或服务的价格,表示你最终为每个单位支付的实际费率。
ExchangeRateDate MCA 确定汇率的日期。
ExchangeRatePricingToBilling MCA 将以定价货币计算的成本转换为以计费货币计算的成本时所使用的汇率。
频率 All 指示某项费用是否会重复收取。 费用可以一次性收取 (OneTime)、按月或按年重复收取 (Recurring),或者按使用情况收取 (UsageBased)。
InvoiceId 即用即付、MCA 在发票 PDF 上列出的唯一单据 ID。
InvoiceSection MCA 请参阅 InvoiceSectionName
InvoiceSectionId¹ EA、MCA EA 部门或 MCA 发票科目的唯一标识符。
InvoiceSectionName EA、MCA EA 部门或 MCA 发票科目的名称。
IsAzureCreditEligible All 指示是否有资格使用 Azure 额度支付费用(值:TrueFalse)。
位置 MCA 在为相同区域配置了不同资源位置的情况下,资源的规范化位置。 购买和市场使用情况可能显示为空白或 unassigned
MeterCategory All 计量的分类类别的名称。 例如,“云服务”和“网络”。 购买和市场使用情况可能显示为空白或 unassigned
MeterId¹ All 计量的唯一标识符。
MeterName All 计量的名称。 购买和市场使用情况可能显示为空白或 unassigned
MeterRegion All 按位置定价的服务的数据中心位置的名称。 参见“位置”。
MeterSubCategory All 计量子分类类别的名称。 购买和市场使用情况可能显示为空白或 unassigned
OfferId¹ EA、即用即付 Azure 套餐的名称,即你拥有的 Azure 订阅的类型。 有关详细信息,请参阅支持的 Microsoft Azure 套餐详细信息
即用即付价格² ³ 全部 给定产品或服务的市场价格(也称为零售或标价)。 有关详细信息,请参阅成本详细信息中的定价行为
PartnerEarnedCreditApplied MPA 指示是否已应用合作伙伴赚取的额度。
PartnerEarnedCreditRate MPA 存在基于合作伙伴管理员链接访问的合作伙伴赚取的额度 (PEC) 时应用的折扣率。
PartnerName MPA 合作伙伴的 Microsoft Entra 租户名称。
PartnerTenantId MPA 合作伙伴的 Microsoft Entra 租户标识符。
PartNumber¹ EA、即用即付 用于获取特定计量定价的标识符。
PlanName EA、即用即付 市场计划名称。
PreviousInvoiceId MCA 如果行项为退款,则指原始发票。
PricingCurrency MCA 基于协商价格进行定价时所使用的货币。
PricingModel All 指示计量器定价方式的标识符。 (值:OnDemandReservationSpotSavingsPlan
Products All 产品的名称。
ProductId¹ MCA 产品的唯一标识符。
ProductOrderId All 产品订单的唯一标识符。
ProductOrderName All 产品订单的唯一名称。
提供程序 MCA 产品类别或业务线的标识符。 例如,Azure、Microsoft 365 和 AWS⁴。
PublisherId MCA 发布服务器 ID。 它仅在生成发票后可用。
PublisherName 全部 发布服务器的名称。 对于第一方服务,该值应列为 MicrosoftMicrosoft Corporation
PublisherType All 支持的值:Microsoft、Azure、AWS⁴、Marketplace 对于 MCA 帐户,值为 Microsoft,对于 EA 和即用即付帐户,值为 Azure
数量³ 全部 给定产品或服务在给定日期使用的单位数。
ResellerName MPA 与订阅关联的经销商的名称。
ResellerMpnId MPA 与订阅关联的经销商的 ID。
ReservationId¹ EA、MCA 购买的预留实例的唯一标识符。
ReservationName EA、MCA 购买的预留实例的名称。
ResourceGroup All 资源所在的资源组的名称。 并非所有费用都来自部署到资源组的资源。 没有资源组的费用将显示为 null 或空、“其他”或“不适用”。
ResourceId¹ All Azure 资源管理器资源的唯一标识符。
ResourceLocation¹ All 资源运行时所在的数据中心位置。 请参阅 Location
ResourceName EA、即用即付 资源的名称。 并非所有费用都来所部署的资源。 没有资源类型的费用将显示为 null/空、“其他”或“不适用”。
ResourceType MCA 资源实例的类型。 并非所有费用都来所部署的资源。 没有资源类型的费用将显示为 null/空、“其他”或“不适用”。
RoundingAdjustment EA、MCA 舍入调整表示在成本计算过程中发生的量化。 在将计算的成本转换为开票总计时,可能会出现小的舍入误差。 舍入误差表示为 rounding adjustment,以确保成本管理中显示的成本与发票保持一致。 有关详细信息,请参阅舍入调整详细信息
ServiceFamily MCA 服务所属的服务系列。
ServiceInfo¹ All 服务特定的元数据。
ServiceInfo2 All 旧字段,具有可选的特定于服务的元数据。
ServicePeriodEndDate MCA 定价周期的结束日期,该周期定义和锁定了所使用的或购买的服务的价格。
ServicePeriodStartDate MCA 定价周期的开始日期,该周期定义和锁定了所使用的或购买的服务的价格。
SubscriptionId¹ All Azure 订阅的唯一标识符。
SubscriptionName All Azure 订阅的名称。
Tags¹ All 分配给资源的标记。 不包括资源组标记。 可以用来将内部退款的成本进行分组或分发。 有关详细信息,请参阅使用标记来组织 Azure 资源
术语 All 显示套餐的有效期限。 例如:对于预留实例,它显示的“期限”为 12 个月。 对于一次性购买或定期购买,“期限”为 1 个月(SaaS、市场支持)。 不适用于 Azure 消耗计划。
UnitOfMeasure All 用于服务计费的度量单位。 例如,计算服务按小时计费。
单价² ³ 全部 给定产品或服务的价格,其中包括基于合同市场价格(PayG 价格列)的任何协商折扣。 有关详细信息,请参阅成本详细信息中的定价行为

¹ 用于生成单个成本记录的唯一 ID 的字段。 成本详细信息文件中的每条记录都应被视为唯一记录。

²对于 MCA 客户,价格以实际成本和摊销成本报表中的定价货币显示。 而对于 EA 客户,计费货币与定价货币是同一种货币。

³ 有关定价条款和定义的详细信息,请参阅成本详细信息中的定价行为

⁴ 成本管理服务中的 AWS 连接器将于 2025 年 3 月 31 日停用。 用户应考虑用于 AWS 成本管理报告的替代解决方案。 2024 年 3 月 31 日,Azure 将针对所有客户禁用为 AWS 添加新连接器的功能。 有关详细信息,请参阅停用 Amazon Web Services (AWS) 连接器

成本详细信息文件本身不会通过 ID 来唯一标识单个记录。 相反,你可以使用标记为 ¹ 的文件中的字段自行创建唯一 ID。

在不同类型的帐户中,有些字段的大小写和间距可能不同。 旧版的即用即付成本详细信息文件有不同的“报表”和“每日成本”部分。

MCA 帐户费用对账

MCA 客户可使用以下信息将按计费货币和按定价货币显示的费用进行对账。

  1. (EffectivePrice) * (Quantity) 手动计算 CostInPricingCurrency
  2. (CalculatedCostinPricingCurrency) * (ExchangeRatePricingToBilling) 将计算得到的 CostInPricingCurrency 转换为 CostInBillingCurrency
  3. 汇总为 CostInBillingCurrency 计算得到的值,并将其与发票进行比较。

通过使用情况记录协调预留购买

每个预留购买和使用情况记录都有两个关联的 ID:ReservationIdProductOrderId

  • 预留购买记录(PricingModel = ReservationChargeType = Purchase):
    • 记录将采购订单 ID 作为 ProductOrderId
    • 此外,它们还印有与 ReservationId 相同的采购订单 ID。
  • 预留使用情况记录(PricingModelReservation = 、ChargeType = Usage/UnusedReservation):
    • 与购买记录一样,使用记录还会包含采购订单 ID 作为 ProductOrderId
    • 但是,ReservationId 可能会有所不同,因为它归因于受益于预留的资源。
    • 请记住,拆分、合并、部分退款或交换等操作可以创建新的预留。

虽然 ReservationId 本身可能有所不同,但它仍然是同一订单的一部分。 因此,ProductOrderId 可用于将购买与使用情况记录相关联,从而促进预留购买与使用情况之间的对帐。

记录类型 ReservationId ProductOrderId
预留购买记录(实际成本) 采购订单 ID 采购订单 ID
预留使用情况记录(摊销和实际成本) 不同预留 ID 采购订单 ID

有关详细信息,请查阅管理 Azure 资源的预留

确定包含数量的 EA 费用

包含的数量 (IQ) 是指可以消耗的按流量计费的资源量,而不会在企业协议中产生任何额外费用。 处理 IQ 时,请考虑以下几点:

计量特征 - 与 IQ 关联的计量在成本文件中表现出特定特征,因为计量允许消耗,无需任何额外费用。 在成本文件中,具有 IQ 的计量具有:

  • ChargeType:Usage、PricingModel:OnDemand。
  • 单价、有效价格 成本设置为 0,因为你不会为其消耗付费。
  • 数量不为零。 它显示计量的实际使用量。
  • 然而,“PayG (即用即付)价格”仍然显示零售价格,这是非零值

舍入调整详细信息

在开放月份,成本详细信息文件中不提供舍入调整。 当月份关闭并生成发票时,该调整可见。

舍入调整记录在 MCA 的计费对象信息范围或 EA 的注册范围的成本详细信息文件中提供。 由于它是发票级别的聚合值,因此没有可用于记录的较低范围级别信息。 以下字段是舍入调整记录的唯一有效字段:

  • BillingAccountId
  • BillingAccountName
  • BillingPeriodStartDate
  • BillingPeriodEndDate
  • BillingProfileId
  • BillingProfileName

MeterCategoryMeterSubCategoryChargeType 字段的值为 RoundingAdjustment

以下是舍入调整在实践中如何工作的示例:

假设订阅中有两个资源:A 和 B。资源 A 每小时费用为 0.1234 美元,资源 B 每小时费用为 0.5678 美元。 一天使用这两个资源 10 小时,因此每个资源的总成本为:

  • 资源 A:0.1234 美元 x 10 = 1.234 美元
  • 资源 B:0.5678 美元 x 10 = 5.678 美元

当天的总成本为 1.234 美元 + 5.678 美元 = 6.912 美元。

但是,生成发票时,成本将舍入到两位小数,因此发票显示:

  • 资源 A:1.23 美元
  • 资源 B:5.68 美元
  • 总计:6.91 美元

发票总额与实际总额之间的差额为 0.002 美元,这是四舍五入调整。 为了确保成本管理成本与发票匹配,金额显示在成本详细信息文件中。

旧版 API 中的术语列表

下表将旧版 API 中使用的术语映射到了新术语。 有关说明,请参阅上表。

旧术语 新术语
ConsumedQuantity 数量
IncludedQuantity 空值
InstanceId ResourceId
费率 EffectivePrice
单位 UnitOfMeasure
UsageDate Date
UsageEnd Date
UsageStart Date

后续步骤