Enterprise Server 3.19 is currently available as a release candidate.

Connecting an Azure subscription

You can enable and pay for usage-based billing on GitHub by connecting an Azure subscription.

Who can use this feature?

Billing managers or owners

In this article

You can pay for metered usage of GitHub features through Azure by connecting an Azure Subscription ID to your organization or enterprise account on GitHub. See Azure subscription payments.

Prerequisites

  • You must be an owner of the GitHub organization or enterprise account you want to connect to Azure.

  • You must know your Azure subscription ID. See Get subscription and tenant IDs in the Azure portal in the Microsoft Docs.

  • You must be logged into Azure as a user who is able to provide tenant-wide admin consent or arrange to work with an Azure AD global administrator to configure an admin consent workflow. See Azure subscription payments.

Connecting your Azure subscription to an organization or enterprise account

  1. Navigate to your organization or enterprise. For example, from https://github.com/settings/organizations or https://github.com/settings/enterprises.

  2. Click Billing & Licensing to display the billing and licensing overview for the account:

    • Organization accounts: under "Access" in the sidebar for settings.
    • Enterprise accounts: a separate tab at the top of the page.

  3. From the list of "Billing & licensing" pages, click Payment information.

  4. Scroll to the bottom of the page, to the right of "Metered billing via Azure", click Add Azure Subscription.

  5. Sign in to your Microsoft account.

  6. Review the "Permissions requested" prompt. If you agree with the terms, click Accept.

    If you don't see a "Permissions requested" prompt, and instead see a message indicating that you need admin approval, see Troubleshooting Azure subscription connection problems.

  7. Under "Select a subscription", select the Azure Subscription ID that you want to connect to your account.

    1. Select By clicking "Connect", you are confirming that you want to be billed for metered services via the selected Azure subscription.
    2. Click Connect.

    To select an Azure subscription, you must have owner permissions to the subscription. If the default tenant does not have the right permissions, you may need to specify a different tenant ID. For more information, see Azure subscription payments and Microsoft identity platform and OAuth 2.0 authorization code flow in Microsoft Docs.

Editing or disconnecting your Azure subscription from an account

If you disconnect your Azure subscription from your account, your usage can no longer exceed the amounts included with your plan.

  1. On the "Payment information" page, to the right of the subscription ID you want change.

    • Edit the subscription: Click to edit your subscription.
    • Disconnect the subscription Click to remove the connection.

Video demonstration of connecting a subscription

To connect an Azure subscription, you'll need appropriate access permissions on both GitHub and the Azure billing portal. This may require coordination between two different people.

To see a demo of the process from beginning to end, see Billing GitHub consumption through an Azure subscription on GitHub's YouTube channel. This video demonstrates the process for an enterprise account.

Further reading