Management Groups - Create Or Update
Skapa eller uppdatera en hanteringsgrupp. Om en hanteringsgrupp redan har skapats och en efterföljande skapandebegäran utfärdas med olika egenskaper, uppdateras egenskaperna för hanteringsgruppen.
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}?api-version=2020-05-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
group
|
path | True |
string |
Grupp-ID för hantering. |
api-version
|
query | True |
string |
Version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2018-01-01-preview. |
Begärandehuvud
Name | Obligatorisk | Typ | Description |
---|---|---|---|
Cache-Control |
string |
Anger att begäran inte ska använda några cacheminnen. |
Begärandetext
Name | Typ | Description |
---|---|---|
name |
string |
Namnet på hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
properties.details |
Information |
|
properties.displayName |
string |
Hanteringsgruppens eget namn. Om inget värde skickas anges det här fältet till groupId. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Har godkänts Headers
|
|
Other Status Codes |
Fel |
Säkerhet
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 | personifiera ditt användarkonto |
Exempel
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"
}
Definitioner
Name | Description |
---|---|
Azure |
Resultatet av Azure-AsyncOperation. |
Create |
Den underordnade informationen för en hanteringsgrupp som används när den skapades. |
Create |
Information om en hanteringsgrupp som används när du skapar. |
Create |
Parametrar för att skapa hanteringsgrupp. |
Create |
(Valfritt) ID:t för den överordnade hanteringsgruppen som användes när den skapades. |
Error |
Information om felet. |
Error |
Felobjektet. |
Management |
Information om hanteringsgruppen. |
Management |
Underordnad information om en hanteringsgrupp. |
Management |
Typ av underordnad resurs. |
Management |
Information om en hanteringsgrupp. |
Management |
Ett sökvägselement i en överordnad hanteringsgrupp. |
Parent |
(Valfritt) ID för den överordnade hanteringsgruppen. |
AzureAsyncOperationResults
Resultatet av Azure-AsyncOperation.
Name | Typ | Description |
---|---|---|
id |
string |
Det fullständigt kvalificerade ID:t för hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
properties.displayName |
string |
Hanteringsgruppens eget namn. |
properties.tenantId |
string |
Det AAD-klientorganisations-ID som är associerat med hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
status |
string |
Den aktuella statusen för den asynkrona åtgärden utförde . Till exempel Körs, Lyckades, Misslyckades |
type |
string |
Resurstypen. Till exempel Microsoft.Management/managementGroups |
CreateManagementGroupChildInfo
Den underordnade informationen för en hanteringsgrupp som används när den skapades.
Name | Typ | Description |
---|---|---|
children |
Listan över underordnade. |
|
displayName |
string |
Det egna namnet på den underordnade resursen. |
id |
string |
Det fullständigt kvalificerade ID:t för den underordnade resursen (hanteringsgrupp eller prenumeration). Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på den underordnade entiteten. |
type |
Typ av underordnad resurs. |
CreateManagementGroupDetails
Information om en hanteringsgrupp som används när du skapar.
Name | Typ | Description |
---|---|---|
parent |
Överordnad |
|
updatedBy |
string |
Identiteten för huvudkontot eller processen som uppdaterade objektet. |
updatedTime |
string |
Datum och tid då objektet senast uppdaterades. |
version |
number |
Versionsnumret för objektet. |
CreateManagementGroupRequest
Parametrar för att skapa hanteringsgrupp.
Name | Typ | Description |
---|---|---|
id |
string |
Det fullständigt kvalificerade ID:t för hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
properties.children |
Listan över underordnade. |
|
properties.details |
Information |
|
properties.displayName |
string |
Hanteringsgruppens eget namn. Om inget värde skickas anges det här fältet till groupId. |
properties.tenantId |
string |
Det AAD-klientorganisations-ID som är associerat med hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
type |
string |
Resurstypen. Till exempel Microsoft.Management/managementGroups |
CreateParentGroupInfo
(Valfritt) ID:t för den överordnade hanteringsgruppen som användes när den skapades.
Name | Typ | Description |
---|---|---|
displayName |
string |
Det egna namnet på den överordnade hanteringsgruppen. |
id |
string |
Det fullständigt kvalificerade ID:t för den överordnade hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på den överordnade hanteringsgruppen |
ErrorDetails
Information om felet.
Name | Typ | Description |
---|---|---|
code |
string |
En av en serverdefinierad uppsättning felkoder. |
details |
string |
En läsbar representation av felets detaljer. |
message |
string |
En mänsklig läsbar representation av felet. |
ErrorResponse
Felobjektet.
Name | Typ | Description |
---|---|---|
error |
Fel |
ManagementGroup
Information om hanteringsgruppen.
Name | Typ | Description |
---|---|---|
id |
string |
Det fullständigt kvalificerade ID:t för hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
properties.children |
Listan över underordnade. |
|
properties.details |
Information |
|
properties.displayName |
string |
Hanteringsgruppens eget namn. |
properties.tenantId |
string |
Det AAD-klientorganisations-ID som är associerat med hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000 |
type |
string |
Resurstypen. Till exempel Microsoft.Management/managementGroups |
ManagementGroupChildInfo
Underordnad information om en hanteringsgrupp.
Name | Typ | Description |
---|---|---|
children |
Listan över underordnade. |
|
displayName |
string |
Det egna namnet på den underordnade resursen. |
id |
string |
Det fullständigt kvalificerade ID:t för den underordnade resursen (hanteringsgrupp eller prenumeration). Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på den underordnade entiteten. |
type |
Typ av underordnad resurs. |
ManagementGroupChildType
Typ av underordnad resurs.
Name | Typ | Description |
---|---|---|
/subscriptions |
string |
|
Microsoft.Management/managementGroups |
string |
ManagementGroupDetails
Information om en hanteringsgrupp.
Name | Typ | Description |
---|---|---|
parent |
Överordnad |
|
path |
Sökvägen från roten till den aktuella gruppen. |
|
updatedBy |
string |
Identiteten för huvudkontot eller processen som uppdaterade objektet. |
updatedTime |
string |
Datum och tid då objektet senast uppdaterades. |
version |
number |
Versionsnumret för objektet. |
ManagementGroupPathElement
Ett sökvägselement i en överordnad hanteringsgrupp.
Name | Typ | Description |
---|---|---|
displayName |
string |
Det egna namnet på gruppen. |
name |
string |
Namnet på gruppen. |
ParentGroupInfo
(Valfritt) ID för den överordnade hanteringsgruppen.
Name | Typ | Description |
---|---|---|
displayName |
string |
Det egna namnet på den överordnade hanteringsgruppen. |
id |
string |
Det fullständigt kvalificerade ID:t för den överordnade hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000 |
name |
string |
Namnet på den överordnade hanteringsgruppen |