Management Groups - Delete

Service:

Management Groups

API Version:

2020-05-01

Delete management group. If a management group contains child resources, the request will fail.

DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}?api-version=2020-05-01

URI Parameters

Name	In	Required	Type	Description
groupId	path	True	string	Management Group ID.
api-version	query	True	string	Version of the API to be used with the client request. The current version is 2018-01-01-preview.

Request Header

Name	Required	Type	Description
Cache-Control		string	Indicates that the request shouldn't utilize any caches.

Responses

Name	Type	Description
202 Accepted	AzureAsyncOperationResults	Accepted Headers Location: string Azure-AsyncOperation: string
204 No Content		NoContent
Other Status Codes	ErrorResponse	Error

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

DeleteManagementGroup

Sample Request

HTTP

DELETE https://management.azure.com/providers/Microsoft.Management/managementGroups/GroupToDelete?api-version=2020-05-01

Sample Response

Status code:

202

azure-asyncoperation: https://management.azure.com/providers/Microsoft.Management/operationResults/delete/asyncOperation/status/managementGroups/GroupToDelete?api-version=2020-05-01

Response Body

{
  "id": "/providers/Microsoft.Management/managementGroups/GroupToDelete",
  "type": "Microsoft.Management/managementGroups",
  "name": "GroupToDelete",
  "status": "NotStarted"
}

Status code:

204

Definitions

Name	Description
AzureAsyncOperationResults	The results of Azure-AsyncOperation.
ErrorDetails	The details of the error.
ErrorResponse	The error object.

AzureAsyncOperationResults

The results of Azure-AsyncOperation.

Name	Type	Description
id	string	The fully qualified ID for the management group. For example, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	The name of the management group. For example, 00000000-0000-0000-0000-000000000000
properties.displayName	string	The friendly name of the management group.
properties.tenantId	string	The AAD Tenant ID associated with the management group. For example, 00000000-0000-0000-0000-000000000000
status	string	The current status of the asynchronous operation performed . For example, Running, Succeeded, Failed
type	string	The type of the resource. For example, Microsoft.Management/managementGroups

ErrorDetails

The details of the error.

Name	Type	Description
code	string	One of a server-defined set of error codes.
details	string	A human-readable representation of the error's details.
message	string	A human-readable representation of the error.

ErrorResponse

The error object.

Name	Type	Description
error	ErrorDetails	Error The details of the error.