跟踪 Azure 使用量承诺 (MACC)

项目
06/21/2023

Azure 使用量承诺 (MACC) 是你的组织针对一段时间内的 Azure 支出做出的合同承诺。如果你的组织的某个 Microsoft 客户协议 (MCA) 计费帐户或企业协议 (EA) 计费帐户具有 MACC，则你可以通过 Azure 门户或 REST API 查看承诺的重要内容，包括开始和结束日期、剩余承诺金额以及合格的支出。

Azure 门户中的 MACC 功能仅适用于直接 MCA 和直接 EA 客户。直接协议是 Microsoft 与客户之间的协议。间接协议则是客户与 Microsoft 合作伙伴签署的协议。

如果 MACC 承诺在前一个 MACC（针对同一个注册/计费帐户）到期或完成之前已经进行了交易，承诺的实际扣减将在前一个承诺的完成或到期时开始。换句话说，如果你在同一注册或计费帐户上在某个较旧的 MACC 过期或完成之后有一个新的 MACC，那么，将会在旧承诺过期或完成时开始使用这个新承诺。

先决条件

对于 EA，用户需要是企业管理员才能查看 MACC 余额。
对于 MCA，用户必须在计费帐户上具有“所有者”、“参与者”或“读取者”角色才能查看 MACC 余额。

登录 Azure 门户。
搜索“成本管理 + 计费”。
在计费范围页中，选择要跟踪其承诺的计费帐户。对于 Microsoft 客户协议 (MCA) 客户，计费帐户类型必须是“Microsoft 客户协议”；对于 EA 客户，计费帐户类型必须是“企业协议” 。

注意

Azure 门户会记住你访问的最后一个计费范围，并在你下一次转到“成本管理 + 计费”页时显示该范围。如果你早前访问过“成本管理 + 计费”，则看不到计费范围页。如果是这样，请检查你是否处于正确的范围。否则，请切换范围，选择 Microsoft 客户协议的计费帐户。
根据你的协议类型执行以下操作之一：
- （对于 MCA 客户）在左侧选择“属性”，然后选择“Azure 使用量承诺(MACC)”。
- （对于 EA 客户）在左侧导航菜单中选择“信用 + 承诺”，然后选择“Azure 使用量承诺(MACC)”。
“Azure 使用量承诺(MACC)”选项卡包含以下部分。

剩余承诺金额

“剩余承诺金额”显示自上次发票之后的剩余承诺金额。

详细信息

“详细信息”部分显示承诺使用量的其他重要方面。

术语	定义
ID	唯一标识你的 MACC 的标识符。此标识符用来通过 REST API 获取你的 MACC 信息。
购买日期	做出承诺的日期。
开始日期	承诺生效的日期。
结束日期	承诺到期的日期。
承诺金额	你承诺在符合 MACC 条件的产品/服务上支出的金额。
状态	你的承诺的状态。

你的 MACC 可能具有下列状态之一：

活动：MACC 处于活动状态。任何合格支出都会计入你的 MACC 承诺。
已完成：你已完成你的 MACC 承诺。
已过期：MACC 已过期。有关详细信息，请与你的 Microsoft 帐户团队联系。
已取消：MACC 已被取消。新的 Azure 支出不会计入你的 MACC 承诺。

事件

“事件”部分显示对你的 MACC 承诺造成减量的事件（已开具发票的支出）。

术语	定义
Date	事件的发生日期
说明	事件的说明
计费配置文件	发生的事件对应的计费配置文件。计费配置文件仅适用于 Microsoft 客户协议。如果你有 EA 注册，则不会显示“计费配置文件”。
MACC 减量	事件导致的 MACC 减量
剩余承诺金额	发生此事件后的剩余 MACC 承诺金额

可以使用 Azure 计费和消耗 API 以编程方式获取你的计费帐户的 Azure 使用量承诺 (MACC)。

下面显示的示例使用 REST API。目前，PowerShell 和 Azure CLI 不受支持。示例输出适用于 Microsoft 客户协议，因此针对企业协议的输出与此不同。

