Management Groups - Create Or Update

Referenz

Service:: Management Groups

API Version:: 2020-05-01

Erstellt oder aktualisiert eine Verwaltungsgruppe. Wenn bereits eine Verwaltungsgruppe erstellt wurde und eine nachfolgende Erstellungsanforderung mit unterschiedlichen Eigenschaften ausgegeben wird, werden die Verwaltungsgruppeneigenschaften aktualisiert.

PUT 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.

Anforderungstext

Name	Typ	Beschreibung
name	string	Der Name der Verwaltungsgruppe. Beispiel: 000000000-0000-0000-00000-0000000000
properties.details	CreateManagementGroupDetails	Details Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird.
properties.displayName	string	Der Anzeigename der Verwaltungsgruppe. Wenn kein Wert übergeben wird, wird dieses Feld auf die groupId festgelegt.

Antworten

Name	Typ	Beschreibung
200 OK	ManagementGroup	OK
202 Accepted	AzureAsyncOperationResults	Akzeptiert Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Fehler

Name

Typ

Beschreibung

200 OK

ManagementGroup

202 Accepted

AzureAsyncOperationResults

Akzeptiert

Headers

Location: string
Azure-AsyncOperation: string

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

PutManagementGroup

Sample Request

HTTP

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


{
  "properties": {
    "displayName": "ChildGroup",
    "details": {
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup"
      }
    }
  }
}

Sample Response

Status code:: 200

{
  "id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
  "type": "Microsoft.Management/managementGroups",
  "name": "ChildGroup",
  "properties": {
    "tenantId": "20000000-0000-0000-0000-000000000000",
    "displayName": "ChildGroup",
    "details": {
      "version": 1,
      "updatedTime": "2018-01-01T00:00:00.00Z",
      "updatedBy": "16b8ef21-5c9f-420c-bcc9-e4f8c9f30b4b",
      "parent": {
        "id": "/providers/Microsoft.Management/managementGroups/RootGroup",
        "name": "RootGroup",
        "displayName": "RootGroup"
      }
    }
  }
}

Status code:: 202

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

Definitionen

Name	Beschreibung
AzureAsyncOperationResults	Die Ergebnisse von Azure-AsyncOperation.
CreateManagementGroupChildInfo	Die untergeordneten Informationen einer Verwaltungsgruppe, die während der Erstellung verwendet wird.
CreateManagementGroupDetails	Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird.
CreateManagementGroupRequest	Verwaltungsgruppenerstellungsparameter.
CreateParentGroupInfo	(Optional) Die ID der übergeordneten Verwaltungsgruppe, die bei der Erstellung verwendet wird.
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Das Fehlerobjekt.
ManagementGroup	Die Verwaltungsgruppendetails.
ManagementGroupChildInfo	Die untergeordneten Informationen einer Verwaltungsgruppe.
ManagementGroupChildType	Der Typ der untergeordneten Ressource.
ManagementGroupDetails	Die Details einer Verwaltungsgruppe.
ManagementGroupPathElement	Ein Pfadelement einer Verwaltungsgruppen-Vorgängergruppe.
ParentGroupInfo	(Optional) Die ID der übergeordneten Verwaltungsgruppe.

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

CreateManagementGroupChildInfo

Die untergeordneten Informationen einer Verwaltungsgruppe, die während der Erstellung verwendet wird.

Name	Typ	Beschreibung
children	CreateManagementGroupChildInfo[]	Die Liste der untergeordneten Elemente.
displayName	string	Der Anzeigename der untergeordneten Ressource.
id	string	Die vollqualifizierte ID für die untergeordnete Ressource (Verwaltungsgruppe oder Abonnement). Beispiel: /providers/Microsoft.Management/managementGroups/000000000-0000-0000-00000-0000000000000
name	string	Der Name der untergeordneten Entität.
type	ManagementGroupChildType	Der Typ der untergeordneten Ressource. Der vollqualifizierte Ressourcentyp, der Anbieternamespace enthält (z. B. Microsoft.Management/managementGroups)

CreateManagementGroupDetails

Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird.

Name	Typ	Beschreibung
parent	CreateParentGroupInfo	Parent (Optional) Die ID der übergeordneten Verwaltungsgruppe, die bei der Erstellung verwendet wird.
updatedBy	string	Die Identität des Prinzipals oder Prozesses, der das Objekt aktualisiert hat.
updatedTime	string	Das Datum und die Uhrzeit der letzten Aktualisierung dieses Objekts.
version	number	Die Versionsnummer des Objekts.

CreateManagementGroupRequest

Verwaltungsgruppenerstellungsparameter.

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.children	CreateManagementGroupChildInfo[]	Die Liste der untergeordneten Elemente.
properties.details	CreateManagementGroupDetails	Details Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird.
properties.displayName	string	Der Anzeigename der Verwaltungsgruppe. Wenn kein Wert übergeben wird, wird dieses Feld auf die groupId festgelegt.
properties.tenantId	string	Die der Verwaltungsgruppe zugeordnete AAD-Mandanten-ID. Beispiel: 000000000-0000-0000-00000-0000000000
type	string	Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups

CreateParentGroupInfo

(Optional) Die ID der übergeordneten Verwaltungsgruppe, die bei der Erstellung verwendet wird.

Name	Typ	Beschreibung
displayName	string	Der Anzeigename der übergeordneten Verwaltungsgruppe.
id	string	Die vollqualifizierte ID für die übergeordnete Verwaltungsgruppe. Beispiel: /providers/Microsoft.Management/managementGroups/000000000-0000-0000-00000-0000000000000
name	string	Der Name der übergeordneten Verwaltungsgruppe

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.