<!DOCTYPE html><html class="layout layout-holy-grail show-table-of-contents reference show-breadcrumb default-focus theme-light" lang="en-us" dir="ltr" data-authenticated="false" data-auth-status-determined="true" data-target="docs" x-ms-format-detection="none" data-layout-restored="true" style="--window-inner-height: 720px !important; --atlas-header-height: 108px !important; --atlas-footer-height: 125px !important; --atlas-header-visible-height: 108px !important; --atlas-footer-visible-height: 0px !important;"><head>
			<title>Resource Groups - Create Or Update - REST API (Azure Resource Management) | Microsoft Learn</title>
			<meta charset="utf-8">
			<meta name="viewport" content="width=device-width, initial-scale=1.0">
			<meta name="color-scheme" content="light dark">

			<meta name="description" content="Learn more about Resource Management service - Creates or updates a resource group. ">
			<link rel="canonical" href="https://learn.microsoft.com/en-us/rest/api/resources/resource-groups/create-or-update?view=rest-resources-2021-04-01"> 

			<!-- Non-customizable open graph and sharing-related metadata -->
			<meta name="twitter:card" content="summary_large_image">
			<meta name="twitter:site" content="@MicrosoftLearn">
			<meta property="og:type" content="website">
			<meta property="og:image:alt" content="Microsoft Learn">
			<meta property="og:image" content="https://learn.microsoft.com/en-us/media/open-graph-image.png">
			<!-- Page specific open graph and sharing-related metadata -->
			<meta property="og:title" content="Resource Groups - Create Or Update - REST API (Azure Resource Management)">
			<meta property="og:url" content="https://learn.microsoft.com/en-us/rest/api/resources/resource-groups/create-or-update?view=rest-resources-2021-04-01">
			<meta property="og:description" content="Learn more about Resource Management service - Creates or updates a resource group. ">
			<meta name="platform_id" content="1f908cc7-b007-ca09-db4a-e3951b98e51c"> <meta name="scope" content="Azure,REST">
			<meta name="locale" content="en-us">
			 
			<meta name="uhfHeaderId" content="azure">

			<meta name="page_type" content="rest">

			<!--page specific meta tags-->
			

			<!-- custom meta tags -->
			
		<meta name="uid" content="management.azure.com.resources.resourcegroups.createorupdate">
	
		<meta name="schema" content="RESTOperation">
	
		<meta name="enable_rest_try_it" content="true">
	
		<meta name="rest_product" content="Azure">
	
		<meta name="breadcrumb_path" content="../../../breadcrumb/toc.json">
	
		<meta name="ms.author" content="kexu">
	
		<meta name="manager" content="smmark">
	
		<meta name="author" content="kexugit">
	
		<meta name="ms.topic" content="generated-reference">
	
		<meta name="ms.devlang" content="rest-api">
	
		<meta name="ms.date" content="2024-05-07T00:00:00Z">
	
		<meta name="products" content="https://authoring-docs-microsoft.poolparty.biz/devrel/4e834929-0ce1-4c1d-9c81-fcb14721edfb">
	
		<meta name="ms.service" content="azure-resource-manager">
	
		<meta name="moniker_definition_rel" content="../../../.monikers.Azure.AzureRestApi.json">
	
		<meta name="updated_at" content="2025-12-09T22:14:00Z">
	
		<meta name="original_content_git_url" content="https://github.com/MicrosoftDocs/azure-docs-rest-apis/blob/live/docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml">
	
		<meta name="gitcommit" content="https://github.com/MicrosoftDocs/azure-docs-rest-apis/blob/388178c1cc6333cd0c5157e04379eafaca602b68/docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml">
	
		<meta name="git_commit_id" content="388178c1cc6333cd0c5157e04379eafaca602b68">
	
		<meta name="monikers" content="rest-resources-2021-04-01">
	
		<meta name="default_moniker" content="rest-resources-2021-04-01">
	
		<meta name="site_name" content="Docs">
	
		<meta name="depot_name" content="Azure.AzureRestApi">
	
		<meta name="page_kind" content="operation">
	
		<meta name="toc_rel" content="../../azure/toc.json">
	
		<meta name="feedback_system" content="None">
	
		<meta name="feedback_product_url" content="">
	
		<meta name="feedback_help_link_type" content="">
	
		<meta name="feedback_help_link_url" content="">
	
		<meta name="asset_id" content="api/resources/resource-groups/create-or-update">
	
		<meta name="moniker_range_name" content="">
	
		<meta name="item_type" content="Content">
	
		<meta name="source_path" content="docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml">
	
		<meta name="use_moniker_list" content="1">
	
		<meta name="github_feedback_content_git_url" content="https://github.com/MicrosoftDocs/azure-docs-rest-apis/blob/main/docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml">
	
		<meta name="markdown_url" content="https://learn.microsoft.com/en-us/rest/api/resources/resource-groups/create-or-update?view=rest-resources-2021-04-01&amp;accept=text/markdown">
	 
		<meta name="cmProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/4e834929-0ce1-4c1d-9c81-fcb14721edfb" data-source="generated">
	
		<meta name="spProducts" content="https://authoring-docs-microsoft.poolparty.biz/devrel/75670257-a3f0-4627-9981-8046f99219e6" data-source="generated">
	

			<!-- Apply persisted/system theme before first paint to prevent wrong-theme flash when scripts are deferred. -->
			<script id="theme-preference">
				(function () {
			try {
				var stored = localStorage.getItem('theme');
				var theme = /^(light|dark|high-contrast)$/.test(stored)
					? stored
					: matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
				document.documentElement.classList.add('theme-' + theme);
			} catch (e) {}
		})();;
			</script>

			<script id="atlas-layout-preferences">
				(function () {
			try {
				var state = JSON.parse(localStorage.getItem('atlas-layout-preferences') || '{}');
				var view = state["docs-layout-persistence"] || {};
				var excludesKey = "";
				var blocked = {};
				if (excludesKey) {
					var exclusions = JSON.parse(localStorage.getItem('atlas-layout-exclusions') || '{}');
					if (Object.prototype.hasOwnProperty.call(exclusions, excludesKey)) {
						var scoped = exclusions[excludesKey];
						if (scoped) {
							if (typeof scoped === 'object') blocked = scoped;
						}
					}
				}
				var html = document.documentElement;
				for (var c in view) {
					if (Object.prototype.hasOwnProperty.call(blocked, c)) continue;
					if (view[c]) html.classList.add(c);
					else html.classList.remove(c);
				}
			} catch (e) {}
		})();;
			</script>

			<!-- assets and js globals -->
			
			<link rel="stylesheet" href="/static/assets/0.4.03503.8087-34604b98/styles/site.css">
			
			<script src="https://wcpstatic.microsoft.com/mscc/lib/v2/wcp-consent.js"></script>
			<script async="" src="https://js.monitor.azure.com/scripts/c/ms.jsll-4.min.js"></script>
			

			<!-- msdocs global object -->
			<script id="msdocs-script">
		var msDocs = {
  "environment": {
    "accessLevel": "online",
    "azurePortalHostname": "portal.azure.com",
    "reviewFeatures": false,
    "supportLevel": "production",
    "systemContent": true,
    "siteName": "learn",
    "legacyHosting": false
  },
  "data": {
    "contentLocale": "en-us",
    "contentDir": "ltr",
    "userLocale": "en-us",
    "userDir": "ltr",
    "pageTemplate": "Reference",
    "layoutStateStorageKey": "docs-layout-persistence",
    "brand": "azure",
    "context": {},
    "standardFeedback": false,
    "showFeedbackReport": false,
    "feedbackHelpLinkType": "",
    "feedbackHelpLinkUrl": "",
    "feedbackSystem": "None",
    "feedbackGitHubRepo": "",
    "feedbackProductUrl": "",
    "extendBreadcrumb": true,
    "isEditDisplayable": false,
    "isPrivateUnauthorized": false,
    "hideViewSource": false,
    "isPermissioned": false,
    "hasRecommendations": false,
    "contributors": []
  },
  "functions": {}
};;
	</script>

			<!-- base scripts, msdocs global should be before this -->
			<script src="/static/assets/0.4.03503.8087-34604b98/scripts/en-us/index-docs.js" async=""></script>
			

			<!-- json-ld -->
			
		<style>
		[data-moniker]:not([data-moniker~='rest-resources-2021-04-01']) {
			display: none !important;
		}
	</style><link rel="preload" as="image" href="/en-us/media/ask-learn/meet-ask-learn-base.png"><link rel="preload" as="image" href="/en-us/media/ask-learn/check-for-accuracy-base.png"><script type="application/ld+json">{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"name":"Learn","position":1,"@type":"ListItem","item":"https://learn.microsoft.com/en-us/?view=rest-resources-2021-04-01"},{"name":"Resource Groups - Create Or Update - REST API (Azure Resource Management)","position":2,"@type":"ListItem"}]}</script></head>
	
			<body id="body" data-bi-name="body" class="layout-body " lang="en-us" dir="ltr">
				<header class="layout-body-header background-color-body-medium">
		<div class="header-holder has-default-focus">
			
		<a href="#main" style="z-index: 1070" class="outline-color-text visually-hidden-until-focused position-fixed inner-focus focus-visible top-0 left-0 right-0 padding-xs text-align-center background-color-body">
			Skip to main content
		</a>
	
		<a href="#side-doc-outline" style="z-index: 1070" class="outline-color-text visually-hidden-until-focused position-fixed inner-focus focus-visible top-0 left-0 right-0 padding-xs text-align-center background-color-body">
			Skip to in-page navigation
		</a>
	
		<a href="#" data-skip-to-ask-learn="" style="z-index: 1070" class="outline-color-text visually-hidden-until-focused position-fixed inner-focus focus-visible top-0 left-0 right-0 padding-xs text-align-center background-color-body">
			Skip to Ask Learn chat experience
		</a>
	

			<div hidden="" id="cookie-consent-holder" data-test-id="cookie-consent-container"></div>
			<!-- Unsupported browser warning -->
			<div id="unsupported-browser" style="background-color: white; color: black; padding: 16px; border-bottom: 1px solid grey;" hidden="">
				<div style="max-width: 800px; margin: 0 auto;">
					<p style="font-size: 24px">This browser is no longer supported.</p>
					<p style="font-size: 16px; margin-top: 16px;">
						Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
					</p>
					<div style="margin-top: 12px;">
						<a href="https://go.microsoft.com/fwlink/p/?LinkID=2092881 " style="background-color: #0078d4; border: 1px solid #0078d4; color: white; padding: 6px 12px; border-radius: 2px; display: inline-block;">
							Download Microsoft Edge
						</a>
						<a href="https://learn.microsoft.com/en-us/lifecycle/faq/internet-explorer-microsoft-edge" style="background-color: white; padding: 6px 12px; border: 1px solid #505050; color: #171717; border-radius: 2px; display: inline-block;">
							More info about Internet Explorer and Microsoft Edge
						</a>
					</div>
				</div>
			</div>
			<!-- site header -->
			<div id="ms--site-header" data-test-id="site-header-wrapper" itemscope="itemscope" itemtype="http://schema.org/Organization">
				<div id="ms--mobile-nav" class="site-header display-none-tablet padding-inline-none gap-none" data-bi-name="mobile-header" data-test-id="mobile-header"><!----><div id="ms--site-header-hamburger" data-test-id="site-header-hamburger"><button type="button" class="button button-clear inner-focus" data-test-id="mobile-nav-open-button" data-bi-name="mobile-nav-open-button" title="Global navigation" aria-label="Global navigation"><span class="icon" aria-hidden="true"><span class="docon docon-menu"></span></span></button></div><a class="site-header-brand" itemprop="url" href="/en-us/" data-bi-name="site-header-brand-learn-mobile" data-test-id="site-header-brand-mobile"><span><!---->Learn<!----></span></a><!----><a href="https://www.microsoft.com" aria-label="Microsoft" itemprop="url" data-bi-name="site-header-microsoft-logo-mobile" data-test-id="site-header-microsoft-logo-mobile" class="site-header-logo site-header-logo-centered"><!----><svg aria-hidden="true" viewBox="0 0 25 25" fill="none" xmlns="http://www.w3.org/2000/svg" itemprop="logo" itemscope="itemscope"><path d="M11.5216 0.5H0V11.9067H11.5216V0.5Z" fill="#f25022"></path><path d="M24.2418 0.5H12.7202V11.9067H24.2418V0.5Z" fill="#7fba00"></path><path d="M11.5216 13.0933H0V24.5H11.5216V13.0933Z" fill="#00a4ef"></path><path d="M24.2418 13.0933H12.7202V24.5H24.2418V13.0933Z" fill="#ffb900"></path></svg><!----></a><!----><search-expander data-test-id="site-header-search-mobile" class="display-flex flex-grow-1 justify-content-flex-end"><div hidden="" id="ms--site-header-search-mobile" class="display-flex align-items-center gap-xxs width-full padding-left-xxs"><!----><form class="flex-grow-1" method="GET" role="search" id="ms--site-header-search-form-mobile" data-bi-name="site-header-search-form-mobile" name="site-header-search-form-mobile" aria-label="Search" action="/en-us/search/"><!----><div class="autocomplete display-block" data-bi-name="autocomplete"><!----><div class="field-body control "><input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-header-search-autocomplete-input-mobile" data-test-id="site-header-search-autocomplete-input-mobile" class="autocomplete-input input   width-full" type="search" name="terms" aria-expanded="false" aria-owns="ax-1-listbox" aria-controls="ax-1-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-header-search-autocomplete-input-mobile-description" placeholder="Search" data-bi-name="site-header-search-autocomplete-input-mobile" pattern=".*"> <span hidden="" id="ms--site-header-search-autocomplete-input-mobile-description"><!---->Suggestions will filter as you type<!----></span></div><ul role="listbox" id="ax-1-listbox" data-test-id="site-header-search-autocomplete-input-mobile-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden=""><!----> <!----></ul><!----></div><button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button><input name="category" hidden="" value="Reference"> <!----></form><button data-search-expander-trigger-close="" type="button" class="button button-clear inner-focus" aria-controls="ms--site-header-search-mobile" aria-label="Close search" data-bi-name="site-header-search-close-mobile" data-test-id="site-header-search-close-mobile"><span class="icon" aria-hidden="true"><span class="docon docon-navigate-close"></span></span></button></div><button data-search-expander-trigger-open="" type="button" class="button button-clear inner-focus" aria-controls="ms--site-header-search-mobile" aria-label="Open search" data-bi-name="site-header-search-open-mobile" data-test-id="site-header-search-open-mobile"><span class="icon" aria-hidden="true"><span class="docon docon-search"></span></span></button></search-expander><!----><!----><a href="#" data-bi-name="site-header-sign-in-mobile" data-test-id="site-header-sign-in-mobile" class="link-button font-size-sm flex-shrink-0 docs-sign-in auth-status-determined not-authenticated margin-right-xs margin-left-xxs"><!---->Sign in<!----></a> <details data-bi-name="site-header-user-mobile" class="popover popover-right auth-status-determined authenticated margin-right-xs margin-left-xxs"><summary data-bi-name="site-header-user-avatar" aria-label="Your Account" data-test-id="site-header-user-mobile"><div class="persona persona-sm"><figure class="persona-avatar"><img alt="" data-profile-property="avatarThumbnailUrl"></figure></div></summary><div class="popover-content width-auto" data-bi-name="site-header-user-menu"><div class="persona persona-sm"><figure class="persona-avatar"><img alt="" data-profile-property="avatarUrl" aria-labelledby="ms--user-display-name-mobile"></figure><div class="persona-details" data-test-id="persona-detail-mobile"><p class="persona-name" data-profile-property="displayName" id="ms--user-display-name-mobile"></p><p data-profile-property="upn"></p></div></div><ul class="padding-block-xs"><li class="padding-bottom-xs"><a data-profile-property="profileUrl" class="font-size-sm" data-bi-name="site-header-user-profile" href="https://learn.microsoft.com/en-us/users/me/activity/"><!---->Profile<!----></a></li><li class="padding-bottom-xs"><a class="font-size-sm" data-bi-name="site-header-user-analytics" href="https://learn.microsoft.com/en-us/users/me/analytics/"><!---->Analytics<!----></a></li><li><a data-profile-property="settingsUrl" class="font-size-sm" data-bi-name="site-header-user-settings" href="https://learn.microsoft.com/en-us/users/me/settings/"><!---->Settings<!----></a></li></ul><div class="border-top padding-top-xs"><a class="docs-sign-out font-size-sm" href="#" data-bi-name="site-header-sign-out-mobile" data-test-id="site-header-user-sign-out-mobile"><!---->Sign out<!----></a></div></div></details><!----> <!----></div>
				<div id="ms--primary-nav" class="site-header display-none display-flex-tablet" data-bi-name="L1-header" data-test-id="primary-header"><!----><!----><a href="https://www.microsoft.com" aria-label="Microsoft" itemprop="url" data-bi-name="site-header-microsoft-logo" data-test-id="site-header-microsoft-logo" class="site-header-logo "><!----><svg aria-hidden="true" viewBox="0 0 25 25" fill="none" xmlns="http://www.w3.org/2000/svg" itemprop="logo" itemscope="itemscope"><path d="M11.5216 0.5H0V11.9067H11.5216V0.5Z" fill="#f25022"></path><path d="M24.2418 0.5H12.7202V11.9067H24.2418V0.5Z" fill="#7fba00"></path><path d="M11.5216 13.0933H0V24.5H11.5216V13.0933Z" fill="#00a4ef"></path><path d="M24.2418 13.0933H12.7202V24.5H24.2418V13.0933Z" fill="#ffb900"></path></svg><!----></a><div class="site-header-divider"></div><a class="site-header-brand" itemprop="url" href="/en-us/" data-bi-name="site-header-brand-learn" data-test-id="site-header-brand"><span><!---->Learn<!----></span></a><div id="ms--search-expander-wrapper" class="display-flex justify-content-space-between flex-grow-1 align-items-center overflow-x-hidden height-full"><!----><overflow-menu class="align-self-stretch" style="display: block; overflow: hidden; width: 100%;"><nav class="site-header-nav" data-bi-name="primary-nav" data-overflow-menu-container="" aria-label="Global" style="visibility: visible; overflow: hidden;"><button type="button" data-overflow-menu-prev-button="" data-bi-name="site-header-btn-prev" class="button button-clear button-sm inner-focus" hidden="" aria-label="Previous"><span class="icon" aria-hidden="true"><span class="docon docon-chevron-left-light"></span></span></button><ul class="display-flex gap-xxs-desktop"><!----><!----><li aria-setsize="4" aria-posinset="1"><panel-controller data-bi-name="site-header-btn-1-documentation"><button type="button" aria-expanded="false" class="site-header-button" data-overflow-menu-item="" aria-controls="ms--panel-1" data-test-id="site-header-panel-controller-1" style="white-space: nowrap;"><span><!---->Documentation<!----></span><span class="icon expanded-indicator" aria-hidden="true"><span class="docon docon-chevron-down-light"></span></span></button><div class="site-header-panel" hidden="" id="ms--panel-1" data-bi-name="panel-1-documentation" data-test-id="site-header-panel-1"><!----><div class="site-header-panel-content"><ul class="site-header-panel-links"><!----><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/docs/" data-bi-name="panel-link-1-all-product-documentation"><!---->All product documentation<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/azure/?product=popular" data-bi-name="panel-link-2-azure-documentation"><!---->Azure documentation<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/dynamics365/" data-bi-name="panel-link-3-dynamics-365-documentation"><!---->Dynamics 365 documentation<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/copilot/" data-bi-name="panel-link-4-microsoft-copilot-documentation"><!---->Microsoft Copilot documentation<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/microsoft-365/" data-bi-name="panel-link-5-microsoft-365-documentation"><!---->Microsoft 365 documentation<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/power-platform/" data-bi-name="panel-link-6-power-platform-documentation"><!---->Power Platform documentation<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/samples/" data-bi-name="panel-link-7-code-samples"><!---->Code samples<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/troubleshoot/" data-bi-name="panel-link-8-troubleshooting-documentation"><!---->Troubleshooting documentation<!----></a></li><!----><!----></ul><!----></div><section class="site-header-panel-featured-content"><!----><!----><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="featured-card-1-msignite"><div class="card-content"><p class="card-supertitle line-clamp-2 line-height-normal"><!---->Register now<!----></p><a class="card-title color-text background-color-transparent stretched-link" href="https://ignite.microsoft.com/home?wt.mc_ID=msignite26_gmee_corp_np_oo_MSLearnRegLaunch"><!---->Microsoft Ignite | November 17-20, 2026<!----></a><p class="card-content-description line-clamp-2"><!---->Interactive learning, certifications, and direct access to experts all in one place.<!----></p></div></article><!----><!----></section> <!----></div></panel-controller></li><!----><li aria-setsize="4" aria-posinset="2"><panel-controller data-bi-name="site-header-btn-2-training"><button type="button" aria-expanded="false" class="site-header-button" data-overflow-menu-item="" aria-controls="ms--panel-2" data-test-id="site-header-panel-controller-2" style="white-space: nowrap;"><span><!---->Training &amp; Labs<!----></span><span class="icon expanded-indicator" aria-hidden="true"><span class="docon docon-chevron-down-light"></span></span></button><div class="site-header-panel" hidden="" id="ms--panel-2" data-bi-name="panel-2-training" data-test-id="site-header-panel-2"><!----><div class="site-header-panel-content"><ul class="site-header-panel-links"><!----><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/" data-bi-name="panel-link-1-training"><!---->All training<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/browse/?products=azure" data-bi-name="panel-link-2-azure-training"><!---->Azure training<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/browse/?products=dynamics-365" data-bi-name="panel-link-3-dynamics-365-training"><!---->Dynamics 365 training<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/browse/?products=ms-copilot" data-bi-name="panel-link-4-microsoft-copilot-training"><!---->Microsoft Copilot training<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/browse/?products=m365" data-bi-name="panel-link-5-microsoft-365-training"><!---->Microsoft 365 training<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/browse/?products=power-platform" data-bi-name="panel-link-6-microsoft-power-platform-training"><!---->Microsoft Power Platform training<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/labs/" data-bi-name="panel-link-7-labs"><!---->Labs<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/credentials/" data-bi-name="panel-link-8-credentials"><!---->Credentials<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/training/career-paths/" data-bi-name="panel-link-9-career-paths"><!---->Career paths<!----></a></li><!----><!----></ul><!----></div><section class="site-header-panel-featured-content"><!----><!----><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="featured-card-1-msignite"><div class="card-content"><p class="card-supertitle line-clamp-2 line-height-normal"><!---->Register now<!----></p><a class="card-title color-text background-color-transparent stretched-link" href="https://ignite.microsoft.com/home?wt.mc_ID=msignite26_gmee_corp_np_oo_MSLearnRegLaunch"><!---->Microsoft Ignite | November 17-20, 2026<!----></a><p class="card-content-description line-clamp-2"><!---->Interactive learning, certifications, and direct access to experts all in one place.<!----></p></div></article><!----><!----></section> <!----></div></panel-controller></li><!----><li aria-setsize="4" aria-posinset="3"><panel-controller data-bi-name="site-header-btn-3-qna"><button type="button" aria-expanded="false" class="site-header-button" data-overflow-menu-item="" aria-controls="ms--panel-3" data-test-id="site-header-panel-controller-3" style="white-space: nowrap;"><span><!---->Q&amp;A<!----></span><span class="icon expanded-indicator" aria-hidden="true"><span class="docon docon-chevron-down-light"></span></span></button><div class="site-header-panel" hidden="" id="ms--panel-3" data-bi-name="panel-3-qna" data-test-id="site-header-panel-3"><!----><div class="site-header-panel-content"><ul class="site-header-panel-links"><!----><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/questions/ask/" data-bi-name="panel-link-1-ask-a-question"><!---->Ask a question<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/tags/133/azure/" data-bi-name="panel-link-2-azure-questions"><!---->Azure questions<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/tags/60/windows/" data-bi-name="panel-link-3-windows-questions"><!---->Windows questions<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/tags/9/m365/" data-bi-name="panel-link-4-m365-questions"><!---->Microsoft 365 questions<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/tags/131/office-outlook/" data-bi-name="panel-link-5-microsoft-outlook-questions"><!---->Microsoft Outlook questions<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/tags/108/office-teams/" data-bi-name="panel-link-6-microsoft-teams-questions"><!---->Microsoft Teams questions<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/tags/" data-bi-name="panel-link-7-popular-tags"><!---->Popular tags<!----></a></li><!----><li><a class="button button-clear button-sm button-block text-align-left font-weight-normal justify-content-flex-start inner-focus border-none background-color-body-accent-onhover" href="/en-us/answers/questions/" data-bi-name="panel-link-8-all-questions"><!---->All questions<!----></a></li><!----><!----></ul><!----></div><section class="site-header-panel-featured-content"><!----><!----><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="featured-card-1-msignite"><div class="card-content"><p class="card-supertitle line-clamp-2 line-height-normal"><!---->Register now<!----></p><a class="card-title color-text background-color-transparent stretched-link" href="https://ignite.microsoft.com/home?wt.mc_ID=msignite26_gmee_corp_np_oo_MSLearnRegLaunch"><!---->Microsoft Ignite | November 17-20, 2026<!----></a><p class="card-content-description line-clamp-2"><!---->Interactive learning, certifications, and direct access to experts all in one place.<!----></p></div></article><!----><!----></section> <!----></div></panel-controller></li><!----><li aria-setsize="4" aria-posinset="4"><panel-controller data-bi-name="site-header-btn-4-topics"><button type="button" aria-expanded="false" class="site-header-button" data-overflow-menu-item="" aria-controls="ms--panel-4" data-test-id="site-header-panel-controller-4" style="white-space: nowrap;"><span><!---->Topics<!----></span><span class="icon expanded-indicator" aria-hidden="true"><span class="docon docon-chevron-down-light"></span></span></button><div class="site-header-panel" hidden="" id="ms--panel-4" data-bi-name="panel-4-topics" data-test-id="site-header-panel-4"><!----><div class="site-header-panel-content"><ul class="site-header-panel-cards"><!----><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-1-agents"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/agents/"><!---->Agents<!----></a><p class="card-content-description line-clamp-2"><!---->Key concepts and resources for agentic computing<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-2-ai"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/ai/"><!---->Artificial intelligence<!----></a><p class="card-content-description line-clamp-2"><!---->Curated resources for AI fluency with apps and services<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-3-devops"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/devops/"><!---->DevOps<!----></a><p class="card-content-description line-clamp-2"><!---->DevOps practices, Git version control and Agile methods<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-4-microsoft-learn-for-organizations"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/training/organizations/"><!---->Learn for Organizations<!----></a><p class="card-content-description line-clamp-2"><!---->Curated offerings from Microsoft to boost your team’s technical skills<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-5-security"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/security/"><!---->Security<!----></a><p class="card-content-description line-clamp-2"><!---->Guidance to help you tackle security challenges<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-6-startups"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/startups/"><!---->Startups hub<!----></a><p class="card-content-description line-clamp-2"><!---->Technical guidance to move toward enterprise readiness<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-7-assessments"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/assessments/"><!---->Assessments<!----></a><p class="card-content-description line-clamp-2"><!---->Interactive guidance with custom recommendations<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-8-student-hub"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/training/student-hub/"><!---->Student hub<!----></a><p class="card-content-description line-clamp-2"><!---->Self-paced and interactive training for students<!----></p></div></article></li><!----><li><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="panel-card-9-educator-center"><div class="card-content"><a class="card-title color-text background-color-transparent stretched-link" href="/en-us/training/educator-center/"><!---->Educator center<!----></a><p class="card-content-description line-clamp-2"><!---->Resources for educators to bring technical innovation in their classroom<!----></p></div></article></li><!----><!----></ul><!----></div><section class="site-header-panel-featured-content"><!----><!----><article class="card position-relative background-color-body-accent-onhover background-color-body-dark box-shadow-none" data-bi-name="featured-card-1-msignite"><div class="card-content"><p class="card-supertitle line-clamp-2 line-height-normal"><!---->Register now<!----></p><a class="card-title color-text background-color-transparent stretched-link" href="https://ignite.microsoft.com/home?wt.mc_ID=msignite26_gmee_corp_np_oo_MSLearnRegLaunch"><!---->Microsoft Ignite | November 17-20, 2026<!----></a><p class="card-content-description line-clamp-2"><!---->Interactive learning, certifications, and direct access to experts all in one place.<!----></p></div></article><!----><!----></section> <!----></div></panel-controller></li><!----><!----></ul><button type="button" data-overflow-menu-next-button="" data-bi-name="site-header-btn-next" class="button button-clear button-sm inner-focus margin-left-auto" hidden="" aria-label="Next"><span class="icon" aria-hidden="true"><span class="docon docon-chevron-right-light"></span></span></button></nav></overflow-menu><!----><search-expander data-test-id="site-header-search" class="flex-grow-1 margin-left-xxs"><div hidden="" id="ms--site-header-search" class="display-flex align-items-center gap-xxs "><!----><form class="flex-grow-1" method="GET" role="search" id="ms--site-header-search-form" data-bi-name="site-header-search-form" name="site-header-search-form" aria-label="Search" action="/en-us/search/"><!----><div class="autocomplete display-block" data-bi-name="autocomplete"><!----><div class="field-body control "><input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="site-header-search-autocomplete-input" data-test-id="site-header-search-autocomplete-input" class="autocomplete-input input input-sm  width-full" type="search" name="terms" aria-expanded="false" aria-owns="ax-0-listbox" aria-controls="ax-0-listbox" aria-activedescendant="" aria-label="Search" aria-describedby="ms--site-header-search-autocomplete-input-description" placeholder="Search" data-bi-name="site-header-search-autocomplete-input" pattern=".*"> <span hidden="" id="ms--site-header-search-autocomplete-input-description"><!---->Suggestions will filter as you type<!----></span></div><ul role="listbox" id="ax-0-listbox" data-test-id="site-header-search-autocomplete-input-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden=""><!----> <!----></ul><!----></div><button type="submit" class="visually-hidden" tabindex="-1" aria-hidden="true"></button><input name="category" hidden="" value="Reference"> <!----></form><button data-search-expander-trigger-close="" type="button" class="button button-clear inner-focus" aria-controls="ms--site-header-search" aria-label="Close search" data-bi-name="site-header-search-close" data-test-id="site-header-search-close"><span class="icon" aria-hidden="true"><span class="docon docon-navigate-close"></span></span></button></div><button data-search-expander-trigger-open="" type="button" class="button button-clear inner-focus" aria-controls="ms--site-header-search" aria-label="Open search" data-bi-name="site-header-search-open" data-test-id="site-header-search-open"><span class="icon" aria-hidden="true"><span class="docon docon-search"></span></span></button></search-expander><!----></div><!----><a href="#" data-bi-name="site-header-sign-in" data-test-id="site-header-sign-in" class="link-button font-size-sm flex-shrink-0 docs-sign-in auth-status-determined not-authenticated "><!---->Sign in<!----></a> <details data-bi-name="site-header-user" class="popover popover-right auth-status-determined authenticated "><summary data-bi-name="site-header-user-avatar" aria-label="Your Account" data-test-id="site-header-user"><div class="persona "><figure class="persona-avatar"><img alt="" data-profile-property="avatarThumbnailUrl"></figure></div></summary><div class="popover-content width-auto" data-bi-name="site-header-user-menu"><div class="persona "><figure class="persona-avatar"><img alt="" data-profile-property="avatarUrl" aria-labelledby="ms--user-display-name"></figure><div class="persona-details" data-test-id="persona-detail"><p class="persona-name" data-profile-property="displayName" id="ms--user-display-name"></p><p data-profile-property="upn"></p></div></div><ul class="padding-block-xs"><li class="padding-bottom-xs"><a data-profile-property="profileUrl" class="font-size-sm" data-bi-name="site-header-user-profile" href="https://learn.microsoft.com/en-us/users/me/activity/"><!---->Profile<!----></a></li><li class="padding-bottom-xs"><a class="font-size-sm" data-bi-name="site-header-user-analytics" href="https://learn.microsoft.com/en-us/users/me/analytics/"><!---->Analytics<!----></a></li><li><a data-profile-property="settingsUrl" class="font-size-sm" data-bi-name="site-header-user-settings" href="https://learn.microsoft.com/en-us/users/me/settings/"><!---->Settings<!----></a></li></ul><div class="border-top padding-top-xs"><a class="docs-sign-out font-size-sm" href="#" data-bi-name="site-header-sign-out" data-test-id="site-header-user-sign-out"><!---->Sign out<!----></a></div></div></details><!----> <!----></div>
				<div id="ms--secondary-nav" class="display-none display-flex-tablet" data-bi-name="L2-header" data-test-id="secondary-header"><!----><div class="site-header width-full"><!----> <a class="site-header-brand font-size-h6 padding-inline-none margin-right-xxs" itemprop="url" href="/en-us/azure/" data-bi-name="secondary-nav-link-category-azure"><span><!---->Azure <!----></span></a>  <nav class="site-header-nav width-auto" data-bi-name="secondary-nav" aria-label="Site"><ul class="display-flex"><!----><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  site-header-button-icon-chevron" aria-controls="bx-171" data-bi-name="secondary-nav-btn-1-products" value="undefined"><span><!---->Products<!----></span><span aria-hidden="true" class="icon expanded-indicator "><span class="docon docon-chevron-down-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-171" aria-label="Products" data-bi-name="secondary-nav-menu-1-products"><!----><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-172" data-bi-name="secondary-nav-btn-1-popular-products" value="undefined"><span><!---->Popular products<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-172" aria-label="Popular products" data-bi-name="secondary-nav-menu-1-popular-products"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/ai-foundry/" data-bi-name="secondary-nav-link-1-microsoft-foundry"><span><!---->Microsoft Foundry<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/app-service/" data-bi-name="secondary-nav-link-2-azure-app-service"><span><!---->Azure App Service<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/databricks/" data-bi-name="secondary-nav-link-3-azure-databricks"><span><!---->Azure Databricks<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/devops/" data-bi-name="secondary-nav-link-4-azure-devops"><span><!---->Azure DevOps<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/azure-functions/" data-bi-name="secondary-nav-link-5-azure-functions"><span><!---->Azure Functions<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/azure-monitor/" data-bi-name="secondary-nav-link-6-azure-monitor"><span><!---->Azure Monitor<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/virtual-machines/" data-bi-name="secondary-nav-link-7-azure-virtual-machines"><span><!---->Azure Virtual Machines<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-173" data-bi-name="secondary-nav-btn-2-popular-categories" value="undefined"><span><!---->Popular categories<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-173" aria-label="Popular categories" data-bi-name="secondary-nav-menu-2-popular-categories"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=compute" data-bi-name="secondary-nav-link-1-compute"><span><!---->Compute<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=networking" data-bi-name="secondary-nav-link-2-networking"><span><!---->Networking<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=storage" data-bi-name="secondary-nav-link-3-storage"><span><!---->Storage<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=ai-machine-learning" data-bi-name="secondary-nav-link-4-ai-and-machine-learning"><span><!---->AI &amp; machine learning<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=analytics" data-bi-name="secondary-nav-link-5-analytics"><span><!---->Analytics<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=databases" data-bi-name="secondary-nav-link-6-databases"><span><!---->Databases<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=security" data-bi-name="secondary-nav-link-7-security"><span><!---->Security<!----></span></a></li><!----><!----></ul></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/" data-bi-name="secondary-nav-link-3-view-all-products"><span><!---->View all products<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  site-header-button-icon-chevron" aria-controls="bx-174" data-bi-name="secondary-nav-btn-2-architecture" value="undefined"><span><!---->Architecture<!----></span><span aria-hidden="true" class="icon expanded-indicator "><span class="docon docon-chevron-down-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-174" aria-label="Architecture" data-bi-name="secondary-nav-menu-2-architecture"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/cloud-adoption-framework/" data-bi-name="secondary-nav-link-1-cloud-adoption-framework"><span><!---->Cloud Adoption Framework<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/well-architected/" data-bi-name="secondary-nav-link-2-well-architected-framework"><span><!---->Well-Architected Framework<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/architecture/" data-bi-name="secondary-nav-link-3-azure-architecture-center"><span><!---->Azure Architecture Center<!----></span></a></li><!----><!----></ul></li><!----><li><a data-test-id="header-link-migration" class="has-external-link-indicator site-header-button " href="/en-us/azure/migration/" data-bi-name="secondary-nav-link-3-migration"><span><!---->Migration<!----></span></a></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  site-header-button-icon-chevron" aria-controls="bx-175" data-bi-name="secondary-nav-btn-4-develop" value="undefined"><span><!---->Develop<!----></span><span aria-hidden="true" class="icon expanded-indicator "><span class="docon docon-chevron-down-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-175" aria-label="Develop" data-bi-name="secondary-nav-menu-4-develop"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/python/" data-bi-name="secondary-nav-link-1-python"><span><!---->Python<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/dotnet/azure/" data-bi-name="secondary-nav-link-2-dotnet"><span><!---->.NET<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/javascript/" data-bi-name="secondary-nav-link-3-javascript"><span><!---->JavaScript<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/java/" data-bi-name="secondary-nav-link-4-java"><span><!---->Java<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/powershell/azure/" data-bi-name="secondary-nav-link-5-powershell"><span><!---->PowerShell<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/cli/azure/" data-bi-name="secondary-nav-link-6-azure-cli"><span><!---->Azure CLI<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/" data-bi-name="secondary-nav-link-7-view-all-developer-resources"><span><!---->View all developer resources<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  site-header-button-icon-chevron" aria-controls="bx-176" data-bi-name="secondary-nav-btn-5-learn-azure" value="undefined"><span><!---->Learn Azure<!----></span><span aria-hidden="true" class="icon expanded-indicator "><span class="docon docon-chevron-down-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-176" aria-label="Learn Azure" data-bi-name="secondary-nav-menu-5-learn-azure"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/assessments/1c032171-8ca0-4032-8962-a38a5cc424a8/" data-bi-name="secondary-nav-link-1-start-your-ai-learning-assessment"><span><!---->Start your AI learning assessment<!----></span></a></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-177" data-bi-name="secondary-nav-btn-2-top-learning-paths" value="undefined"><span><!---->Top learning paths<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-177" aria-label="Top learning paths" data-bi-name="secondary-nav-menu-2-top-learning-paths"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/microsoft-azure-fundamentals-describe-cloud-concepts/" data-bi-name="secondary-nav-link-1-cloud-concepts"><span><!---->Cloud concepts<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/get-started-with-artificial-intelligence-on-azure/" data-bi-name="secondary-nav-link-2-ai-fundamentals"><span><!---->AI fundamentals<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/introduction-generative-ai/" data-bi-name="secondary-nav-link-3-intro-to-generative-ai"><span><!---->Intro to generative AI<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/azure-fundamentals-describe-azure-architecture-services/" data-bi-name="secondary-nav-link-4-azure-architecture-fundamentals"><span><!---->Azure Architecture fundamentals<!----></span></a></li><!----><!----></ul></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/credentials/browse/?products=azure" data-bi-name="secondary-nav-link-3-earn-credentials"><span><!---->Earn credentials<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/browse/?products=azure&amp;resource_type=course" data-bi-name="secondary-nav-link-4-instructor-led-courses"><span><!---->Instructor-led courses<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/azure/" data-bi-name="secondary-nav-link-5-view-all-training"><span><!---->View all training<!----></span></a></li><!----><!----></ul></li><!----><li><a data-test-id="header-link-troubleshooting" class="has-external-link-indicator site-header-button " href="/en-us/troubleshoot/azure/" data-bi-name="secondary-nav-link-6-troubleshooting"><span><!---->Troubleshooting<!----></span></a></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  site-header-button-icon-chevron" aria-controls="bx-178" data-bi-name="secondary-nav-btn-7-resources" value="undefined"><span><!---->Resources<!----></span><span aria-hidden="true" class="icon expanded-indicator "><span class="docon docon-chevron-down-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-178" aria-label="Resources" data-bi-name="secondary-nav-menu-7-resources"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/get-started" data-bi-name="secondary-nav-link-1-product-overview"><span><!---->Product overview<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/updates" data-bi-name="secondary-nav-link-2-azure-updates"><span><!---->Azure updates<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/pricing/" data-bi-name="secondary-nav-link-3-pricing-information"><span><!---->Pricing information<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/cost-management-billing/" data-bi-name="secondary-nav-link-4-cost-management-billing"><span><!---->Cost management &amp; billing<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/blog/" data-bi-name="secondary-nav-link-5-latest-blog-posts"><span><!---->Latest blog posts<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/support/options/" data-bi-name="secondary-nav-link-6-support-options"><span><!---->Support options<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown" hidden=""><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  site-header-button-icon-chevron" aria-controls="bx-179" data-bi-name="secondary-nav-btn-more" value="undefined"><span><!---->More<!----></span><span aria-hidden="true" class="icon expanded-indicator "><span class="docon docon-chevron-down-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-179" aria-label="More" data-bi-name="secondary-nav-menu-more"><!----><!----><li class="dropdown" hidden=""><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-180" data-bi-name="secondary-nav-btn-1-products" value="undefined"><span><!---->Products<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-180" aria-label="Products" data-bi-name="secondary-nav-menu-1-products"><!----><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-181" data-bi-name="secondary-nav-btn-1-popular-products" value="undefined"><span><!---->Popular products<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-181" aria-label="Popular products" data-bi-name="secondary-nav-menu-1-popular-products"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/ai-foundry/" data-bi-name="secondary-nav-link-1-microsoft-foundry"><span><!---->Microsoft Foundry<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/app-service/" data-bi-name="secondary-nav-link-2-azure-app-service"><span><!---->Azure App Service<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/databricks/" data-bi-name="secondary-nav-link-3-azure-databricks"><span><!---->Azure Databricks<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/devops/" data-bi-name="secondary-nav-link-4-azure-devops"><span><!---->Azure DevOps<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/azure-functions/" data-bi-name="secondary-nav-link-5-azure-functions"><span><!---->Azure Functions<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/azure-monitor/" data-bi-name="secondary-nav-link-6-azure-monitor"><span><!---->Azure Monitor<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/virtual-machines/" data-bi-name="secondary-nav-link-7-azure-virtual-machines"><span><!---->Azure Virtual Machines<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-182" data-bi-name="secondary-nav-btn-2-popular-categories" value="undefined"><span><!---->Popular categories<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-182" aria-label="Popular categories" data-bi-name="secondary-nav-menu-2-popular-categories"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=compute" data-bi-name="secondary-nav-link-1-compute"><span><!---->Compute<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=networking" data-bi-name="secondary-nav-link-2-networking"><span><!---->Networking<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=storage" data-bi-name="secondary-nav-link-3-storage"><span><!---->Storage<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=ai-machine-learning" data-bi-name="secondary-nav-link-4-ai-and-machine-learning"><span><!---->AI &amp; machine learning<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=analytics" data-bi-name="secondary-nav-link-5-analytics"><span><!---->Analytics<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=databases" data-bi-name="secondary-nav-link-6-databases"><span><!---->Databases<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/?product=security" data-bi-name="secondary-nav-link-7-security"><span><!---->Security<!----></span></a></li><!----><!----></ul></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/" data-bi-name="secondary-nav-link-3-view-all-products"><span><!---->View all products<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown" hidden=""><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-183" data-bi-name="secondary-nav-btn-2-architecture" value="undefined"><span><!---->Architecture<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-183" aria-label="Architecture" data-bi-name="secondary-nav-menu-2-architecture"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/cloud-adoption-framework/" data-bi-name="secondary-nav-link-1-cloud-adoption-framework"><span><!---->Cloud Adoption Framework<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/well-architected/" data-bi-name="secondary-nav-link-2-well-architected-framework"><span><!---->Well-Architected Framework<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/architecture/" data-bi-name="secondary-nav-link-3-azure-architecture-center"><span><!---->Azure Architecture Center<!----></span></a></li><!----><!----></ul></li><!----><li hidden=""><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/migration/" data-bi-name="secondary-nav-link-3-migration"><span><!---->Migration<!----></span></a></li><!----><li class="dropdown" hidden=""><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-184" data-bi-name="secondary-nav-btn-4-develop" value="undefined"><span><!---->Develop<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-184" aria-label="Develop" data-bi-name="secondary-nav-menu-4-develop"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/python/" data-bi-name="secondary-nav-link-1-python"><span><!---->Python<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/dotnet/azure/" data-bi-name="secondary-nav-link-2-dotnet"><span><!---->.NET<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/javascript/" data-bi-name="secondary-nav-link-3-javascript"><span><!---->JavaScript<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/java/" data-bi-name="secondary-nav-link-4-java"><span><!---->Java<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/powershell/azure/" data-bi-name="secondary-nav-link-5-powershell"><span><!---->PowerShell<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/cli/azure/" data-bi-name="secondary-nav-link-6-azure-cli"><span><!---->Azure CLI<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/developer/" data-bi-name="secondary-nav-link-7-view-all-developer-resources"><span><!---->View all developer resources<!----></span></a></li><!----><!----></ul></li><!----><li class="dropdown" hidden=""><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-185" data-bi-name="secondary-nav-btn-5-learn-azure" value="undefined"><span><!---->Learn Azure<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-185" aria-label="Learn Azure" data-bi-name="secondary-nav-menu-5-learn-azure"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/assessments/1c032171-8ca0-4032-8962-a38a5cc424a8/" data-bi-name="secondary-nav-link-1-start-your-ai-learning-assessment"><span><!---->Start your AI learning assessment<!----></span></a></li><!----><li class="dropdown"><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-186" data-bi-name="secondary-nav-btn-2-top-learning-paths" value="undefined"><span><!---->Top learning paths<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-186" aria-label="Top learning paths" data-bi-name="secondary-nav-menu-2-top-learning-paths"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/microsoft-azure-fundamentals-describe-cloud-concepts/" data-bi-name="secondary-nav-link-1-cloud-concepts"><span><!---->Cloud concepts<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/get-started-with-artificial-intelligence-on-azure/" data-bi-name="secondary-nav-link-2-ai-fundamentals"><span><!---->AI fundamentals<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/introduction-generative-ai/" data-bi-name="secondary-nav-link-3-intro-to-generative-ai"><span><!---->Intro to generative AI<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/paths/azure-fundamentals-describe-azure-architecture-services/" data-bi-name="secondary-nav-link-4-azure-architecture-fundamentals"><span><!---->Azure Architecture fundamentals<!----></span></a></li><!----><!----></ul></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/credentials/browse/?products=azure" data-bi-name="secondary-nav-link-3-earn-credentials"><span><!---->Earn credentials<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/browse/?products=azure&amp;resource_type=course" data-bi-name="secondary-nav-link-4-instructor-led-courses"><span><!---->Instructor-led courses<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/training/azure/" data-bi-name="secondary-nav-link-5-view-all-training"><span><!---->View all training<!----></span></a></li><!----><!----></ul></li><!----><li hidden=""><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/troubleshoot/azure/" data-bi-name="secondary-nav-link-6-troubleshooting"><span><!---->Troubleshooting<!----></span></a></li><!----><li class="dropdown" hidden=""><button type="button" aria-expanded="false" class="dropdown-trigger site-header-button  width-full justify-content-space-between padding-inline-xs padding-block-xxs" aria-controls="bx-187" data-bi-name="secondary-nav-btn-7-resources" value="undefined"><span><!---->Resources<!----></span><span aria-hidden="true" class="icon  margin-left-xs"><span class="docon docon-chevron-right-light"></span></span></button><ul class="dropdown-menu padding-bottom-xxs background-color-body-medium" id="bx-187" aria-label="Resources" data-bi-name="secondary-nav-menu-7-resources"><!----><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/get-started" data-bi-name="secondary-nav-link-1-product-overview"><span><!---->Product overview<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/updates" data-bi-name="secondary-nav-link-2-azure-updates"><span><!---->Azure updates<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/pricing/" data-bi-name="secondary-nav-link-3-pricing-information"><span><!---->Pricing information<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="/en-us/azure/cost-management-billing/" data-bi-name="secondary-nav-link-4-cost-management-billing"><span><!---->Cost management &amp; billing<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/blog/" data-bi-name="secondary-nav-link-5-latest-blog-posts"><span><!---->Latest blog posts<!----></span></a></li><!----><li><a class="has-external-link-indicator site-header-button width-full justify-content-flex-start padding-inline-xs padding-block-xxs " href="https://azure.microsoft.com/support/options/" data-bi-name="secondary-nav-link-6-support-options"><span><!---->Support options<!----></span></a></li><!----><!----></ul></li><!----><!----></ul></li><!----><!----></ul></nav><span class="nav-bar-spacer"></span><div class="buttons"><!----><a data-test-id="navbar-primary-cta" class="button button-sm button-primary " href="https://portal.azure.com" data-bi-name="secondary-nav-cta-secondary-portal"><!---->Portal<!----></a> <a data-test-id="navbar-primary-cta" class="button button-sm button-primary button-filled margin-right-none" href="https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn_nav_1f908cc7-b007-ca09-db4a-e3951b98e51c" data-bi-name="secondary-nav-cta-primary-get-started-with-azure"><!---->Get started with Azure<!----></a><!----></div>   <!----></div><!----></div>
			</div>
			
		<!-- banner -->
		<div data-banner="">
			<div id="disclaimer-holder"></div>
			
		</div>
		<!-- banner end -->
	
		</div>
	</header>
				 <section id="layout-body-menu" class="layout-body-menu border-right display-flex background-color-body-medium" data-bi-name="menu">
					
		<div id="left-container" class="left-container display-none padding-none display-block-tablet width-full display-none-until-layout-restored" data-toc-container="true" data-toc-collapsed="false">
			<div id="ms--toc-content" class="padding-left-sm padding-right-none padding-bottom-sm height-full">
				<nav id="affixed-left-container" class="margin-top-xxs-tablet position-sticky display-flex flex-direction-column width-full" aria-label="Primary" data-bi-name="left-toc" role="navigation" style="top: 8px; height: calc(-117px + 100vh); max-height: 5346px;">
					<div id="ms--collapsible-toc-header" class="display-flex flex-direction-row-reverse justify-content-center align-items-center margin-bottom-xxs margin-right-xxs">
						<button type="button" class="button button-clear inner-focus" data-collapsible-toc-toggle="" aria-expanded="true" aria-controls="ms--toc-content" aria-label="Collapse" title="Collapse" data-bi-name="toc-collapse">
							<span class="icon icon-mirrored-rtl font-size-md" aria-hidden="true">
								<span class="docon docon-panel-left-contract display-none-layout-menu-collapsed"></span>
								<span class="docon docon-panel-left-expand display-none display-inline-layout-menu-collapsed"></span>
							</span>
						</button>
						<div id="ms--collapsible-toc-moniker-slot" class="flex-grow-1 display-none-layout-menu-collapsed"><span class="label" id="ax-5-picker-label"><!---->Version<!----></span></div>
					</div>
				<div class="moniker-picker2 margin-right-sm display-none-layout-menu-collapsed" data-bi-name="moniker-picker"><!----><nav class="dropdown margin-bottom-xxs" aria-labelledby="ax-5-picker-label"><button type="button" role="combobox" class="dropdown-trigger justify-content-flex-start button-block button button-sm inner-focus" aria-expanded="false" data-autofocus="" aria-controls="ax-5" aria-labelledby="ax-5-picker-label"><span class="has-text-overflow-ellipsis"><!---->2021-04-01<!----></span><span class="dropdown-button-chevron color-text" aria-hidden="true"><span class="icon"><span class="docon docon-chevron-down-light expanded-indicator"></span></span></span></button><ul class="dropdown-menu is-full-width is-vertically-scrollable" id="ax-5" aria-label="resources"><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2025-04-01"><!---->2025-04-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2023-11-01"><!---->2023-11-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2022-12-01"><!---->2022-12-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2022-11-01-preview"><!---->2022-11-01-preview<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2022-08-01-preview"><!---->2022-08-01-preview<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2022-06-01"><!---->2022-06-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2022-05-01"><!---->2022-05-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2021-07-01"><!---->2021-07-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2021-05-01"><!---->2021-05-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2021-04-01" aria-current="true"><!---->2021-04-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2020-10-01"><!---->2020-10-01<!----></a></li><!----><!----><!----><li><a class="preserve-view button button-sm button-clear button-block text-decoration-none inner-focus justify-content-flex-start has-text-wrap text-align-left" href="?view=rest-resources-2016-09-01"><!---->2016-09-01<!----></a></li><!----><!----> <!----></ul><!----></nav><!----></div><form action="javascript:" role="search" aria-label="Search" class="margin-bottom-xxs display-none-layout-menu-collapsed" style="padding-inline-end: 24px;"><label class="visually-hidden" for="ax-2">Search</label><div class="autocomplete display-block" data-bi-name="autocomplete"><!----><div class="field-body control has-icons-left"><input role="combobox" maxlength="100" aria-autocomplete="list" autocapitalize="off" autocomplete="off" autocorrect="off" spellcheck="false" id="ax-2" data-test-id="ax-2" class="autocomplete-input input input-sm control has-icons-left width-full" type="text" aria-expanded="false" aria-owns="ax-3-listbox" aria-controls="ax-3-listbox" aria-activedescendant="" aria-describedby="ms--ax-2-description" placeholder="Find by title" pattern=".*"><span aria-hidden="true" class="icon is-small is-left"><span class="color-text-subtle docon docon-find-by-title"></span></span> <span aria-hidden="true" class="autocomplete-loader loader color-primary " hidden=""></span><span hidden="" id="ms--ax-2-description"><!---->Suggestions will filter as you type<!----></span></div><ul role="listbox" id="ax-3-listbox" data-test-id="ax-2-listbox" class="autocomplete-suggestions is-vertically-scrollable padding-xxs " aria-label="Suggestions" hidden=""><!----> <!----></ul><!----></div></form><ul class="tree table-of-contents is-vertically-scrollable flex-grow-1 flex-shrink-1 padding-right-sm display-none-layout-menu-collapsed" role="tree" aria-label="Table of contents" data-bi-name="tree" data-is-collapsible="true"><li role="none"><a aria-setsize="1" aria-level="1" aria-posinset="1" role="treeitem" tabindex="0" class="tree-item tree-leaf has-external-link-indicator is-selected" data-bi-name="tree-leaf" href="https://learn.microsoft.com/en-us/rest/api/resources/resource-groups/create-or-update?view=rest-resources-2021-04-01" aria-current="page">Resource Groups - Create Or Update - REST API (Azure Resource Management)</a></li></ul></nav>
			</div>
		</div>
	
			  </section>

				<main id="main" role="main" class="layout-body-main " data-bi-name="content" lang="en-us" dir="ltr">
					
			<div id="ms--content-header" class="content-header default-focus border-bottom-none" data-bi-name="content-header">
		<div class="content-header-controls margin-xxs margin-inline-sm-tablet">
			<button type="button" class="contents-button button button-sm margin-right-xxs" data-bi-name="contents-expand" aria-haspopup="true" data-contents-button="">
				<span class="icon" aria-hidden="true"><span class="docon docon-menu"></span></span>
				<span class="contents-expand-title"> Table of contents </span>
			</button>
			<button type="button" class="ap-collapse-behavior ap-expanded button button-sm" data-bi-name="ap-collapse" aria-controls="action-panel">
				<span class="icon" aria-hidden="true"><span class="docon docon-exit-mode"></span></span>
				<span>Exit editor mode</span>
			</button>
		</div>
	</div>
			<div data-main-column="" class="reading-width margin-inline-auto layout-padding padding-top-none padding-top-sm-tablet padding-bottom-sm">
				<div>
					
		<div id="article-header" class="background-color-body margin-bottom-xs display-none-print">
			<div class="display-flex align-items-center justify-content-space-between">
				
		<details id="article-header-breadcrumbs-overflow-popover" class="popover popover-left" data-for="article-header-breadcrumbs" hidden="">
			<summary class="button button-clear button-primary button-sm inner-focus" aria-label="All breadcrumbs">
				<span class="icon" aria-hidden="true">
					<span class="docon docon-more"></span>
				</span>
			</summary>
			<div id="article-header-breadcrumbs-overflow" class="popover-content"><!----><nav aria-label="All breadcrumbs"><ol class="list-style-none"><!----><!----><li><a class="button button-clear button-sm button-block text-align-left inner-focus justify-content-flex-start padding-xxs border-none font-weight-normal" href="https://learn.microsoft.com/en-us/?view=rest-resources-2021-04-01" title="Learn"><span class="line-clamp-1"><!---->Learn<!----></span></a></li><!----><!----><!----><!----></ol></nav> <!----></div>
		</details>

		<bread-crumbs id="article-header-breadcrumbs" role="group" aria-label="Breadcrumbs" data-test-id="article-header-breadcrumbs" class="overflow-hidden flex-grow-1 margin-right-sm margin-right-md-tablet margin-right-lg-desktop margin-left-negative-xxs padding-left-xxs" style="display: block; white-space: nowrap; overflow: hidden;"><!----><nav aria-label="Breadcrumb"><ol class="breadcrumbs"><!----><!----><li class="breadcrumbs-item" data-bread-crumbs-collapse-target="" style=""><a href="https://learn.microsoft.com/en-us/?view=rest-resources-2021-04-01" style=""><!---->Learn<!----></a></li><!----><!----><!----><!----></ol></nav><!----></bread-crumbs>
	 
		<div id="article-header-page-actions" class="margin-left-auto display-flex flex-wrap-no-wrap align-items-stretch">
			
		<button class="button button-sm border-none inner-focus display-none-tablet flex-shrink-0 " data-bi-name="ask-learn-assistant-entry" data-test-id="ask-learn-assistant-modal-entry-mobile" data-ask-learn-modal-entry="" type="button" style="min-width: max-content;" aria-expanded="false" aria-label="Ask Learn">
			<span class="icon font-size-lg" aria-hidden="true">
				<span class="docon docon-chat-sparkle-fill gradient-ask-learn-logo"></span>
			</span>
		</button>
		<button class="button button-sm display-none display-inline-flex-tablet display-none-desktop flex-shrink-0 margin-right-xxs border-color-ask-learn " data-bi-name="ask-learn-assistant-entry" data-test-id="ask-learn-assistant-modal-entry-tablet" data-ask-learn-modal-entry="" type="button" style="min-width: max-content;" aria-expanded="false">
			<span class="icon font-size-lg" aria-hidden="true">
				<span class="docon docon-chat-sparkle-fill gradient-ask-learn-logo"></span>
			</span>
			<span>Ask Learn</span>
		</button>
		<button class="button button-sm display-none flex-shrink-0 display-inline-flex-desktop margin-right-xxs border-color-ask-learn" data-bi-name="ask-learn-assistant-entry" data-test-id="ask-learn-assistant-flyout-entry" data-ask-learn-flyout-entry="" data-flyout-button="toggle" type="button" style="min-width: max-content;" aria-expanded="false" aria-controls="ask-learn-flyout">
			<span class="icon font-size-lg" aria-hidden="true">
				<span class="docon docon-chat-sparkle-fill gradient-ask-learn-logo"></span>
			</span>
			<span>Ask Learn</span>
		</button>
	 

			<details class="popover popover-right" id="article-header-page-actions-overflow">
				<summary class="justify-content-flex-start button button-clear button-sm button-primary inner-focus" aria-label="More actions" title="More actions">
					<span class="icon" aria-hidden="true">
						<span class="docon docon-more-vertical"></span>
					</span>
				</summary>
				<div class="popover-content">
					
		<button type="button" id="ms--focus-mode-button" data-focus-mode="" data-bi-name="focus-mode-entry" data-page-action-item="overflow-all" data-popover-close="" class="button button-clear button-sm button-block justify-content-flex-start text-align-left inner-focus display-none display-inline-flex-tablet" aria-pressed="false">
			<span class="icon" aria-hidden="true">
				<span class="docon docon-glasses"></span>
			</span>
			<span>Reading mode</span>
		</button>
	 
		<button data-page-action-item="overflow-mobile" type="button" class="display-block-layout-menu-collapsed button-block button-sm inner-focus button button-clear display-none-tablet justify-content-flex-start text-align-left" data-bi-name="contents-expand" data-contents-button="" data-popover-close="">
			<span class="icon" aria-hidden="true"><span class="docon docon-editor-list-bullet"></span></span>
			<span class="contents-expand-title">Table of contents</span>
		</button>
	 
		<a id="lang-link-overflow" class="button-sm inner-focus button button-clear button-block justify-content-flex-start text-align-left" data-bi-name="language-toggle" data-page-action-item="overflow-all" data-check-hidden="true" data-read-in-link="" href="https://learn.microsoft.com/en-us/rest/api/resources/resource-groups/create-or-update?view=rest-resources-2021-04-01&amp;tabs=HTTP" hidden="" data-bi="{&quot;cN&quot;:&quot;language-toggle&quot;,&quot;value&quot;:&quot;off&quot;}">
			<span class="icon" aria-hidden="true" data-read-in-link-icon="">
				<span class="docon docon-locale-globe"></span>
			</span>
			<span data-read-in-link-text="">Read in English</span>
		</a>
	
					
		<button type="button" class="collection button button-clear button-sm button-block justify-content-flex-start text-align-left inner-focus" data-list-type="collection" data-bi-name="collection" data-page-action-item="overflow-all" data-check-hidden="true" data-popover-close="" data-pressed="false" title="Add Resource Groups - Create Or Update - REST API (Azure Resource Management) | Microsoft Learn to a collection">
			<span class="icon" aria-hidden="true">
				<span class="docon docon-circle-addition"></span>
			</span>
			<span class="collection-status">Add to Collections</span>
		</button>
	 
		<button type="button" class="collection button button-block button-clear button-sm justify-content-flex-start text-align-left inner-focus" data-list-type="plan" data-bi-name="plan" data-page-action-item="overflow-all" data-check-hidden="true" data-popover-close="" data-pressed="false" title="Add Resource Groups - Create Or Update - REST API (Azure Resource Management) | Microsoft Learn to a plan">
			<span class="icon" aria-hidden="true">
				<span class="docon docon-circle-addition"></span>
			</span>
			<span class="plan-status">Add to Plans</span>
		</button>
	 
					
		<a data-contenteditbtn="" class="button button-clear button-block button-sm inner-focus justify-content-flex-start text-align-left text-decoration-none" data-bi-name="edit" data-page-action-item="overflow-all" data-check-hidden="true" hidden="" href="https://github.com/MicrosoftDocs/azure-docs-rest-apis/blob/main/docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml" data-original_content_git_url="https://github.com/MicrosoftDocs/azure-docs-rest-apis/blob/live/docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml" data-original_content_git_url_template="{repo}/blob/{branch}/docs-ref-autogen/resources/rest-resources-2021-04-01/Resource-Groups/Create-Or-Update.yml" data-pr_repo="" data-pr_branch="">
			<span class="icon" aria-hidden="true">
				<span class="docon docon-edit-outline"></span>
			</span>
			<span>Edit</span>
		</a>
	  
		<hr class="margin-block-xxs">
		
				<button class="button button-block button-clear button-sm justify-content-flex-start text-align-left inner-focus" type="button" data-bi-name="copy-markdown" data-page-action-item="overflow-all" data-copy-markdown="" data-copy-state="idle" data-check-hidden="true">
					<span class="icon color-primary" aria-hidden="true">
						<span data-show-when="idle" class="docon docon-code-lang"></span>
						<span data-show-when="loading" class="loader" hidden=""></span>
						<span data-show-when="success" class="docon docon-check-mark" hidden=""></span>
					</span>
					<span>Copy Markdown</span>
				</button>
		   
				<button class="button button-block button-clear button-sm justify-content-flex-start text-align-left inner-focus" type="button" data-bi-name="print" data-page-action-item="overflow-all" data-popover-close="" data-print-page="" data-check-hidden="true">
					<span class="icon color-primary" aria-hidden="true">
						<span class="docon docon-print"></span>
					</span>
					<span>Print</span>
				</button>
		  
	
				</div>
			</details>
		</div>
	
			</div>
		</div>
	  
		<!-- privateUnauthorizedTemplate is hidden by default -->
		<div unauthorized-private-section="" data-bi-name="permission-content-unauthorized-private" hidden="">
			<hr class="hr margin-top-xs margin-bottom-sm">
			<div class="notification notification-info">
				<div class="notification-content">
					<p class="margin-top-none notification-title">
						<span class="icon" aria-hidden="true"><span class="docon docon-exclamation-circle-solid"></span></span>
						<span>Note</span>
					</p>
					<p class="margin-top-none authentication-determined not-authenticated">
						Access to this page requires authorization. You can try <a class="docs-sign-in" href="#" data-bi-name="permission-content-sign-in">signing in</a> or <a class="docs-change-directory" data-bi-name="permisson-content-change-directory">changing directories</a>.
					</p>
					<p class="margin-top-none authentication-determined authenticated">
						Access to this page requires authorization. You can try <a class="docs-change-directory" data-bi-name="permisson-content-change-directory">changing directories</a>.
					</p>
				</div>
			</div>
		</div>
	
					<div class="content"></div>
					  
					<div class="content">

	<script>
		msDocs.data.restAPIData = {"httpVerb":"PUT","path":"https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01","uriParameters":[{"name":"resourceGroupName","in":"path","isRequired":true,"type":"string"},{"name":"subscriptionId","in":"path","isRequired":true,"type":"azure-subscriptions"},{"name":"api-version","in":"query","isRequired":true,"type":"string"}],"requestHeader":[],"requestBody":"{\n\t\"location\": \"\"\n}","security":[{"type":"oauth2","name":"azure_auth","flow":"implicit","authorizationUrl":"https://login.microsoftonline.com/common/oauth2/authorize","scopes":[{"name":"user_impersonation","description":"impersonate your user account"}],"tokenUrl":""}]};
	</script>

