Management Groups - Delete

  • Referenz
Service:
Management Groups
API Version:
2020-05-01

Löscht eine Verwaltungsgruppe. Wenn eine Verwaltungsgruppe untergeordnete Ressourcen enthält, schlägt die Anforderung fehl.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
groupId
 path True

string

Verwaltungsgruppen-ID.
api-version
 query True

string

Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2018-01-01-preview.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Cache-Control

string

Gibt an, dass die Anforderung keine Caches verwenden soll.

Antworten

Name Typ Beschreibung
202 Accepted

AzureAsyncOperationResults

Akzeptiert

Headers

  • Location: string
  • Azure-AsyncOperation: string
204 No Content

Kein Inhalt
Other Status Codes

ErrorResponse

Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

DeleteManagementGroup

Sample Request

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

Definitionen

Name Beschreibung
AzureAsyncOperationResults

Die Ergebnisse von Azure-AsyncOperation.
ErrorDetails

Die Details des Fehlers.
ErrorResponse

Das Fehlerobjekt.

AzureAsyncOperationResults

Die Ergebnisse von Azure-AsyncOperation.

Name Typ Beschreibung
id

string

Die vollqualifizierte ID für die Verwaltungsgruppe. Beispiel: /providers/Microsoft.Management/managementGroups/000000000-0000-0000-00000-0000000000000
name

string

Der Name der Verwaltungsgruppe. Beispiel: 000000000-0000-0000-00000-0000000000
properties.displayName

string

Der Anzeigename der Verwaltungsgruppe.
properties.tenantId

string

Die der Verwaltungsgruppe zugeordnete AAD-Mandanten-ID. Beispiel: 000000000-0000-0000-00000-0000000000
status

string

Der aktuelle status des ausgeführten asynchronen Vorgangs. Beispiel: Ausführen, Erfolgreich, Fehler
type

string

Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups

ErrorDetails

Die Details des Fehlers.

Name Typ Beschreibung
code

string

Einer der vom Server definierten Fehlercodes.
details

string

Eine für Menschen lesbare Darstellung der Fehlerdetails.
message

string

Eine für Menschen lesbare Darstellung des Fehlers.

ErrorResponse

Das Fehlerobjekt.

Name Typ Beschreibung
error

ErrorDetails

Fehler
Die Details des Fehlers.