Set up billing to pay for users, pipelines, and cloud-based load testing in Visual Studio Team Services

Last Update: 12/5/2016

Team Services

You only have to set up billing when you need more Team Services users, pipelines for Build & Release, and virtual user minutes for Cloud-Based Load Testing than the free amounts get with your Team Services account, or when you want to buy paid Team Services extensions from the Visual Studio Marketplace. Learn what you get for free in Team Services.

If this is your first time paying for Team Services users, pipelines, or extensions, you can go directly to the Visual Studio Marketplace and set up billing during your first purchase:

Otherwise, if you're buying Cloud-Based Load Testing for the first time, or if you want to change the Azure subscription that you use for billing, follow the steps in this topic to go through the Azure portal.

To change the Azure subscription that's linked to your Team Services account, unlink your Team Services account, then relink your account to another Azure subscription.

What do I need to set up billing?

Microsoft Azure handles billing for your Team Services account, so you'll need:

Follow the steps for the Azure classic portal or Azure portal. Both portals give you the same results.

Azure classic portal

  1. Sign in to the Azure classic portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    Browser problems in Azure?

  2. Go to Visual Studio Team Services. Start linking your account.

    Link your Team Services account to your Azure subscription

  3. Go to Link to Existing. Select your Team Services account, if you have multiple accounts.

    Select Team Services account and Azure subscription

    Why don't my options look the same?

    If you have multiple subscriptions, you can also select an Azure subscription.

    Select Team Services account and Azure subscription

  4. Finish linking your account.

    After Azure sets up the link, your Team Services account appears linked to your Azure subscription.

    Your Team Services account appears in the Azure classic portal

Next

Azure portal

  1. Sign in to the Azure portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    Browser problems in Azure?

  2. Go to Browse > Team Services accounts. Select your Team Services account.

    Browse, Team Services accounts, select your account

  3. Select your Azure subscription. Finish linking your account.

    Select an Azure subscription

    After Azure sets up the link, your Team Services account appears linked to your Azure subscription.

    Your account is now linked to your Azure subscription

Next

Add backup billing managers for your Team Services account

To let others manage billing or make purchases for your Team Services account, add a Co-administrator to the Azure subscription that's linked to your Team Services account.

  1. Sign in to the Azure classic portal as the Azure subscription administrator.

    You can only add subscription Co-administrators through the Azure classic portal.

  2. Go to Settings > Administrators > Add. Add a Co-administrator to your Azure subscription.

    Add a Co-administrator to your Azure subscription

Next

Change the Azure subscription your Team Services account uses for billing

If you want to use another Azure subscription to bill purchases for your Team Services account, you can unlink your Team Services account from your current Azure subscription, and relink your account to another Azure subscription that's associated with you as the Team Services account owner.

What do I need to change my Azure subscription?

When you unlink your account, any paid users or pipelines that you've committed for the month will stay unaffected until the 1st of next month, but your account will revert immediately to the free monthly limits for Cloud-based Load Testing. This will also cancel any non-Microsoft paid extensions without refund or credit.

When you relink your account to another Azure subscription, you'll have to restore any previous amounts of paid users, pipelines, or Cloud-based Load Testing that you had. You'll also have to repurchase any paid non-Microsoft extensions from the Visual Studio Marketplace.

If you wait until the 1st of next month to relink, your account will revert back to 5 free users. Any paid users will appear expired in your Team Services account. So, make sure to restore any paid users promptly so they don't lose access on the 1st of next month. Learn more about what happens when you unlink your Team Services account.

Follow the steps for the Azure classic portal or Azure portal. Both portals give you the same results.

Azure classic portal

  1. Sign in to the Azure classic portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    Browser problems in Azure?

  2. Go to Visual Studio Team Services. Select your Team Services account. Unlink your account.

    Visual Studio Team Services, select your account, unlink your account

    Your Team Services account is removed from Azure. You'll now relink your account to a new Azure subscription.

  3. Go to New > Link to Existing. Select your Team Services account and your Azure subscription.

    Go to New, App Services, Visual Studio Team Services, Link to Existing. Select account and Azure subscription

    After you finish relinking, your account reappears in the Azure portal with your selected Azure subscription. For more details, see how to link your Team Services account to an Azure subscription.

  4. Follow these steps to restore any paid users, pipelines, or virtual user minutes for Cloud-based Load Testing.