<h1>Resource Groups - Create Or Update</h1>

<div class="metadata" data-bi-name="page info">
		<dl class="attributeList">
			<dt>Service:</dt>
			<dd>
				Resource Management
			</dd>
		</dl>
		<dl class="attributeList">
			<dt>API Version:</dt>
			<dd>
				2021-04-01
			</dd>
		</dl>
</div>

<nav id="center-doc-outline" class="doc-outline display-none-desktop display-none-print margin-bottom-sm" data-bi-name="intopic toc" aria-label=""><!----><h2 id="ms--in-this-article" class="title is-6 margin-block-xs"><!---->In this article<!----></h2> <ol id="content-well-in-this-article-list" class="border-left padding-left-xxs"><!----><!----><li class=" "><a data-bi-name="h2-content-well" href="#uri-parameters" class=""><!---->URI Parameters<!----></a></li><!----><li class=" "><a data-bi-name="h2-content-well" href="#request-body" class=""><!---->Request Body<!----></a></li><!----><li class=" "><a data-bi-name="h2-content-well" href="#response" class=""><!---->Responses<!----></a></li><!----><li class=" "><a data-bi-name="h2-content-well" href="#security" class=""><!---->Security<!----></a></li><!----><li class=" expandable"><a data-bi-name="h2-content-well" href="#examples" class=""><!---->Examples<!----></a></li><!----><li class=" expandable"><a data-bi-name="h2-content-well" href="#definitions" class=""><!---->Definitions<!----></a></li><!----><!----></ol> <button type="button" aria-expanded="false" data-show-more="" class="link-button font-weight-semibold font-size-sm margin-top-xxs margin-left-xs" aria-controls="content-well-in-this-article-list" data-title="Show 2 more" data-bi-name="show-more-btn"><span class="show-more-text "><!---->Show 2 more<!----></span><!----></button>  <!----></nav>