查找你有权访问的计费帐户

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts?api-version=2020-05-01

API 响应会返回计费帐户的列表。

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "name": "9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "type": "Microsoft.Billing/billingAccounts",
      "properties": {
        "displayName": "Contoso",
        "agreementType": "MicrosoftCustomerAgreement",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "hasReadAccess": true,
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/9a12f056-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "name": "9a12f056-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx",
      "type": "Microsoft.Billing/billingAccounts",
      "properties": {
        "displayName": "Kayla Lewis",
        "agreementType": "MicrosoftCustomerAgreement",
        "accountStatus": "Active",
        "accountType": "Individual",
        "hasReadAccess": true,
      }
    }
  ]
}

使用计费帐户的 displayName 属性来标识要跟踪其 MACC 的计费帐户。复制计费帐户的 name。例如，如果想要跟踪 Contoso 计费帐户的 MACC，则需要复制 9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx。将该值粘贴到某个位置，以便在下一步使用它。

获取 Azure 使用量承诺的列表

发出以下请求，将 <billingAccountName> 替换为在第一步复制的 name (9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx)。

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/providers/Microsoft.Consumption/lots?api-version=2021-05-01&$filter=source%20eq%20%27ConsumptionCommitment%27

API 响应会返回你的计费帐户的 MACC 的列表。

    {
    "value": [
      {
        "id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
        "name": "G2021032459206000XXXX",
        "type": "Microsoft.Consumption/lots",
        "eTag": null,
        "properties": {
          "purchasedDate": "2021-03-24T16:26:46.0000000Z",
          "status": "Active",
          "originalAmount": {
            "currency": "USD",
            "value": 10000.0
          },
          "closedBalance": {
            "currency": "USD",
            "value": 9899.42
          },
          "source": "ConsumptionCommitment",
          "startDate": "2021-03-01T00:00:00.0000000Z",
          "expirationDate": "2024-02-28T00:00:00.0000000Z"
        }
      },
      {
        "id": "/providers/Microsoft.Billing/billingAccounts/9a157b81-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G1011082459206000XXXX",
        "name": "G1011082459206000XXXX",
        "type": "Microsoft.Consumption/lots",
        "eTag": null,
        "properties": {
          "purchasedDate": "2021-03-24T16:26:46.0000000Z",
          "status": "Complete",
          "originalAmount": {
            "currency": "USD",
            "value": 10000.0
          },
          "closedBalance": {
            "currency": "USD",
            "value": 0.00
          },
          "source": "ConsumptionCommitment",
          "startDate": "2020-03-01T00:00:00.0000000Z",
          "expirationDate": "2021-02-28T00:00:00.0000000Z"
        }
      }
    ]
  }

元素名称	说明
`purchasedDate`	购买 MACC 的日期。
`status`	你的承诺的状态。
`originalAmount`	原始承诺金额。
`closedBalance`	自上次发票之后的剩余承诺金额。
`source`	对于 MACC，source 将始终为 ConsumptionCommitment。
`startDate`	MACC 的激活日期。
`expirationDate`	MACC 的到期日期。

你的 MACC 可能具有下列状态之一：

活动：MACC 处于活动状态。任何合格支出都会计入你的 MACC 承诺。
已完成：你已完成你的 MACC 承诺。
已过期：MACC 已过期。有关详细信息，请与你的 Microsoft 帐户团队联系。
已取消：MACC 已被取消。新的 Azure 支出不会计入你的 MACC 承诺。

获取影响了 MACC 承诺的事件

发出以下请求，将 <billingAccountName> 替换为在第一步复制的 name (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx)。需要传递 startDate 和 endDate 来获取所需期间内的事件。

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/providers/Microsoft.Consumption/events?api-version=2021-05-01&startDate=<startDate>&endDate=<endDate>&$filter=lotsource%20eq%20%27ConsumptionCommitment%27

