大规模控制和跟踪成本

成本中心通过将成本映射到公司的财务结构来帮助你跟踪和控制 GitHub 成本。

本教程指导你使用用户界面和 REST API 规划、创建和管理成本中心，帮助你确定哪种方法最适合组织的需求。

1.规划成本中心策略

成本中心允许你对资源（用户、组织和存储库）进行分组 GitHub ，以便进行单独的成本跟踪和报告。每个成本中心都应代表公司中您希望单独报告或单独控制成本的一个细分部分。

如果使用Azure计费，可以将不同的计费标识分配给每个成本中心。

确定所需的成本中心

最佳策略取决于财务报告结构和 GitHub 设置的复杂性。从最简单的方法开始，以后始终可以添加更多成本中心。

按照以下步骤规划成本中心：

       **映射到财务实体**：为要内部跟踪的每个财务实体创建一个成本中心（例如部门、业务部门或项目团队）。

       **标识用户**：列出属于每个财务实体的用户。 将用户直接分配到成本中心可确保正确分配其许可证和产品使用情况。

       **标识组织**：列出属于每个财务实体的组织。 将组织分配到成本中心可正确分配其操作、Codespaces 包和其他产品的使用情况。

       **确定混合所有权**：如果组织包含不同财务实体拥有的存储库，请计划将单个存储库分配给相关成本中心，并使组织保持未分配状态。

提示

如果用户被直接分配到成本中心 A，并通过组织成员身份间接成为成本中心 B 的成员，则其许可产品的所有成本都分配给成本中心 A。有关更多详细信息和示例，请参阅不同产品的成本中心分配。

2. 在 UI 中创建成本中心

现在，你将使用用户界面（UI）创建第一个成本中心，以熟悉成本中心的工作原理。选择已确定为示例的成本中心之一，最好从小型财务实体开始。

导航到您的企业。例如，从 GitHub.com 上的公司页面。
在页面顶部，单击“ Billing and licensing”。
单击“成本中心”****。
在右上角单击“新建成本中心”****。
在“名称”下的文本框中，输入要跟踪其成本的财务实体的名称。
（可选）如果此财务实体具有单独的Azure订阅，则可以将Azure订阅添加到成本中心，以便直接向其收取使用费。凭据将针对Azure进行验证，以确保与帐户关联的Azure ID 可用。
在 “资源”下，选择要作为此成本中心的一部分跟踪的用户、组织和存储库。
单击“创建成本中心”****。

新的成本中心现在处于活动状态，使用情况将立即开始归因于成本中心。未来的计费报告将包括此成本中心，并在 cost_center_name 列中列出分配给它的使用情况。还可以按此成本中心筛选使用情况图表。

3. 设置预算以控制成本

创建成本中心可以单独跟踪不同财务实体的成本。若要实际控制成本，需要将预算应用于成本中心。

了解预算

预算可让你控制支出。每个预算：

适用于单个组织、存储库、成本中心或整个企业
控制一个付费产品、SKU 或 SKU 组的每月使用情况
可配置为停止使用，或仅在达到预算限制时发出警报
可以通知帐户所有者、计费经理和已提名用户，因为接近预算限制

计算成本中心预算

如果你的内部财务计划为该成本中心的 GitHub 拨付了单一每月预算，则需要将其分配给该团队使用的各项产品。

       **计算固定许可证成本**：将团队已使用的GitHub Enterprise、GitHub Copilot、GitHub Secret Protection and GitHub Code Security许可证成本加起来。

       **计算可变预算**：从内部预算中减去许可证成本。 剩余金额是您可以用于超出计划包含范围的按使用量计费产品的部分。

为成本中心创建预算

为每个要控制成本的产品、SKU 或 SKU 组创建一个预算。

在“计费和许可”选项卡上，单击“ 预算”和警报 以显示现有预算。
单击 “新建预算 ”打开“新建每月预算”页。
在“预算类型”下，选择 产品级预算、 SKU 级预算或 捆绑高级请求预算。
- 若要限制产品级别的支出，请在“产品级预算”中从下拉列表中选择产品（例如）。 Codespaces
- 若要限制在 SKU 级别的支出，请在“SKU 级别预算”中选择一个产品和一个 SKU（例如，Copilot 和 Copilot 高级请求）。
- 若要限制所有高级请求的支出，请使用“捆绑的高级请求预算”。
单击“ 下一步：配置预算 ”以显示“预算范围”，并将此预算的支出范围设置为之前创建的成本中心。
在“预算”下，设置预算金额。若要在达到预算限制后停止任何使用情况和进一步支出，请在 达到预算限制时选择“停止使用”。这不适用于基于许可的产品。
若要在使用情况达到 75%、90%和预算目标的 100% 时收到警报，请选择“警报”下的 “接收预算阈值警报 ”。帐户所有者、计费经理和任何其他指定收件人都将通过电子邮件收到通知。可以随时选择退出。