<section>



	<p>Creates or updates a resource group.</p>


	


		<div class="code-block-header margin-top-sm" data-code-block-header="" id="code-try-0" data-bi-name="code-header"><!----><span class="code-block-header-language"><!---->HTTP<!----></span><div class="code-block-header-action-bar"><!----><button type="button" class="button display-none-print" data-bi-name="copy" data-code-header-copy-button=""><span class="icon" aria-hidden="true"><span class="docon docon-edit-copy overflow-hidden"></span><span data-copy-button-success-indicator="" class="successful-copy-alert position-absolute is-transparent docon docon-check-mark"></span></span><span><!---->Copy<!----></span></button> <button type="button" class="action action-interactive button button-primary button-filled display-none-print display-none-chromeless" data-code-header-action-button="" data-bi-name="code-header-try-it-http"><span class="icon" aria-hidden="true"><span class="docon docon-play"></span></span><span><!---->Try It<!----></span></button><!----></div><!----></div><pre data-interactive="http" class="inner-focus" role="group" aria-label="Horizontally scrollable code" tabindex="0" data-language="http"><code class="lang-http" dir="ltr"><span><span class="hljs-attribute">PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}?api-version=2021-04-01</span></span></code></pre>


		<div class="heading-wrapper" data-heading-level="h2"><a class="anchor-link docon docon-link" href="#uri-parameters" aria-label="Section titled: URI Parameters"></a><h2 id="uri-parameters" class="heading-anchor">URI Parameters</h2></div>
		<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="uri-parameters" class="parameters table table-sm margin-top-none">
			<tbody><tr>
				<th class="has-text-subtle">Name</th>
				<th class="has-text-subtle">In</th>
				<th class="has-text-subtle">Required</th>
				<th class="has-text-subtle">Type</th>
				<th class="has-text-subtle">Description</th>
			</tr>
				<tr>
					<td>
						<div class="parameterName">resource<wbr>Group<wbr>Name</div>
					</td>
					<td>path</td>
					<td>
							True
					</td>
					<td>

			<p>
					string


			</p>
	<span class="subtle">minLength: 1<br>maxLength: 90<br>pattern: ^[-\w\._\(\)]+$</span>
					</td>
					<td>
						<p>The name of the resource group to create or update. Can include alphanumeric, underscore, parentheses, hyphen, period (except at end), and Unicode characters that match the allowed characters.</p>

					</td>
				</tr>
				<tr>
					<td>
						<div class="parameterName">subscription<wbr>Id</div>
					</td>
					<td>path</td>
					<td>
							True
					</td>
					<td>

			<p>
					string


			</p>
	
					</td>
					<td>
						<p>The Microsoft Azure subscription ID.</p>

					</td>
				</tr>
				<tr>
					<td>
						<div class="parameterName">api-version</div>
					</td>
					<td>query</td>
					<td>
							True
					</td>
					<td>

			<p>
					string


			</p>
	
					</td>
					<td>
						<p>The API version to use for this operation.</p>

					</td>
				</tr>
		</tbody></table></div>


		<div class="heading-wrapper" data-heading-level="h2"><a class="anchor-link docon docon-link" href="#request-body" aria-label="Section titled: Request Body"></a><h2 id="request-body" class="heading-anchor">Request Body</h2></div>
			
			<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="default" class="parameters table table-sm margin-top-none">
				<tbody><tr>
					<th class="has-text-subtle">Name</th>
					<th class="has-text-subtle">Required</th>
					<th class="has-text-subtle">Type</th>
					<th class="has-text-subtle">Description</th>
				</tr>
