From 39bf8e8385f2bfe790a024a1b4aebc822b61697a Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Holly=20=F0=9F=A6=92?= <104800384+holly-kassel@users.noreply.github.com> Date: Thu, 14 Aug 2025 12:28:53 -0500 Subject: [PATCH] Customers can add users to a cost center via both the UI and API [GA] (#57077) Co-authored-by: Felicity Chapman Co-authored-by: Greg Mondello <72952982+gmondello@users.noreply.github.com> Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com> Co-authored-by: Siara <108543037+SiaraMist@users.noreply.github.com> --- content/billing/tutorials/use-cost-centers.md | 19 ++++++++----------- .../manage-company-spending.md | 10 +--------- 2 files changed, 9 insertions(+), 20 deletions(-) diff --git a/content/billing/tutorials/use-cost-centers.md b/content/billing/tutorials/use-cost-centers.md index ec078a58ef..3874a5d02b 100644 --- a/content/billing/tutorials/use-cost-centers.md +++ b/content/billing/tutorials/use-cost-centers.md @@ -16,9 +16,9 @@ shortTitle: Use cost centers contentType: tutorials --- -To drive accountability and control costs, the new billing platform lets you create cost centers. A cost center manages expenses without generating revenue. You can create cost centers and assign users, organizations, and repositories to them, and set budgets. This enhances spending control and resource allocation. +Cost centers let you attribute usage and spend by business unit to improve accountability, forecasting, and cost allocation. You can assign users, organizations, and repositories within your enterprise to a cost center. -If your account is billed to Azure, you will have the option to add an Azure subscription ID. Cost centers allows for multiple Azure subscription IDs so that different business units, within an enterprise, can directly pay for their usage. +If your account is billed through Azure, you can add an Azure subscription to a cost center to bill usage to a different Azure subscription than the enterprise default. To learn more about roles authorized to create and manage cost centers, see [AUTOTITLE](/billing/managing-your-billing/roles-for-the-new-billing-platform). @@ -29,7 +29,7 @@ To learn more about roles authorized to create and manage cost centers, see [AUT Create cost centers to monitor and manage expenses for specific organizations or repositories. Multiple organizations, repositories, and users can be assigned to one cost center. -When you create a cost center, you can add **organizations** or **repositories**—which track spending for usage-based products like {% data variables.product.prodname_actions %}—via the user interface. To track spending for license-based products like {% data variables.product.prodname_copilot %}, you will need to add **users** to the cost center via the API after the cost center has been created. For guidance by product, see [Allocating spending to a cost center](#allocating-spending-to-a-cost-center). +When you create a cost center, you can add **organizations**, **repositories**, or **users**. The cost center will then track spending for the selected entities. {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.billing.enterprise-billing-menu %} @@ -37,9 +37,9 @@ When you create a cost center, you can add **organizations** or **repositories** 1. Click **New cost center** in the upper-right corner. 1. In the text box under "Name", enter a name for your cost center. 1. If your account is billed to Azure, you have the option to add an Azure ID. Your credentials will be verified against Azure to ensure the Azure IDs associated to your account are available. -1. If the cost center will track spending for usage-based products like {% data variables.product.prodname_actions %}, under "Resources", select the organizations and/or repositories that will be a part of the cost center. +1. Under **Resources**, select the organizations, repositories, and/or users that will be a part of the cost center. - >[!NOTE] An organization or repository can only be assigned to one cost center at a time. + >[!NOTE] A resource (organization, repository, or user) can only be assigned to one cost center at a time. If you add a resource that belongs to a different cost center, it will be moved to the new cost center and you will be notified. 1. Click **Create cost center**. @@ -47,9 +47,9 @@ When you create a cost center, you can add **organizations** or **repositories** To allocate spending to a cost center, you add repositories, organizations, or users to the cost center. Any usage that is not assigned to a specific cost center is categorized as "Enterprise Only" spending on your enterprise's "Usage" page. -* For **usage-based** products like {% data variables.product.prodname_actions %}, cost centers are charged based on the repositories or organizations that you add. You can add these to a cost center in the UI. See [Creating a cost center](#creating-a-cost-center). +* For **usage-based** products like {% data variables.product.prodname_actions %}, cost centers are charged based on the repositories or organizations that you add. See [Creating a cost center](#creating-a-cost-center). * For **license-based** products like {% data variables.product.prodname_copilot %}, cost centers are charged based on the users that you add. - * You must add users to a cost center with the API. See [AUTOTITLE](/rest/enterprise-admin/billing#add-users-to-a-cost-center). Note that the API currently supports adding or removing up to **50** resources in a single operation. + * You can add repositories, organizations, and/or users to a cost center with the API. See [AUTOTITLE](/rest/enterprise-admin/billing#add-resources-to-a-cost-center). Note that the API currently supports adding or removing up to **50** resources in a single operation. * If a licensed user isn't assigned to cost center, costs either default to "Enterprise Only" spending or are assigned to a cost center based on the user's organization membership. This depends on the product. For a detailed explanation, see [Cost center allocation for license-based products](#cost-center-allocation-for-license-based-products). ### Breakdown by product @@ -76,8 +76,6 @@ You can view the usage of your cost centers and download the usage data for furt You can view, edit, and delete cost centers to manage your business units effectively. -To add or remove members from a cost center, you can use the API. See [AUTOTITLE](/rest/enterprise-admin/billing). - {% data reusables.enterprise-accounts.access-enterprise %} {% data reusables.billing.enterprise-billing-menu %} 1. Click **Cost centers**. @@ -182,8 +180,7 @@ There are a few current limitations when working with cost centers and the API: * There is a maximum of 250 cost centers per enterprise. * You can add or remove up to 50 resources at a time from a cost center using the API. -* Azure subscriptions can only be added to or removed from cost centers via the UI. -* Users can only be added to or removed from cost centers via the API. +* Azure subscriptions can only be added to or removed from cost centers through the UI. ## Further reading diff --git a/content/copilot/how-tos/manage-and-track-spending/manage-company-spending.md b/content/copilot/how-tos/manage-and-track-spending/manage-company-spending.md index 231437c7b1..34b31fcc73 100644 --- a/content/copilot/how-tos/manage-and-track-spending/manage-company-spending.md +++ b/content/copilot/how-tos/manage-and-track-spending/manage-company-spending.md @@ -49,15 +49,7 @@ You can create cost centers to map spending to individual business units or grou For example, if you were running a pilot program for {% data variables.copilot.copilot_enterprise %} for a group of employees, you might want to create a cost center to track their spending and set a budget independently of the rest of the company. -### Create a cost center - -1. Go to your enterprise or organization account settings and click **{% octicon "credit-card" aria-hidden="true" aria-label="credit-card" %} Billing & Licensing**. -1. In the left sidebar, click **Cost centers**, then click **New cost center**. -1. Create the cost center. You don't need to add any repositories or organizations, because you will add users to the cost center directly in the next step. - - >[!NOTE] As a priority, a cost center is charged for a {% data variables.product.prodname_copilot_short %} license if the assigned **user** has been added to the cost center directly. As a fallback, a cost center is charged for the license if the **organization where the user receives access** has been added to the cost center. - -1. After creating the cost center, use the REST API to add the users whose usage you want to track. See [AUTOTITLE](/enterprise-cloud@latest/rest/enterprise-admin/billing#add-users-to-a-cost-center). +For more information, see [AUTOTITLE](/billing/tutorials/use-cost-centers). ## Preventing overspending