在“警报收件人”下，选择要接收警报的任何其他收件人。
单击“创建预算”****。

审查现有预算是否存在冲突

创建成本中心预算后，请检查现有的企业范围预算，以确保它们不会与新的成本中心预算冲突或替代新的成本中心预算。

导航到“预算和警报”页。你将看到两个预算列表：

        **企业预算**：适用于整个企业帐户的限制

        **其他预算**：特定存储库、组织或成本中心的限制

检查企业预算

查看任何企业预算是否适用于与新的成本中心预算相同的产品或 SKU。如果企业预算非常低，则可能会在达到成本中心自己的预算之前阻止对成本中心的使用。请考虑删除或调整冲突的企业预算。

查看成本中心预算

筛选其他预算列表以显示 成本中心的范围。你应该能看到新的成本中心，其中包含所创建的每个预算的一行。最初，使用量接近零，但在几天之内，当用户和存储库消耗超出其计划额度的产品时，成本将开始累积。

4.使用 REST API 创建成本中心

了解如何在用户界面中创建成本中心后，可以浏览 REST API，了解如何以编程方式创建成本中心。了解 API 有助于评估自动化是否有利于组织。

本部分演示了使用 GitHub CLI成本中心管理的关键 REST API 终结点。有关安装 GitHub CLI 并进行身份验证以访问这些终结点的详细信息，请参阅 GitHub REST API 快速入门。

注意

以下示例使用 GitHub CLI，但你可以调整这些命令以使用 curl 或支持 REST API 调用的任何 HTTP 客户端。

列出所有现有成本中心

首先，检索企业中的所有成本中心以查看已存在的内容。通过这个简单的请求，你可以确保通过正确的身份验证，从而管理企业的计费。

在终端中，运行以下命令，将 ENTERPRISE 替换为企业的数据域。

Shell

gh api \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers

gh api \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers

响应将包括在企业中创建的所有成本中心，包括本教程前面创建的成本中心。在本例中，企业有一个成本中心“Octocenter”，其中分配了一个组织和两个用户。

{
  "costCenters": [
    {
      "id": "33635e2c-edc0-40b8-abea-261839ff73c1",
      "name": "Octocenter",
      "state": "active",
      "resources": [
        {
          "type": "User",
          "name": "monalisa"
        },
        {
          "type": "Org",
          "name": "doctocat-org"
        },
        {
          "type": "User",
          "name": "doctocat"
        }
      ]
    }
  ]
}

创建新的成本中心

通过提供名称创建新的成本中心。你将收到用于管理此成本中心的唯一标识符。

在终端中运行以下命令，替换 ENTERPRISE 并 NAME 替换为相应的值。

Shell

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers \
   -f 'name=NAME'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers \
   -f 'name=NAME'

响应包括新成本中心的标识符。将需要对该成本中心的所有未来操作使用此 id。

{
  "id": "3312fdf2-5950-4f64-913d-e734124059c9",
  "name": "NAME",
  "state": "active",
  "resources": []
}

将资源添加到成本中心

将用户、组织和存储库分配到成本中心。此示例演示如何添加多个用户和组织。

在终端中运行以下命令，将COST_CENTER_ID替换为上一步中的标识符，并用适当的值替换ENTERPRISE、NAME和ORG。

Shell

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers/COST_CENTER_ID/resource \
  --input - <<< '{
  "users": [
    "NAME-1",
    "NAME-2"
  ],
  "organizations": [
    "ORG-1"
  ]
}'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/cost-centers/COST_CENTER_ID/resource \
  --input - <<< '{
  "users": [
    "NAME-1",
    "NAME-2"
  ],
  "organizations": [
    "ORG-1"
  ]
}'

响应确认资源添加成功。如果以前向其他成本中心分配了任何资源，则会在 reassigned_resources 数组中列出这些资源。

{
  "message": "Resources successfully added to the cost center.",
  "reassigned_resources": [
    {
      "resource_type": "User",
      "name": "monalisa",
      "previous_cost_center": "Octocenter"
    }
  ]
}