<tr>
	<td>
		location
	</td>
	<td>
			True
	</td>
	<td>

			<p>
					string


			</p>
	
	</td>
	<td>
		<p>The location of the resource group. It cannot be changed after the resource group has been created. It must be one of the supported Azure locations.</p>

	</td>
</tr>
<tr>
	<td>
		managedBy
	</td>
	<td>
	</td>
	<td>

			<p>
					string


			</p>
	
	</td>
	<td>
		<p>The ID of the resource that manages this resource group.</p>

	</td>
</tr>
<tr>
	<td>
		properties
	</td>
	<td>
	</td>
	<td>

			<p>
					<a href="#resourcegroupproperties" data-linktype="self-bookmark">Resource<wbr>Group<wbr>Properties</a>


			</p>
	
	</td>
	<td>
		<p>The resource group properties.</p>

	</td>
</tr>
<tr>
	<td>
		tags
	</td>
	<td>
	</td>
	<td>

			<p>
					object


			</p>
	
	</td>
	<td>
		<p>The tags attached to the resource group.</p>

	</td>
</tr>
			</tbody></table></div>

		<div class="heading-wrapper" data-heading-level="h2"><a class="anchor-link docon docon-link" href="#response" aria-label="Section titled: Responses"></a><h2 id="response" class="heading-anchor">Responses</h2></div>
		<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="response" class="parameters definitions table table-sm margin-top-none margin-bottom-sm">
			<tbody><tr>
				<th class="is-narrow has-text-subtle">Name</th>
				<th class="is-narrow has-text-subtle">Type</th>
				<th class="has-text-subtle">Description</th>
			</tr>
