You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 552af80
Browse filesBrowse the repository at this point in the historyBrowse files
authored
Update billing documentation for "Codespaces for all" (#32099)
## About the {% data variables.product.prodname_github_codespaces %} spending limit
21
+
22
+
{% data reusables.codespaces.codespaces-free-for-personal-intro %} For more information, see "[About billing for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
23
+
24
+
{% data reusables.codespaces.codespaces-spending-limit-requirement %}
25
+
{% data reusables.codespaces.codespaces-monthly-billing %}
26
+
27
+
Once you've reached your spending limit, you will no longer be able to create new codespaces, and you won't be able to start existing codespaces. Any existing codespaces that are still running will be shut down in a short time, but you will not be charged for usage after you have reached your spending limit.
28
+
29
+
{% ifversion ghec %}
30
+
## Using your Azure Subscription
31
+
If you purchased {% data variables.product.prodname_enterprise %} through a Microsoft Enterprise Agreement, you can connect your Azure Subscription ID to your enterprise account to enable and pay for {% data variables.product.prodname_github_codespaces %} usage. For more information, see "[Connecting an Azure subscription to your enterprise](/billing/managing-billing-for-your-github-account/connecting-an-azure-subscription-to-your-enterprise)."
32
+
{% endif %}
33
+
34
+
## Managing the {% data variables.product.prodname_github_codespaces %} spending limit for your personal account
35
+
36
+
You can set a spending limit for {% data variables.product.prodname_github_codespaces %} for your own personal account.
37
+
38
+
{% data reusables.user-settings.access_settings %}
39
+
{% data reusables.user-settings.billing_plans %}
40
+
{% data reusables.dotcom_billing.manage-spending-limit %}
41
+
{% data reusables.codespaces.monthly-spending-limit-codespaces %}
42
+
{% data reusables.dotcom_billing.update-spending-limit %}
43
+
44
+
## Managing the {% data variables.product.prodname_github_codespaces %} spending limit for your organization account
45
+
46
+
Organizations owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an organization.
47
+
48
+
{% note %}
49
+
50
+
**Note**: Organizations that are owned by an enterprise account cannot specify their own spending limit as this is specified in the enterprise settings.
51
+
52
+
{% endnote %}
53
+
54
+
{% data reusables.organizations.billing-settings %}
55
+
{% data reusables.dotcom_billing.manage-spending-limit %}
56
+
{% data reusables.codespaces.monthly-spending-limit-codespaces %}
57
+
{% data reusables.dotcom_billing.update-spending-limit %}
58
+
59
+
{% ifversion ghec %}
60
+
## Managing the {% data variables.product.prodname_github_codespaces %} spending limit for your enterprise account
61
+
62
+
Enterprise owners and billing managers can manage the spending limit for {% data variables.product.prodname_github_codespaces %} for an enterprise account.
63
+
64
+
{% data reusables.enterprise-accounts.access-enterprise %}
65
+
{% data reusables.enterprise-accounts.settings-tab %}
66
+
{% data reusables.enterprise-accounts.billing-tab %}
{% data reusables.codespaces.monthly-spending-limit-codespaces %}
72
+
{% data reusables.dotcom_billing.update-spending-limit %}
73
+
{% endif %}
74
+
75
+
## Exporting changes when you have reached your spending limit
76
+
77
+
{% data reusables.codespaces.exporting-changes %}
78
+
79
+
## Managing usage and spending limit email notifications
80
+
81
+
Email notifications are sent to account owners and billing managers when spending reaches 75%, 90%, and 100% of an account's spending limit.
82
+
83
+
You can turn off these notifications at any time by navigating to the bottom of the "Billing & plans / Monthly spending limits" page and clearing the **Spending limits alerts** checkbox.
84
+
85
+
For personal accounts only, you can also choose to turn off email notifications that are sent when you have used 75%, 90%, and 100% of the free usage included with your personal account. To do this, clear the **Included resources alerts** checkbox.
86
+
87
+

88
+
89
+
## Further reading
90
+
91
+
- "[Restricting access to machine types](/codespaces/managing-codespaces-for-your-organization/restricting-access-to-machine-types)"
92
+
- "[Managing the cost of {% data variables.product.prodname_github_codespaces %} in your organization](/codespaces/managing-codespaces-for-your-organization/managing-the-cost-of-github-codespaces-in-your-organization)"
Copy file name to clipboardExpand all lines: content/billing/managing-billing-for-github-codespaces/viewing-your-github-codespaces-usage.md
+29-12Lines changed: 29 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,7 @@
1
1
---
2
2
title: Viewing your GitHub Codespaces usage
3
3
shortTitle: Viewing your usage
4
-
intro: 'You can view the compute minutes and storage used by {% data variables.product.prodname_github_codespaces %}.'
5
-
permissions: 'To manage billing for {% data variables.product.prodname_github_codespaces %} for an organization, you must be an organization owner or a billing manager.'
4
+
intro: 'You can view the compute hours and storage used by {% data variables.product.prodname_github_codespaces %}.'
## Viewing {% data variables.product.prodname_github_codespaces %} usage for your organization
16
+
## Viewing {% data variables.product.prodname_github_codespaces %} usage for your personal account
18
17
19
-
Organization owners and billing managers can view {% data variables.product.prodname_github_codespaces %} usage for an organization. For organizations managed by an enterprise account, the organization owners can view {% data variables.product.prodname_github_codespaces %} usage in the organization billing page, and enterprise admins can view the usage for the entire enterprise.
18
+
You can see how much of the usage included in your personal account you have used so far in the current monthly billing cycle. If you have set up a payment method, set a spending limit, and used all of your included usage, you can also check your bill for the current month.
19
+
20
+
{% data reusables.user-settings.access_settings %}
21
+
{% data reusables.user-settings.billing_plans %}
22
+
1. Under "{% data variables.product.prodname_codespaces %}," you can see how many core hours of {% data variables.product.prodname_github_codespaces %} compute usage and GB-months of storage you have used so far in the current billing month.
23
+
24
+

25
+
26
+
For information about "core hours" and "GB-months," see "[About billing for {% data variables.product.prodname_github_codespaces %}](/enterprise-cloud@latest/billing/managing-billing-for-github-codespaces/about-billing-for-github-codespaces)."
27
+
28
+
1. Optionally, click **Usage hours** and **Storage** to see more details.
29
+
30
+

31
+
32
+
The **Included** column shows how many of the core hours of compute usage, or GB-months of storage, included free with your account, you have used so far this month. The **Paid** column shows how many billed core hours of usage, or GB-months of storage, you have used. The figures are updated once every hour.
33
+
34
+
In the screenshot above, the entire quota of included storage for the month has been used. When you've used all of either the included compute usage or storage (whichever is reached first), you must set up a payment method and a spending limit to continue using {% data variables.product.prodname_github_codespaces %} during the current billing month. For more information, see "[Adding or editing a payment method](/enterprise-cloud@latest/billing/managing-your-github-billing-settings/adding-or-editing-a-payment-method)" and "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces#managing-the-github-codespaces-spending-limit-for-your-personal-account)."
35
+
36
+
{% data reusables.codespaces.usage-report-download %}
37
+
38
+
## Viewing {% data variables.product.prodname_github_codespaces %} usage for your organization account
39
+
40
+
Organization owners and billing managers can view {% data variables.product.prodname_github_codespaces %} usage for the organization.
20
41
21
42
{% data reusables.organizations.billing-settings %}
22
43
1. Under "{% data variables.product.prodname_codespaces %}", view the details of the compute hours and storage used so far this month.
23
44
24
-

45
+

25
46
26
-
You can also see and update your current spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-spending-limits-for-github-codespaces)."
47
+
You can also see and update your current spending limit. For more information, see "[Managing spending limits for {% data variables.product.prodname_github_codespaces %}](/billing/managing-billing-for-github-codespaces/managing-the-spending-limit-for-github-codespaces)."
27
48
28
49
{% note %}
29
50
@@ -33,11 +54,7 @@ Organization owners and billing managers can view {% data variables.product.prod
33
54
34
55
{% endnote %}
35
56
36
-
{% data reusables.dotcom_billing.actions-packages-report-download-org-account %}
37
-
The data used for this report is updated daily.
38
-
1. Filter the report to show only rows that mention "Codespaces" in the `Product` field.
39
-
40
-

57
+
{% data reusables.codespaces.usage-report-download %}
41
58
42
59
{% ifversion ghec %}
43
60
## Viewing {% data variables.product.prodname_codespaces %} usage for your enterprise account
@@ -48,7 +65,7 @@ Enterprise owners and billing managers can view {% data variables.product.prodna
48
65
{% data reusables.enterprise-accounts.settings-tab %}
49
66
{% data reusables.enterprise-accounts.billing-tab %}
50
67
1. Under "{% data variables.product.prodname_codespaces %} monthly usage", view the usage details of each organization in your enterprise account.
51
-
{% data reusables.enterprise-accounts.actions-packages-report-download-enterprise-accounts %}
68
+
{% data reusables.codespaces.usage-report-download %}
0 commit comments