Management Groups - Delete

Service:

Management Groups

API Version:

2020-05-01

Elimina un grupo de administración. Si un grupo de administración contiene recursos secundarios, se producirá un error en la solicitud.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
groupId	path	True	string	Id. de grupo de administración.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2018-01-01-preview.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Cache-Control		string	Indica que la solicitud no debe usar ninguna memoria caché.

Respuestas

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

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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

Definiciones

Nombre	Description
AzureAsyncOperationResults	Los resultados de Azure-AsyncOperation.
ErrorDetails	Detalles del error.
ErrorResponse	Objeto de error.

AzureAsyncOperationResults

Los resultados de Azure-AsyncOperation.

Nombre	Tipo	Description
id	string	Identificador completo del grupo de administración. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nombre del grupo de administración. Por ejemplo, 00000000-0000-0000-0000-0000000000000
properties.displayName	string	Nombre descriptivo del grupo de administración.
properties.tenantId	string	Identificador de inquilino de AAD asociado al grupo de administración. Por ejemplo, 00000000-0000-0000-0000-0000000000000
status	string	Estado actual de la operación asincrónica realizada. Por ejemplo, Running, Succeeded, Failed
type	string	Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	string	Representación legible de los detalles del error.
message	string	Representación legible del error.

ErrorResponse

Objeto de error.

Nombre	Tipo	Description
error	ErrorDetails	Error Detalles del error.