<tr>
	<td>
		200 OK
	</td>
		<td>

			<p>
					<a href="#resourcegroup" data-linktype="self-bookmark">Resource<wbr>Group</a>


			</p>
	
		</td>
	<td>
		<p>OK - Returns information about the new resource group.</p>

	</td>
</tr>
<tr>
	<td>
		201 Created
	</td>
		<td>

			<p>
					<a href="#resourcegroup" data-linktype="self-bookmark">Resource<wbr>Group</a>


			</p>
	
		</td>
	<td>
		<p>Created - Returns information about the new resource group.</p>

	</td>
</tr>
<tr>
	<td>
		Other Status Codes
	</td>
		<td>

			<p>
					<a href="#clouderror" data-linktype="self-bookmark">Cloud<wbr>Error</a>


			</p>
	
		</td>
	<td>
		<p>Error response describing why the operation failed.</p>

	</td>
</tr>
		</tbody></table></div>



		<div class="heading-wrapper" data-heading-level="h2"><a class="anchor-link docon docon-link" href="#security" aria-label="Section titled: Security"></a><h2 id="security" class="heading-anchor">Security</h2></div>
			<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#azure-auth" aria-label="Section titled: azure_auth"></a><h3 id="azure-auth" class="heading-anchor">azure_auth</h3></div>
			<p>Azure Active Directory OAuth2 Flow</p>

			<p>
					<span class="font-weight-semibold">Type: </span>
					oauth2<br>
					<span class="font-weight-semibold">Flow: </span>
					implicit<br>
					<span class="font-weight-semibold">Authorization URL: </span>
					https://login.microsoftonline.com/common/oauth2/authorize<br>
			</p>
				<div class="heading-wrapper" data-heading-level="h4"><a class="anchor-link docon docon-link" href="#scopes" aria-label="Section titled: Scopes"></a><h4 id="scopes" class="heading-anchor">Scopes</h4></div>
				<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="scopes" class="table table-sm margin-top-none">
					<tbody><tr>
						<th>Name</th>
						<th>Description</th>
					</tr>
						<tr>
							<td>
								user_impersonation
							</td>
							<td>
								impersonate your user account
							</td>
						</tr>
				</tbody></table></div>

		<div class="heading-wrapper" data-heading-level="h2"><a class="anchor-link docon docon-link" href="#examples" aria-label="Section titled: Examples"></a><h2 id="examples" class="heading-anchor">Examples</h2></div>
				<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#create-or-update-a-resource-group" aria-label="Section titled: Create or update a resource group"></a><h3 id="create-or-update-a-resource-group" class="heading-anchor">Create or update a resource group</h3></div>
			<div class="example-block">
				<h4>Sample request</h4>
						<div class="tabGroup" id="tabgroup_1" data-bi-name="tab-group">
