Merge pull request #41107 from github/repo-sync

Repo sync

Author: docs-bot

assets/images/help/billing/cost-center-example-1.png

@@ -12,9 +12,14 @@ contentType: concepts
 product: '{% data variables.product.prodname_ghe_cloud %}'
 ---
 
-You can create cost centers to attribute usage and spending to business units, improving accountability, forecasting, and cost allocation.
+Cost centers allow you to attribute usage and spending to business units, improving accountability, forecasting, and cost allocation. You can also apply one or more budgets to them to control costs.
 
-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.
+## Cost center creation
+
+* **Enterprise owners and billing managers** can create and edit cost centers for **any resource**.
+* **Organization owners** can create and edit cost centers that contain **resources in their organization**.
+
+When you create a cost center, you define which resources it contains from users, repositories, and organizations. If your account is billed through Azure, you can also add an Azure subscription to bill usage to a different Azure subscription than the enterprise default.
 
 To get started with cost centers, see [AUTOTITLE](/billing/tutorials/use-cost-centers).
 

assets/images/help/billing/cost-center-example-2.png

@@ -24,31 +24,39 @@ This article contains reference information for how spending is assigned to cost
 | ------- | ----------------------------------------------------- |
 | {% data variables.product.prodname_actions %} | The repository or organization where the workflow runs. |
 | {% data variables.product.prodname_github_codespaces %} | The repository or organization where the codespace is created. |
-| {% data variables.product.prodname_copilot %} | The user who receives the license (priority), or the organization that is billed for the {% data variables.product.prodname_copilot_short %} license. |
-| Git Large File Storage | The repository or organization where Git LFS is used. |
-| {% data variables.product.prodname_GH_cs_and_sp %} | The user who receives the license. |
+| {% data variables.product.prodname_copilot %} license | The user who receives the license (priority), or the organization that is billed for the {% data variables.product.prodname_copilot_short %} license. |
 | {% data variables.product.prodname_enterprise %} | The user who receives the license (priority), or the organization that is billed for the license. |
+| Git Large File Storage | The repository or organization where Git LFS is used. |
 | {% data variables.product.prodname_registry %} | The repository or organization that owns the package. |
+| {% data variables.product.prodname_prus_caps %} | The user who triggered the use of the {% data variables.product.prodname_pru %} (priority), or the organization they belong to. |
+| {% data variables.product.prodname_GH_cs_and_sp %} | A user who uses a license. |
 
 ## Details for license-based products
 
-To ensure your cost centers reflect spending as intended, it's important to understand how spending is allocated to cost centers for license-based products like {% data variables.product.prodname_copilot %}, and how changes are reflected in your bill.
+To ensure your cost centers reflect spending as intended, it's important to understand how the cost of licenses is allocated to cost centers, and how changes are reflected in your bill.
 
-### {% data variables.product.prodname_copilot %}
+### {% data variables.product.prodname_GH_cs_and_sp %}
 
-* If a user belongs to a cost center, all usage associated with the user is charged to the cost center.
-* If a user does not belong to any cost center but the organization that is billed for the {% data variables.product.prodname_copilot_short %} license does, all usage associated with the user is charged to that cost center.
-* If the user receives access to {% data variables.product.prodname_copilot_short %} through **multiple organizations**, only one of the organizations is billed, and any cost center containing that organization is charged accordingly. See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise#about-seat-assignment-for-copilot-in-your-enterprise).
+| User associated with a cost center | License usage charged |
+|--|--|
+| Direct assignment | To the cost center the user is assigned to |
+| By organization membership only | To the enterprise |
 
-### {% data variables.product.prodname_GH_cs_and_sp %}
+### {% data variables.product.prodname_enterprise %} and {% data variables.product.prodname_copilot %}
 
-* If a user belongs to a cost center, licenses consumed by the user are charged to the cost center.
-* If a user does not belong to any cost center, licenses consumed by the user are charged to the enterprise.
+Cost center allocation is slightly different for {% data variables.product.prodname_enterprise %} licenses and {% data variables.product.prodname_copilot %} licenses and usage.
 
