Management Groups - Create Or Update
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 |
---|---|---|---|---|
group
|
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 |
Details |
|
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 |
OK |
|
202 Accepted |
Akzeptiert Headers
|
|
Other Status Codes |
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
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
{
"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"
}
}
}
}
{
"id": "/providers/Microsoft.Management/managementGroups/ChildGroup",
"type": "Microsoft.Management/managementGroups",
"name": "ChildGroup",
"status": "NotStarted"
}
Definitionen
Name | Beschreibung |
---|---|
Azure |
Die Ergebnisse von Azure-AsyncOperation. |
Create |
Die untergeordneten Informationen einer Verwaltungsgruppe, die während der Erstellung verwendet wird. |
Create |
Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird. |
Create |
Verwaltungsgruppenerstellungsparameter. |
Create |
(Optional) Die ID der übergeordneten Verwaltungsgruppe, die bei der Erstellung verwendet wird. |
Error |
Die Details des Fehlers. |
Error |
Das Fehlerobjekt. |
Management |
Die Verwaltungsgruppendetails. |
Management |
Die untergeordneten Informationen einer Verwaltungsgruppe. |
Management |
Der Typ der untergeordneten Ressource. |
Management |
Die Details einer Verwaltungsgruppe. |
Management |
Ein Pfadelement einer Verwaltungsgruppen-Vorgängergruppe. |
Parent |
(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 |
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 |
Der Typ der untergeordneten Ressource. |
CreateManagementGroupDetails
Die Details einer Verwaltungsgruppe, die während der Erstellung verwendet wird.
Name | Typ | Beschreibung |
---|---|---|
parent |
Parent |
|
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 |
Die Liste der untergeordneten Elemente. |
|
properties.details |
Details |
|
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 |
Fehler |
ManagementGroup
Die Verwaltungsgruppendetails.
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 |
Die Liste der untergeordneten Elemente. |
|
properties.details |
Details |
|
properties.displayName |
string |
Der Anzeigename der Verwaltungsgruppe. |
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 |
ManagementGroupChildInfo
Die untergeordneten Informationen einer Verwaltungsgruppe.
Name | Typ | Beschreibung |
---|---|---|
children |
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 |
Der Typ der untergeordneten Ressource. |
ManagementGroupChildType
Der Typ der untergeordneten Ressource.
Name | Typ | Beschreibung |
---|---|---|
/subscriptions |
string |
|
Microsoft.Management/managementGroups |
string |
ManagementGroupDetails
Die Details einer Verwaltungsgruppe.
Name | Typ | Beschreibung |
---|---|---|
parent |
Parent |
|
path |
Der Pfad vom Stamm zur aktuellen Gruppe. |
|
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. |
ManagementGroupPathElement
Ein Pfadelement einer Verwaltungsgruppen-Vorgängergruppe.
Name | Typ | Beschreibung |
---|---|---|
displayName |
string |
Der Anzeigename der Gruppe. |
name |
string |
Der Name der Gruppe. |
ParentGroupInfo
(Optional) Die ID der übergeordneten Verwaltungsgruppe.
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 |