<ul role="tablist">
<li role="presentation">
<a href="#tabpanel_1_HTTP" role="tab" aria-controls="tabpanel_1_HTTP" data-tab="HTTP" tabindex="0" aria-selected="true" data-linktype="self-bookmark" data-bi-name="tab">HTTP</a>
</li>
</ul>
<section id="tabpanel_1_HTTP" role="tabpanel" data-tab="HTTP">

<div class="code-block-header margin-top-sm" data-code-block-header="" id="code-try-1" data-bi-name="code-header"><!----><span class="code-block-header-language"><!---->HTTP<!----></span><div class="code-block-header-action-bar"><!----><button type="button" class="button display-none-print" data-bi-name="copy" data-code-header-copy-button=""><span class="icon" aria-hidden="true"><span class="docon docon-edit-copy overflow-hidden"></span><span data-copy-button-success-indicator="" class="successful-copy-alert position-absolute is-transparent docon docon-check-mark"></span></span><span><!---->Copy<!----></span></button> <!----></div><!----></div><pre class="inner-focus" role="group" aria-label="Horizontally scrollable code" tabindex="0" data-language="http"><code class="lang-http"><span><span class="hljs-attribute">PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group?api-version=2021-04-01

{
  "location"</span>: "eastus"
}

</span></code></pre>
</section>
</div>

			</div>
				<div class="example-block">
					<h4>Sample response</h4>
						<div class="metadata">
								<dl class="attributeList">
									<dt>Status code: </dt>
									<dd>
										201
									</dd>
								</dl>
						</div>
							<div class="code-block-header margin-top-sm" data-code-block-header="" id="code-try-2" data-bi-name="code-header"><!----><span class="code-block-header-language"><!---->JSON<!----></span><div class="code-block-header-action-bar"><!----><button type="button" class="button display-none-print" data-bi-name="copy" data-code-header-copy-button=""><span class="icon" aria-hidden="true"><span class="docon docon-edit-copy overflow-hidden"></span><span data-copy-button-success-indicator="" class="successful-copy-alert position-absolute is-transparent docon docon-check-mark"></span></span><span><!---->Copy<!----></span></button> <!----></div><!----></div><pre class="inner-focus" role="group" aria-label="Horizontally scrollable code" tabindex="0" data-language="json"><code class="lang-json" dir="ltr"><span>{
  <span class="hljs-attr">"id"</span>: <span class="hljs-string">"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group"</span>,
  <span class="hljs-attr">"name"</span>: <span class="hljs-string">"my-resource-group"</span>,
  <span class="hljs-attr">"location"</span>: <span class="hljs-string">"eastus"</span>,
  <span class="hljs-attr">"properties"</span>: {
    <span class="hljs-attr">"provisioningState"</span>: <span class="hljs-string">"Succeeded"</span>
  }
}</span></code></pre>
						<div class="metadata stack">
								<dl class="attributeList">
									<dt>Status code: </dt>
									<dd>
										200
									</dd>
								</dl>
						</div>
							<div class="code-block-header margin-top-sm" data-code-block-header="" id="code-try-3" data-bi-name="code-header"><!----><span class="code-block-header-language"><!---->JSON<!----></span><div class="code-block-header-action-bar"><!----><button type="button" class="button display-none-print" data-bi-name="copy" data-code-header-copy-button=""><span class="icon" aria-hidden="true"><span class="docon docon-edit-copy overflow-hidden"></span><span data-copy-button-success-indicator="" class="successful-copy-alert position-absolute is-transparent docon docon-check-mark"></span></span><span><!---->Copy<!----></span></button> <!----></div><!----></div><pre class="inner-focus" role="group" aria-label="Horizontally scrollable code" tabindex="0" data-language="json"><code class="lang-json" dir="ltr"><span>{
  <span class="hljs-attr">"id"</span>: <span class="hljs-string">"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-resource-group"</span>,
  <span class="hljs-attr">"name"</span>: <span class="hljs-string">"my-resource-group"</span>,
  <span class="hljs-attr">"location"</span>: <span class="hljs-string">"eastus"</span>,
  <span class="hljs-attr">"properties"</span>: {
    <span class="hljs-attr">"provisioningState"</span>: <span class="hljs-string">"Succeeded"</span>
  }
}</span></code></pre>
				</div>

		<div class="heading-wrapper" data-heading-level="h2"><a class="anchor-link docon docon-link" href="#definitions" aria-label="Section titled: Definitions"></a><h2 id="definitions" class="heading-anchor">Definitions</h2></div>
			<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="definitions" class="table table-sm margin-top-none">
				<tbody><tr>
					<th>Name</th>
					<th>Description</th>
				</tr>
					<tr>
						<td>
							<a href="#clouderror" data-linktype="self-bookmark">Cloud<wbr>Error</a>
						</td>
						<td>
							<p>An error response for a resource management request.</p>

						</td>
					</tr>
					<tr>
						<td>
							<a href="#erroradditionalinfo" data-linktype="self-bookmark">Error<wbr>Additional<wbr>Info</a>
						</td>
						<td>
							<p>The resource management error additional info.</p>

						</td>
					</tr>
					<tr>
						<td>
							<a href="#errorresponse" data-linktype="self-bookmark">Error<wbr>Response</a>
						</td>
						<td>
							<p>Error Response</p>

						</td>
					</tr>
					<tr>
						<td>
							<a href="#resourcegroup" data-linktype="self-bookmark">Resource<wbr>Group</a>
						</td>
						<td>
							<p>Resource group information.</p>

						</td>
					</tr>
					<tr>
						<td>
							<a href="#resourcegroupproperties" data-linktype="self-bookmark">Resource<wbr>Group<wbr>Properties</a>
						</td>
						<td>
							<p>The resource group properties.</p>

						</td>
					</tr>
			</tbody></table></div>
			<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#clouderror" aria-label="Section titled: CloudError"></a><h3 class="margin-bottom-none heading-anchor" id="clouderror">Cloud<wbr>Error</h3></div>
			<div class="metadata">Object</div>
			<p>An error response for a resource management request.</p>

				<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="clouderror" class="parameters definitions table table-sm margin-top-none margin-bottom-sm">
					<tbody><tr>
						    <th class="is-narrow has-text-subtle">Name</th>
							<th class="is-narrow has-text-subtle">Type</th>
						<th class="has-text-subtle">Description</th>
					</tr>