Azure portal

  1. Sign in to the Azure portal as Team Services account owner and as Azure subscription Co-administrator or greater.

    If you experience browser problems with Azure, make sure that you use a supported browser.

  2. Go to Browse > Team Services accounts. Select your Team Services account.

    Browse, Team Services, select your account

  3. Unlink your account.

    Unlink your account

    Your Team Services account is removed from Azure. You'll now relink your account to a new Azure subscription.

  4. Go to Browse > Team Services accounts. Select your Team Services account.

    Browse, Team Services accounts, select your account

  5. Select your Azure subscription. Finish relinking your account.

    Select an Azure subscription

    After you finish relinking, your account reappears in the Azure portal with your selected Azure subscription. For more details, see how to link your Team Services account to an Azure subscription.

  6. Follow these steps to restore any paid users, agents, and amounts for team services that you had in Azure.

Q&A

Q: Why am I having browser problems with Azure?

A: This might happen if you're using an unsupported browser. For the best experience, please check that you're using a supported browser.

Q: How do I find the account owner?

If you have at least Basic access, you can find the current owner in your Team Services account settings.

  1. Go to your Team Services account settings.

    Go to account settings

  2. Under Settings, find the current owner.

    Find current owner

Q: Why don't I see the Team Services accounts that I own after I sign in to my Visual Studio profile on visualstudio.com?

A: The list of accounts that you own are associated with the identity that you use to sign in to Visual Studio Team Services.

If you were asked to choose between your personal Microsoft account, or your work or school account when you signed in, you might have selected the wrong identity.

Choose work or school account, or personal Microsoft account

Please try signing out completely from Team Services, then sign in again, and select your other identity.

Here's how you can sign out completely because just closing your browser doesn't always sign you out completely from Team Services:

  1. Close all browsers, including those that aren't running Team Services.

  2. Open a private or incognito browsing session.

  3. Go to this URL: http://aka.ms/vssignout

    You'll get a message that says "Sign out in progress". After you're signed out, you're redirected to the Visual Studio page @www.visualstudio.com.

    Tip If the sign-out page takes more than a minute, close the browser, and continue.

  4. Sign in to Visual Studio Team Services again. Select your other identity.

A: You can use an Azure subscription that's not:

If you have one of these subscriptions, set up a separate Pay-As-You-Go Azure subscription instead.

Important for Visual Studio subscribers and Visual Studio Dev Essentials members:

Q: Why don't my options look the same?

A: Your options might look different based on the Team Services account that you select and how that account is set up:

  • URL: This list shows only the Team Services accounts that you own. Why don't I see any accounts?

  • Directory: The name of a directory appears here only when a directory is connected to the Team Services account selected in the URL box. This directory controls access and authenticates users for the selected Team Services account. Learn more about why a directory is connected to your account.

  • Subscription: Appears only when you have more than one Azure subscription. These subscriptions are also filtered by the directories selected in the Azure classic portal's Subscriptions list:

    Subscriptions filter

Q: Why is a directory connected to my account?

A: Your Team Services account authenticates users through a directory, which is managed through Azure Active Directory (Azure AD). This directory controls who can get access to your account by requiring that all users belong to the directory to get access. Your Team Services account was connected to a directory when the account owner created the account or sometime after that.

Your directory administrator controls who can join the directory and get access. Otherwise, the Team Services account owner is solely responsible for managing access. Learn more about managing work access for your account.

A: This might happen because:

  • You're not the Team Services account owner.

  • You're not at least Co-administrator on the Azure subscription that you want to link.

  • If you don't see any Team Services accounts, your account might already linked to another Azure subscription.

  • If your Team Services account uses Azure Active Directory (Azure AD) to authenticate users, you might have a different directory selected in the Azure portal than the directory that's connected to your Team Services account.

    To select the directory that your Team Services account uses, open the Azure portal's Subscriptions list:

    Filter your subscriptions to the connected directory

Q: Are there billing restrictions that might stop me from linking my Team Services account to my Azure subscription?