API 响应会返回影响了你的 MACC 承诺的所有事件。

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/events/103axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "name": "103axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "type": "Microsoft.Consumption/events",
      "eTag": null,
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/SWFF-DVM4-XXX-XXX",
        "billingProfileDisplayName": "Finance",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
        "lotSource": "ConsumptionCommitment",
        "transactionDate": "2021-05-05T00:09:13.0000000Z",
        "description": "Balance after invoice T00075XXXX",
        "charges": {
          "currency": "USD",
          "value": -100.0
        },
        "closedBalance": {
          "currency": "USD",
          "value": 9899.71
        },
        "eventType": "SettledCharges",
        "invoiceNumber": "T00075XXXX"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/events/203axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "name": "203axxxx-2c25-7xx3-f2a0-ad9a3f1c91xx",
      "type": "Microsoft.Consumption/events",
      "eTag": null,
      "properties": {
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/billingProfiles/SWFF-DVM4-XXX-XXX",
        "billingProfileDisplayName": "Engineering",
        "lotId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx_xxxx-xx-xx/providers/Microsoft.Consumption/lots/G2021032459206000XXXX",
        "lotSource": "ConsumptionCommitment",
        "transactionDate": "2021-04-05T00:09:13.0000000Z",
        "description": "Balance after invoice T00074XXXX",
        "charges": {
          "currency": "USD",
          "value": -0.29
        },
        "closedBalance": {
          "currency": "USD",
          "value": 9999.71
        },
        "eventType": "SettledCharges",
        "invoiceNumber": "T00074XXXX"
      }
    }
  ]
}

元素名称	说明
`billingProfileId`	发生的事件对应的计费对象信息的唯一标识符。
`billingProfileDisplayName`	发生的事件对应的计费对象信息的显示名称。
`lotId`	MACC 的唯一标识符。
`lotSource`	它将是 MACC 的 ConsumptionCommitment。
`transactionDate`	事件的发生日期。
`description`	事件的说明。
`charges`	MACC 减量金额。
`closedBalance`	发生此事件后的余额。
`eventType`	MACC 仅支持 SettledCharges 事件。
`invoiceNumber`	其收费对 MACC 造成了减量的发票的唯一 ID。

符合 MACC 条件的 Azure 服务和市场产品/服务

你可以在 Azure 门户中确定哪些 Azure 服务和市场产品/服务符合 MACC 减量条件。

Azure 额度和 MACC

如果你的组织收到了 Microsoft 的 Azure 额度，则这些额度涵盖的消耗或购买不会计入 MACC 承诺。

如果你的组织购买了 Azure 预付款，则这些额度涵盖的消耗或购买不会计入 MACC 承诺。但是，实际的预付款购买本身会对 MACC 承诺造成减量。

例如，Contoso 在 5 月份做出了金额为 50,000 美元的 MACC 承诺。在 6 月份，他们购买了 10,000 美元的 Azure 预付款。此购买将对其 MACC 承诺造成减量，剩余承诺金额将变为 40,000 美元。在 6 月份，Contoso 使用了 10,000 美元符合 Azure 预付款条件的服务。服务费用将由 Azure 预付款支付；但是，服务费用不会对其 MACC 承诺造成减量。用完 Azure 预付款后，所有 Azure 服务消耗和其他符合条件的购买都会对其 MACC 承诺造成减量。

检查对 Microsoft 客户协议的访问权限

检查协议类型以确定你是否有权访问 Microsoft 客户协议的计费帐户。

请访问 Azure 门户以检查是否有计费帐户访问权限。搜索并选择“成本管理 + 计费”。
如果仅有权访问一个计费范围，请从菜单选择“属性” 。如果计费帐户类型为“Microsoft 客户协议” ，则有权访问 Microsoft 客户协议的计费帐户。
如果有权访问多个计费范围，请检查“计费帐户”列中的类型。如果任何范围的计费帐户类型为“Microsoft 客户协议” ，则有权访问 Microsoft 客户协议的计费帐户。