<tr>
	<td>
		error
	</td>
		<td>

			<p>
					<a href="#errorresponse" data-linktype="self-bookmark">Error<wbr>Response</a>


			</p>
	
		</td>
	<td>
		<p>Error Response<br>
Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.)</p>

	</td>
</tr>
				</tbody></table></div>
			<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#erroradditionalinfo" aria-label="Section titled: ErrorAdditionalInfo"></a><h3 class="margin-bottom-none heading-anchor" id="erroradditionalinfo">Error<wbr>Additional<wbr>Info</h3></div>
			<div class="metadata">Object</div>
			<p>The resource management error additional info.</p>

				<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="erroradditionalinfo" class="parameters definitions table table-sm margin-top-none margin-bottom-sm">
					<tbody><tr>
						    <th class="is-narrow has-text-subtle">Name</th>
							<th class="is-narrow has-text-subtle">Type</th>
						<th class="has-text-subtle">Description</th>
					</tr>
<tr>
	<td>
		info
	</td>
		<td>

			<p>
					object


			</p>
	
		</td>
	<td>
		<p>The additional info.</p>

	</td>
</tr>
<tr>
	<td>
		type
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The additional info type.</p>

	</td>
</tr>
				</tbody></table></div>
			<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#errorresponse" aria-label="Section titled: ErrorResponse"></a><h3 class="margin-bottom-none heading-anchor" id="errorresponse">Error<wbr>Response</h3></div>
			<div class="metadata">Object</div>
			<p>Error Response</p>

				<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="errorresponse" class="parameters definitions table table-sm margin-top-none margin-bottom-sm">
					<tbody><tr>
						    <th class="is-narrow has-text-subtle">Name</th>
							<th class="is-narrow has-text-subtle">Type</th>
						<th class="has-text-subtle">Description</th>
					</tr>
<tr>
	<td>
		additionalInfo
	</td>
		<td>

			<p>
					<a href="#erroradditionalinfo" data-linktype="self-bookmark">Error<wbr>Additional<wbr>Info</a>[]


			</p>
	
		</td>
	<td>
		<p>The error additional info.</p>

	</td>
</tr>
<tr>
	<td>
		code
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The error code.</p>

	</td>
</tr>
<tr>
	<td>
		details
	</td>
		<td>

			<p>
					<a href="#errorresponse" data-linktype="self-bookmark">Error<wbr>Response</a>[]


			</p>
	
		</td>
	<td>
		<p>The error details.</p>

	</td>
</tr>
<tr>
	<td>
		message
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The error message.</p>

	</td>
</tr>
<tr>
	<td>
		target
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The error target.</p>

	</td>
</tr>
				</tbody></table></div>
			<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#resourcegroup" aria-label="Section titled: ResourceGroup"></a><h3 class="margin-bottom-none heading-anchor" id="resourcegroup">Resource<wbr>Group</h3></div>
			<div class="metadata">Object</div>
			<p>Resource group information.</p>

				<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="resourcegroup" class="parameters definitions table table-sm margin-top-none margin-bottom-sm">
					<tbody><tr>
						    <th class="is-narrow has-text-subtle">Name</th>
							<th class="is-narrow has-text-subtle">Type</th>
						<th class="has-text-subtle">Description</th>
					</tr>
<tr>
	<td>
		id
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The ID of the resource group.</p>

	</td>
</tr>
<tr>
	<td>
		location
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The location of the resource group. It cannot be changed after the resource group has been created. It must be one of the supported Azure locations.</p>

	</td>
</tr>
<tr>
	<td>
		managedBy
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The ID of the resource that manages this resource group.</p>

	</td>
</tr>
<tr>
	<td>
		name
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The name of the resource group.</p>

	</td>
</tr>
<tr>
	<td>
		properties
	</td>
		<td>

			<p>
					<a href="#resourcegroupproperties" data-linktype="self-bookmark">Resource<wbr>Group<wbr>Properties</a>


			</p>
	
		</td>
	<td>
		<p>The resource group properties.</p>

	</td>
</tr>
<tr>
	<td>
		tags
	</td>
		<td>

			<p>
					object


			</p>
	
		</td>
	<td>
		<p>The tags attached to the resource group.</p>

	</td>
</tr>
<tr>
	<td>
		type
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The type of the resource group.</p>

	</td>
</tr>
				</tbody></table></div>
			<div class="heading-wrapper" data-heading-level="h3"><a class="anchor-link docon docon-link" href="#resourcegroupproperties" aria-label="Section titled: ResourceGroupProperties"></a><h3 class="margin-bottom-none heading-anchor" id="resourcegroupproperties">Resource<wbr>Group<wbr>Properties</h3></div>
			<div class="metadata">Object</div>
			<p>The resource group properties.</p>

				<div class="buttons buttons-right margin-bottom-none margin-top-sm"><!----><button class="button button-clear button-sm display-flex gap-xxs"><span class="icon" aria-hidden="true"><span class="docon docon-expand color-primary"></span></span><span><!---->Expand table<!----></span></button><!----></div><div class="inner-focus"><table aria-labelledby="resourcegroupproperties" class="parameters definitions table table-sm margin-top-none margin-bottom-sm">
					<tbody><tr>
						    <th class="is-narrow has-text-subtle">Name</th>
							<th class="is-narrow has-text-subtle">Type</th>
						<th class="has-text-subtle">Description</th>
					</tr>
<tr>
	<td>
		provisioningState
	</td>
		<td>

			<p>
					string


			</p>
	
		</td>
	<td>
		<p>The provisioning state.</p>

	</td>
</tr>
				</tbody></table></div>