A: Yes, you can link accounts in India South only to Azure subscriptions with billing addresses in the same region. Otherwise, you'll see this message:

"You need an Azure subscription that is valid for Team Services accounts in India South."

Q: Why is my Team Services account already linked to an Azure subscription?

A: This happens if your Team Services account was already set up for billing with an Azure subscription, either manually through Azure or while purchasing from the Visual Studio Marketplace for your account. The selected Azure subscription is also used to bill all later purchases for your account.

A: Yes, you can link an Azure subscription to multiple Team Services accounts. But you can't link a Team Services account to multiple Azure subscriptions.

Q: How does Azure billing work?

A: When you link your Team Services account to an Azure subscription, you select an eligible Azure subscription where you have Co-administrator permissions or greater. If you don't have an Azure subscription, you can either sign up for a new one, or have an Azure administrator add you as Co-Administrator to an Azure subscription that you can use to bill purchases.

Payment is set up with a credit card, or by invoice in some cases. Charges for your purchases will show up on your monthly Azure bill.

Note: You must keep your Azure subscription in good standing to use your Team Services purchases. If your Azure subscription is canceled or becomes disabled, for example, because the credit card used for payment expires, then any purchases with this Azure subscription will be deactivated on the 1st day of next month. To avoid losing access to your Team Services purchases, please keep your Azure subscription active and updated.

For example, if you paid for users with an Azure subscription that becomes disabled, those users will lose access on the 1st of next month.

Q: When do I get billed?

A: You're charged only after you've paid for users or used team services above the free limits. Your charges are prorated during the 1st month. After that, you're billed automatically on the 1st day of the calendar month. Learn more about pricing here.

Q: Why is my first Azure bill larger than expected?

A: Charges for your first purchase are prorated during the 1st month and are combined with charges for the next month, which are billed on the 1st day of the calendar month. This means your first Azure bill might include these partial charges and your 1st full month.

Q: How do I stop billing?

A: Sign in to the Azure classic portal or the Azure portal as the Team Services account owner or at least Azure subscription Co-administrator. Select your Team Services account, reduce any paid users to zero, and turn off any paid team services. Your Team Services account and bill won't show any changes in paid users or team services until next month when these changes take effect. You're still charged for team services that you've already used.

Q: What happens if I cancel my Azure subscription?

A: Your Team Services account goes back to the free monthly limits, but you'll keep any paid users or team services until next month. Your account stays linked to your Azure subscription until you unlink your account, or until your account unlinks automatically when your Azure subscription is disabled.

Q: What happens if my credit card expires?

A: Your Team Services account goes back to the free monthly limits, but you'll keep any paid users or team services until next month. Your Azure subscription will eventually become disabled, but fixing this issue reactivates your subscription and restores your account's paid settings.

Q: What happens if my Azure subscription is disabled?

A: If you're the Team Services account owner or Azure subscription Account Administrator, check your subscription status here, then try to fix your subscription. This will restore your account's paid settings. Or you can link your Team Services account to another Azure subscription by unlinking your account from the disabled subscription. While your subscription is disabled, your account goes back to the free monthly limits until your subscription is fixed.

A: Your account will revert to the free amounts of users and pipelines on the 1st of next month, but Cloud-based Load Testing immediately reverts to your free monthly limits. Unlinking will cancel paid non-Microsoft extensions without refund or credit.

You can relink your account to another Azure subscription by going to the Visual Studio Marketplace and repurchasing any Team Services users, pipelines, or other extensions that you paid for this month.

We won't charge your new Azure subscription until next month for users, pipelines, or other Microsoft extensions that were billed this month to your old Azure subscription. However, non-Microsoft extensions are charged immediately as new purchases.

If you wait until the 1st of next month to relink, your account will revert to the free amounts. Any paid users will appear expired in your account's Users hub. Make sure that you repurchase any paid users promptly so they don't lose access on the 1st of next month.

Q: Where can I check my bill or update billing details on my Azure subscription?

A: If you're the Azure Account Administrator, view your subscription at the Azure account portal.

Q: What if I have other questions about Azure subscriptions and billing?

A: Check the Azure Billing and Subscription FAQ, or try Azure Support.

Q: How do I get help or support for Team Services?

A: Try the Team Services forum or Team Services Support.