如果终结点响应 Problems parsing JSON，请使用 JSON 验证程序检查选项中指定的 --input 数据是否有效。

5.使用 REST API 设置预算

可以编程方式创建预算，以将支出控制应用于已创建的成本中心。这对于管理基于使用情况的成本（如大规模的高级请求）特别有用。

为高级请求创建预算

此示例演示如何为 Copilot 高级请求创建 SKU 级预算并将其应用到新的成本中心。这使你可以为此成本中心中的资源专门为高级请求使用情况设置支出限制。

在终端中运行以下命令，将ENTERPRISE、COST_CENTER_ID、USERNAME和1000.0替换为适当的值。

Shell

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/budgets \
  -f budget_type='SkuPricing' \
  -f budget_product_sku='copilot_premium_request' \
  -f budget_scope='cost_center' \
  -f budget_entity_name='COST_CENTER_ID' \
  -F budget_amount=1000.0 \
  -F prevent_further_usage=true \
  -f budget_alerting='{"will_alert":true,"alert_recipients":["USERNAME"]}'

gh api \
  --method POST \
  -H "Accept: application/vnd.github+json" \
  -H "X-GitHub-Api-Version: 2022-11-28" \
  /enterprises/ENTERPRISE/settings/billing/budgets \
  -f budget_type='SkuPricing' \
  -f budget_product_sku='copilot_premium_request' \
  -f budget_scope='cost_center' \
  -f budget_entity_name='COST_CENTER_ID' \
  -F budget_amount=1000.0 \
  -F prevent_further_usage=true \
  -f budget_alerting='{"will_alert":true,"alert_recipients":["USERNAME"]}'

响应确认预算已创建并返回其配置。请注意，此预算将 prevent_further_usage 和 will_alert 都设置为 true。电子邮件地址 octocat@github.com 将在接近预算限制时收到警报，并且一旦达到 1000 美元，成本中心资源的使用将被停止。

{
  "id": "budget-uuid-here",
  "budget_type": "SkuPricing",
  "budget_product_sku": "copilot_premium_request",
  "budget_scope": "cost_center",
  "budget_entity_name": "3312fdf2-5950-4f64-913d-e734124059c9",
  "budget_amount": 1000.0,
  "prevent_further_usage": true,
  "budget_alerting": {
    "will_alert": true,
    "alert_recipients": [
      "octocat"
    ]
  }
}

提示

可以为同一成本中心创建多个预算，以独立控制不同的产品或 SKU。例如，可以为 Copilot 高级请求、GitHub Actions 计算和 Codespaces 使用情况设置单独的预算。请参阅“GitHub 产品及库存单位名称”。

6. 决定是否自动执行

本教程演示了创建成本中心的两种方法：使用用户界面进行动手管理，使用 REST API 进行编程管理。了解这两种方法可帮助你确定适合你的组织。

在以下情况下，用户界面 是理想的：

建立前几个成本中心
偶尔更新现有成本中心
更倾向于通过视觉方式确认更改

有少数成本中心需要管理

        **REST API** 在以下情况下非常有用：

需要定期创建或更新多个成本中心
需要将成本中心管理与现有财务系统集成，或者从外部数据源生成配置
需要成本中心来反映组织结构（如团队成员身份或部门结构）
需要在用户更改角色或在团队之间移动时自动维护成本中心分配

自动化选项

如果确定自动化将有利于组织，本教程中的 REST API 示例为生成自定义脚本提供了基础。有关其他终结点的详细信息，请参阅 REST API 的计费终结点。

如果您希望基于团队成员身份实现成本中心的自动化，或者创建一个用于控制高级请求成本的双层模型，GitHub 成本中心自动化提供了一个完整的实现，利用可根据您需要调整的操作工作流。

后续步骤

若要了解可用于自动报告使用情况和成本的终结点，请参阅使用 REST API 自动报告使用情况。

如果有任何付费产品要阻止所有访问权限，则可以使用企业策略禁用该功能。请参阅“企业策略”。

谁可以使用此功能？

在本文中

1.规划成本中心策略

确定所需的成本中心

2. 在 UI 中创建成本中心

3. 设置预算以控制成本

了解预算

计算成本中心预算

为成本中心创建预算

审查现有预算是否存在冲突

检查企业预算

查看成本中心预算

4.使用 REST API 创建成本中心

列出所有现有成本中心

创建新的成本中心

将资源添加到成本中心

5.使用 REST API 设置预算

为高级请求创建预算

6. 决定是否自动执行

自动化选项

后续步骤