</section>
</div>
					
		<div id="ms--inline-notifications" class="margin-block-xs" data-bi-name="inline-notification"></div>
	 
		<div id="assertive-live-region" role="alert" aria-live="assertive" class="visually-hidden" aria-relevant="additions" aria-atomic="true"><div role="none">Reading mode disabled</div></div>
		<div id="polite-live-region" role="status" aria-live="polite" class="visually-hidden" aria-relevant="additions" aria-atomic="true"></div>
	
					
				</div>
				 
			</div>
			
		<div id="action-panel" role="region" aria-label="Action Panel" class="action-panel" tabindex="-1"></div>
	
		
				</main>
				<aside id="layout-body-aside" class="layout-body-aside  " data-bi-name="aside" aria-label="Additional resources">
					
		<div id="ms--additional-resources" class="right-container padding-sm display-none display-block-desktop height-full" data-bi-name="pageactions">
			<div id="affixed-right-container" data-bi-name="right-column" class="position-sticky" style="top: 8px; max-height: 5347px; height: calc(-124px + 100vh);">
				
		<nav id="side-doc-outline" class="doc-outline border-bottom padding-bottom-xs margin-bottom-xs scrollbar-width-thin" data-bi-name="intopic toc" aria-label="In this article" style="overflow: auto; max-height: calc(100% + 0px);"><!----><h2 class="title is-6 margin-top-xxs margin-bottom-xs"><!---->In this article<!----></h2><ol id="right-rail-in-this-article-list" class=""><!----><!----><li class="border-left-md padding-left-xxs border-color-primary"><a data-bi-name="h2-content-well" href="#uri-parameters" class="font-weight-semibold color-text" aria-current="true"><!---->URI Parameters<!----></a></li><!----><li class="border-left-md border-color-transparent padding-left-xxs "><a data-bi-name="h2-content-well" href="#request-body" class="color-text-subtle"><!---->Request Body<!----></a></li><!----><li class="border-left-md border-color-transparent padding-left-xxs "><a data-bi-name="h2-content-well" href="#response" class="color-text-subtle"><!---->Responses<!----></a></li><!----><li class="border-left-md border-color-transparent padding-left-xxs "><a data-bi-name="h2-content-well" href="#security" class="color-text-subtle"><!---->Security<!----></a></li><!----><li class="border-left-md border-color-transparent padding-left-xxs "><a data-bi-name="h2-content-well" href="#examples" class="color-text-subtle"><!---->Examples<!----></a></li><!----><li class="border-left-md border-color-transparent padding-left-xxs "><a data-bi-name="h2-content-well" href="#definitions" class="color-text-subtle"><!---->Definitions<!----></a></li><!----><!----></ol> <!----></nav>
	
				<!-- Feedback -->
				
			</div>
		</div>
	
			  </aside> <section id="layout-body-flyout" class="layout-body-flyout " data-bi-name="flyout">
					 <div class="height-full border-left background-color-body-medium" id="ask-learn-flyout"><!----><article class="chat-container  position-sticky top-0 " data-chat-container-name="ask-learn-flyout" data-test-id="chat-login-ask-learn-flyout"><div class="chat-container-header"><header class="display-flex justify-content-center align-items-center padding-xs"><h2 class="font-size-md padding-right-xxs"><!----><div class="font-weight-semibold"><span class="icon" aria-hidden="true"><span class="docon docon-chat-sparkle-fill gradient-ask-learn-logo"></span></span><span><!---->Ask Learn<!----></span></div><!----></h2><span class="badge badge-filled badge-sm"><!---->Preview<!----></span><div class="margin-left-auto display-flex flex-wrap-no-wrap align-items-stretch"><!----><button type="button" class="button button-clear inner-focus modal-close" data-flyout-button="close" data-autofocus="" data-bi-an="ask-learn-assistant" data-bi-name="close-chat" aria-label="Close"><span class="icon" aria-hidden="true"><span class="docon docon-navigate-close"></span></span></button><!----></div></header></div><div class="text-align-center padding-top-xl padding-inline-md"><p class="margin-bottom-lg"><!---->Ask Learn is an AI assistant that can answer questions, clarify concepts, and define terms using trusted Microsoft documentation.<!----></p><p class="margin-bottom-lg"><!---->Please sign in to use Ask Learn.<!----></p><a href="#" class="docs-sign-in button button-primary button-filled button-sm"><!---->Sign in<!----></a></div></article><!----></div>
			  </section> <div class="layout-body-footer " data-bi-name="layout-footer">
		<footer id="footer" data-test-id="footer" data-bi-name="footer" class="footer-layout padding-xs padding-sm-desktop has-default-focus border-top" role="contentinfo">
			<div class="display-flex gap-xs flex-wrap-wrap is-full-height padding-right-lg-desktop">
				
		<a data-mscc-ic="false" href="/en-us/locale?target=https%3A%2F%2Flearn.microsoft.com%2Fen-us%2Frest%2Fapi%2Fresources%2Fresource-groups%2Fcreate-or-update%3Fview%3Drest-resources-2021-04-01%26tabs%3DHTTP" data-bi-name="select-locale" class="locale-selector-link flex-shrink-0 button button-sm button-clear external-link-indicator" id="" title="" aria-label="Content language selector. Currently set to English (United States)."><span class="icon" aria-hidden="true"><span class="docon docon-world"></span></span><span class="local-selector-link-text">English (United States)</span></a>
	 <div class="ccpa-privacy-link" data-ccpa-privacy-link="">
		
		<a data-mscc-ic="false" href="https://aka.ms/yourcaliforniaprivacychoices" data-bi-name="your-privacy-choices" class="button button-sm button-clear flex-shrink-0 external-link-indicator" id="" title="">
		<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 30 14" xml:space="preserve" height="16" width="43" aria-hidden="true" focusable="false">
			<path d="M7.4 12.8h6.8l3.1-11.6H7.4C4.2 1.2 1.6 3.8 1.6 7s2.6 5.8 5.8 5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#fff"></path>
			<path d="M22.6 0H7.4c-3.9 0-7 3.1-7 7s3.1 7 7 7h15.2c3.9 0 7-3.1 7-7s-3.2-7-7-7zm-21 7c0-3.2 2.6-5.8 5.8-5.8h9.9l-3.1 11.6H7.4c-3.2 0-5.8-2.6-5.8-5.8z" style="fill-rule:evenodd;clip-rule:evenodd;fill:#06f"></path>
			<path d="M24.6 4c.2.2.2.6 0 .8L22.5 7l2.2 2.2c.2.2.2.6 0 .8-.2.2-.6.2-.8 0l-2.2-2.2-2.2 2.2c-.2.2-.6.2-.8 0-.2-.2-.2-.6 0-.8L20.8 7l-2.2-2.2c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0l2.2 2.2L23.8 4c.2-.2.6-.2.8 0z" style="fill:#fff"></path>
			<path d="M12.7 4.1c.2.2.3.6.1.8L8.6 9.8c-.1.1-.2.2-.3.2-.2.1-.5.1-.7-.1L5.4 7.7c-.2-.2-.2-.6 0-.8.2-.2.6-.2.8 0L8 8.6l3.8-4.5c.2-.2.6-.2.9 0z" style="fill:#06f"></path>
		</svg>
	
			<span>Your Privacy Choices</span></a>
	
	</div>
				<div class="flex-shrink-0">
		<div class="dropdown has-caret-up">
			<button data-test-id="theme-selector-button" class="dropdown-trigger button button-clear button-sm inner-focus theme-dropdown-trigger" aria-controls="{{ themeMenuId }}" aria-haspopup="true" aria-expanded="false" data-bi-name="theme">
				<span class="icon" aria-hidden="true"><span class="docon docon-sun"></span></span>
				<span>Theme</span>
				<span class="icon expanded-indicator" aria-hidden="true">
					<span class="docon docon-chevron-down-light"></span>
				</span>
			</button>
			<div class="dropdown-menu" id="{{ themeMenuId }}" role="menu">
				<ul class="theme-selector padding-xxs" data-test-id="theme-dropdown-menu" role="none">
					<li class="theme display-block" role="none">
						<button class="button button-clear button-sm theme-control button-block justify-content-flex-start text-align-left is-selected" role="menuitemradio" aria-checked="true" data-theme-to="light" tabindex="-1">
							<span class="theme-light margin-right-xxs">
								<span class="theme-selector-icon border display-inline-block has-body-background" aria-hidden="true">
									<svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14">
										<rect width="22" height="14" class="has-fill-body-background"></rect>
										<rect x="5" y="5" width="12" height="4" class="has-fill-secondary"></rect>
										<rect x="5" y="2" width="2" height="1" class="has-fill-secondary"></rect>
										<rect x="8" y="2" width="2" height="1" class="has-fill-secondary"></rect>
										<rect x="11" y="2" width="3" height="1" class="has-fill-secondary"></rect>
										<rect x="1" y="1" width="2" height="2" class="has-fill-secondary"></rect>
										<rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary"></rect>
										<rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary"></rect>
									</svg>
								</span>
							</span>
							<span> Light </span>
						</button>
					</li>
					<li class="theme display-block" role="none">
						<button class="button button-clear button-sm theme-control button-block justify-content-flex-start text-align-left" role="menuitemradio" aria-checked="false" data-theme-to="dark" tabindex="-1">
							<span class="theme-dark margin-right-xxs">
								<span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true">
									<svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14">
										<rect width="22" height="14" class="has-fill-body-background"></rect>
										<rect x="5" y="5" width="12" height="4" class="has-fill-secondary"></rect>
										<rect x="5" y="2" width="2" height="1" class="has-fill-secondary"></rect>
										<rect x="8" y="2" width="2" height="1" class="has-fill-secondary"></rect>
										<rect x="11" y="2" width="3" height="1" class="has-fill-secondary"></rect>
										<rect x="1" y="1" width="2" height="2" class="has-fill-secondary"></rect>
										<rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary"></rect>
										<rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary"></rect>
									</svg>
								</span>
							</span>
							<span> Dark </span>
						</button>
					</li>
					<li class="theme display-block" role="none">
						<button class="button button-clear button-sm theme-control button-block justify-content-flex-start text-align-left" role="menuitemradio" aria-checked="false" data-theme-to="high-contrast" tabindex="-1">
							<span class="theme-high-contrast margin-right-xxs">
								<span class="border theme-selector-icon display-inline-block has-body-background" aria-hidden="true">
									<svg class="svg" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 22 14">
										<rect width="22" height="14" class="has-fill-body-background"></rect>
										<rect x="5" y="5" width="12" height="4" class="has-fill-secondary"></rect>
										<rect x="5" y="2" width="2" height="1" class="has-fill-secondary"></rect>
										<rect x="8" y="2" width="2" height="1" class="has-fill-secondary"></rect>
										<rect x="11" y="2" width="3" height="1" class="has-fill-secondary"></rect>
										<rect x="1" y="1" width="2" height="2" class="has-fill-secondary"></rect>
										<rect x="5" y="10" width="7" height="2" rx="0.3" class="has-fill-primary"></rect>
										<rect x="19" y="1" width="2" height="2" rx="1" class="has-fill-secondary"></rect>
									</svg>
								</span>
							</span>
							<span> High contrast </span>
						</button>
					</li>
				</ul>
			</div>
		</div>
	</div>
			</div>
			<ul class="links" data-bi-name="footerlinks">
				<li class="manage-cookies-holder" hidden=""></li>
				<li>
		
		<a data-mscc-ic="false" href="https://learn.microsoft.com/en-us/principles-for-ai-generated-content" data-bi-name="aiDisclaimer" class=" external-link-indicator" id="" title="">AI Disclaimer</a>
	
	</li><li>
		
		<a data-mscc-ic="false" href="https://learn.microsoft.com/en-us/previous-versions/" data-bi-name="archivelink" class=" external-link-indicator" id="" title="">Previous Versions</a>
	
	</li> <li>
		
		<a data-mscc-ic="false" href="https://techcommunity.microsoft.com/t5/microsoft-learn-blog/bg-p/MicrosoftLearnBlog" data-bi-name="bloglink" class=" external-link-indicator" id="" title="">Blog</a>
	
	</li> <li>
		
		<a data-mscc-ic="false" href="https://learn.microsoft.com/en-us/contribute" data-bi-name="contributorGuide" class=" external-link-indicator" id="" title="">Contribute</a>
	
	</li><li>
		
		<a data-mscc-ic="false" href="https://go.microsoft.com/fwlink/?LinkId=521839" data-bi-name="privacy" class=" external-link-indicator" id="" title="">Privacy</a>
	
	</li><li>
		
		<a data-mscc-ic="false" href="https://go.microsoft.com/fwlink/?linkid=2259814" data-bi-name="consumer-health-privacy" class=" external-link-indicator" id="" title="">Consumer Health Privacy</a>
	
	</li><li>
		
		<a data-mscc-ic="false" href="https://learn.microsoft.com/en-us/legal/termsofuse" data-bi-name="termsofuse" class=" external-link-indicator" id="" title="">Terms of Use</a>
	
	</li><li>
		
		<a data-mscc-ic="false" href="https://www.microsoft.com/legal/intellectualproperty/Trademarks/" data-bi-name="trademarks" class=" external-link-indicator" id="" title="">Trademarks</a>
	
	</li>
				<li>© Microsoft 2026</li>
			</ul>
		</footer>
	
			
		</div></body></html>