-### {% data variables.product.prodname_enterprise %}
+| User associated with a cost center | {% data variables.product.prodname_copilot_short %} license granted | License and product costs charged |
+|--|--|--|
+| Direct assignment | By any organization | To the cost center the user is assigned to |
+| By organization membership only | By an organization assigned to a cost center | To the **cost center** the organization belongs to. If the organization does not belong to a cost center, to the **enterprise** |
 
-* If a user belongs to a cost center, the license consumed by the user is charged to the cost center.
-* If a user does not belong to any cost center, the license consumed by the user is charged to the enterprise.
+Users who belong to multiple organizations in an enterprise or who receive a {% data variables.product.prodname_copilot_short %} license from multiple organizations:
+
+* **{% data variables.product.prodname_enterprise %}** license usage is allocated to the oldest organization and charges are allocated to the cost center containing that organization.
+* **{% data variables.product.prodname_copilot_short %}** license and product usage is allocated to one of the organizations and charges are allocated to the cost center containing that organization.
+
+See [AUTOTITLE](/copilot/managing-copilot/managing-copilot-for-your-enterprise/managing-the-copilot-subscription-for-your-enterprise/about-billing-for-github-copilot-in-your-enterprise#about-seat-assignment-for-copilot-in-your-enterprise).
 
 ## Understanding cost center usage and attribution
 
@@ -86,6 +94,8 @@ The following example illustrates how usage is assigned to cost centers for lice
 
 ### The users
 
+![Diagram illustrating the description of four users and their organization membership.](/assets/images/help/billing/cost-center-example-1.png)
+
 There are four users, each a member of one or more organizations in the enterprise.
 
 | User | Organization membership |
@@ -114,12 +124,14 @@ There are two cost centers in the enterprise, each with different users or organ
 
 The following table illustrates how spending for each user is allocated to a cost center based on their membership of an organization or cost center. Any usage not assigned to a cost center is categorized as "Enterprise Only" spending.
 
+![Diagram illustrating the assignment of users and organizations to cost centers, with the allocation of costs for the four users.](/assets/images/help/billing/cost-center-example-2.png)
+
 {% rowheaders %}
 
 |             | Copilot charges | GHSP charges | GHE charges | Explanation |
 | ----------- | --------------- | ------------ | ----------- | ----------- |
 | Cost Center A | `user-1`, `user-3` | `user-1`, `user-3` | `user-1`, `user-3` | These users are assigned directly to the cost center. |
-| Cost Center B | `user-2`, `user-4` | {% octicon "dash" aria-label="Not applicable" %} | {% octicon "dash" aria-label="Not applicable" %} | These users aren't directly assigned to a cost center, so Copilot charges are assigned based on organization membership, whereas GHSP and GHE default to enterprise spending. |
-| Enterprise Only (default) | {% octicon "dash" aria-label="Not applicable" %} | `user-2`, `user-4` | `user-2`, `user-4` | These users aren't directly assigned to a cost center, so GHSP and GHE default to enterprise spending. |
+| Cost Center B | `user-2`, `user-4` | {% octicon "dash" aria-label="Not applicable" %} | `user-2`, `user-4` | These users aren't directly assigned to a cost center, so Copilot and GHE charges are assigned based on organization membership, whereas GHSP defaults to enterprise spending. |
+| Enterprise Only (default) | {% octicon "dash" aria-label="Not applicable" %} | `user-2`, `user-4` | {% octicon "dash" aria-label="Not applicable" %} | These users aren't directly assigned to a cost center, so GHSP defaults to enterprise spending. |
 
 {% endrowheaders %}

assets/images/help/code-quality/cca-pr-ai-findings.png

@@ -3,24 +3,26 @@ title: Reference for billing
 shortTitle: Reference
 intro: Find information to support your use of billing.
 versions:
-  fpt: "*"
-  ghec: "*"
-  ghes: "*"
+  fpt: '*'
+  ghec: '*'
+  ghes: '*'
 topics:
   - Billing
 children:
-  - /product-usage-included
   - /actions-runner-pricing
-  - /billing-reports
-  - /supported-payment-methods
   - /azure-billing
   - /azure-subscription
+  - /billing-reports
   - /billing-roles
   - /cost-center-allocation
-  - /roles-for-visual-studio
-  - /github-license-users
-  - /license-reports
   - /costs-for-github-models
   - /enterprise-license-troubleshooting
+  - /github-license-users
+  - /license-reports
+  - /product-and-sku-names
+  - /product-usage-included
+  - /roles-for-visual-studio
+  - /supported-payment-methods
 contentType: reference
 ---
+

content/billing/concepts/cost-centers.md

@@ -0,0 +1,130 @@
+---
+title: GitHub Product and SKU names
+shortTitle: Product and SKU names
+intro: Learn about the product and SKU identifiers used in the billing platform and REST API.
+versions:
+  fpt: '*'
+  ghec: '*'
+topics:
+  - Billing
+  - Enterprise
+contentType: reference
+---
+
+When working with billing through the REST API to create budgets or query usage, you'll need to use specific product and SKU identifiers. This reference provides the valid values for these identifiers.
+
+## Product-level identifiers
+
+For **ProductPricing** budgets or to query usage by product, use one of the following values:
+
+* `actions` - {% data variables.product.prodname_actions %}
+* `packages` - {% data variables.product.prodname_registry %}
+* `codespaces` - {% data variables.product.prodname_github_codespaces %}
+* `copilot` - {% data variables.product.prodname_copilot %}
+* `ghas` - {% data variables.product.prodname_GH_advanced_security %}
+* `ghec` - {% data variables.product.prodname_ghe_cloud %}
+
+## SKU-level identifiers
+
+For **SkuPricing** budgets or to query usage by SKU, use one of the following values:
+
+### {% data variables.product.prodname_actions %} SKUs
+
+<!-- markdownlint-disable GHD046 -->
+
+* `actions_beta_classroom_repository` - Actions beta classroom repository
+* `actions_beta_custom_runner_azure` - Actions beta custom runner (Azure)
+* `actions_beta_macos_xl_runner` - Actions beta macOS XL runner
+* `actions_beta_public_repository` - Actions beta public repository
+* `actions_beta_self_hosted_runner` - Actions beta self-hosted runner <!-- markdownlint-enable GHD046 -->
+* `actions_cache_storage` - Actions cache storage
+* `actions_custom_image_storage` - Actions custom image storage
+* `actions_linux` - Actions Linux runners
+* `actions_linux_16_core_perf` - Actions Linux 16-core performance
+* `actions_linux_20_core_mem` - Actions Linux 20-core memory
+* `actions_linux_2_core_advanced` - Actions Linux 2-core advanced
+* `actions_linux_2_core_arm` - Actions Linux 2-core ARM
+* `actions_linux_32_core` - Actions Linux 32-core
+* `actions_linux_32_core_arm` - Actions Linux 32-core ARM
+* `actions_linux_32_core_stor` - Actions Linux 32-core storage
+* `actions_linux_4_core` - Actions Linux 4-core
+* `actions_linux_4_core_advanced` - Actions Linux 4-core advanced
+* `actions_linux_4_core_gpu` - Actions Linux 4-core GPU
+* `actions_linux_64_core` - Actions Linux 64-core
+* `actions_linux_64_core_arm` - Actions Linux 64-core ARM
+* `actions_linux_8_core` - Actions Linux 8-core
+* `actions_linux_8_core_arm` - Actions Linux 8-core ARM
+* `actions_linux_8_core_stor` - Actions Linux 8-core storage
+* `actions_linux_96_core` - Actions Linux 96-core
+* `actions_linux_a100_24_core_gpu` - Actions Linux A100 24-core GPU
+* `actions_linux_a10_36_core_gpu` - Actions Linux A10 36-core GPU
+* `actions_linux_arm` - Actions Linux ARM
+* `actions_linux_slim` - Actions Linux slim
+* `actions_macos` - Actions macOS runners
+* `actions_macos_12_core` - Actions macOS 12-core
+* `actions_macos_8_core` - Actions macOS 8-core
+* `actions_macos_l` - Actions macOS large
+* `actions_macos_xl` - Actions macOS XL
+* `actions_self_hosted_linux` - Actions self-hosted Linux
+* `actions_self_hosted_macos` - Actions self-hosted macOS
+* `actions_self_hosted_unknown` - Actions self-hosted unknown
+* `actions_self_hosted_windows` - Actions self-hosted Windows
+* `actions_storage` - Actions storage
+* `actions_unknown` - Actions unknown
+* `actions_windows` - Actions Windows runners
+* `actions_windows_16_core` - Actions Windows 16-core
+* `actions_windows_176_core_perf` - Actions Windows 176-core performance
+* `actions_windows_2_core` - Actions Windows 2-core
+* `actions_windows_2_core_advanced` - Actions Windows 2-core advanced
+* `actions_windows_2_core_arm` - Actions Windows 2-core ARM
+* `actions_windows_32_core` - Actions Windows 32-core
+* `actions_windows_32_core_arm` - Actions Windows 32-core ARM
+* `actions_windows_32_core_stor` - Actions Windows 32-core storage
+* `actions_windows_4_core` - Actions Windows 4-core
+* `actions_windows_4_core_gpu` - Actions Windows 4-core GPU
+* `actions_windows_64_core` - Actions Windows 64-core
+* `actions_windows_64_core_arm` - Actions Windows 64-core ARM
+* `actions_windows_8_core` - Actions Windows 8-core
+* `actions_windows_8_core_arm` - Actions Windows 8-core ARM
+* `actions_windows_8_core_mem` - Actions Windows 8-core memory
+* `actions_windows_8_core_stor` - Actions Windows 8-core storage
+* `actions_windows_a100_24_core_gpu` - Actions Windows A100 24-core GPU
+* `actions_windows_a10_36_core_gpu` - Actions Windows A10 36-core GPU
+* `actions_windows_arm` - Actions Windows ARM
+
+### {% data variables.product.prodname_github_codespaces %} SKUs
+
+* `codespaces_compute_d16` - Codespaces compute (16-core)
+* `codespaces_compute_d2` - Codespaces compute (2-core)
+* `codespaces_compute_d32` - Codespaces compute (32-core)
+* `codespaces_compute_d4` - Codespaces compute (4-core)
+* `codespaces_compute_d8` - Codespaces compute (8-core)
+* `codespaces_prebuild_storage` - Codespaces prebuild storage
+* `codespaces_storage` - Codespaces storage
+
+### {% data variables.product.prodname_copilot %} SKUs
+
+* `copilot_agent_premium_request` - Copilot agent premium request
+* `copilot_enterprise` - Copilot Enterprise
+* `copilot_for_business` - Copilot for Business
+* `copilot_premium_request` - Copilot premium request
+* `copilot_standalone` - Copilot standalone
+
+### {% data variables.product.prodname_GH_advanced_security %} SKUs
+
+* `ghas_code_security_licenses` - GHAS code security licenses
+* `ghas_licenses` - GHAS licenses
+* `ghas_secret_protection_licenses` - GHAS secret protection licenses
+
+### Other SKUs
+
+* `ghec_licenses` - {% data variables.product.prodname_ghe_cloud %} licenses
+* `git_lfs_bandwidth` - Git LFS bandwidth
+* `git_lfs_storage` - Git LFS storage
+* `models_inference` - Models inference
+* `packages_bandwidth` - Packages bandwidth
+* `packages_storage` - Packages storage
+* `spark_premium_request` - Spark premium request
+
+> [!NOTE]
+> The exact SKUs available may vary depending on your enterprise or organization configuration and the features enabled. If you receive a `404` error when creating a budget through the REST API, look at the error response to see the current list of valid SKUs for your account.

content/billing/reference/cost-center-allocation.md

@@ -1,6 +1,7 @@
 To allocate metered spending to a cost center, you add repositories, organizations, or users to the cost center.
 
-* For **metered** products like {% data variables.product.prodname_actions %}, cost centers are charged based on the **repositories or organizations** in the cost center, as this is where the usage takes place.
-* For **metered license-based** products like {% data variables.product.prodname_copilot %}, cost centers are charged based on the **users** in the cost center.
+* For **usage-based** products, like {% data variables.product.prodname_actions %}, cost centers are charged based on the **repositories or organizations** in the cost center, as this is where the usage takes place.
+* For **license-based** products, like {% data variables.product.prodname_copilot %}, cost centers are charged based on the **users** in the cost center.
+* For products billed by **{% data variables.product.prodname_pru %}** usage, like {% data variables.copilot.copilot_coding_agent %}, cost centers are also charged based on the **users** in the cost center.
 
 Cost centers only apply to metered usage, and do not work with volume or subscription billing.