Management Groups - Create Or Update
Vytvořte nebo aktualizujte skupinu pro správu. Pokud už je skupina pro správu vytvořená a následná žádost o vytvoření se vydá s různými vlastnostmi, vlastnosti skupiny pro správu se aktualizují.
PUT https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}?api-version=2020-05-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
group
|
path | True |
string |
ID skupiny pro správu. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít s požadavkem klienta. Aktuální verze je 2018-01-01-preview. |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
Cache-Control |
string |
Označuje, že požadavek by neměl využívat žádné mezipaměti. |
Text požadavku
Name | Typ | Description |
---|---|---|
name |
string |
Název skupiny pro správu. Například 000000000-0000-0000-0000-0000000000000 |
properties.details |
Podrobnosti |
|
properties.displayName |
string |
Popisný název skupiny pro správu Pokud se nepředá žádná hodnota, bude toto pole nastaveno na groupId. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Přijato Headers
|
|
Other Status Codes |
Chyba |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
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"
}
Definice
Name | Description |
---|---|
Azure |
Výsledky Azure-AsyncOperation. |
Create |
Podřízené informace skupiny pro správu použité při vytváření. |
Create |
Podrobnosti o skupině pro správu použité při vytváření. |
Create |
Parametry vytváření skupin pro správu |
Create |
(Volitelné) ID nadřazené skupiny pro správu použité při vytváření. |
Error |
Podrobnosti o chybě. |
Error |
Objekt chyby. |
Management |
Podrobnosti o skupině pro správu |
Management |
Podřízené informace skupiny pro správu. |
Management |
Typ podřízeného prostředku. |
Management |
Podrobnosti o skupině pro správu. |
Management |
Element cesty nadřazených skupin pro správu. |
Parent |
(Volitelné) ID nadřazené skupiny pro správu. |
AzureAsyncOperationResults
Výsledky Azure-AsyncOperation.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID skupiny pro správu. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název skupiny pro správu. Například 000000000-0000-0000-0000-0000000000000 |
properties.displayName |
string |
Popisný název skupiny pro správu |
properties.tenantId |
string |
ID tenanta AAD přidružené ke skupině pro správu. Například 000000000-0000-0000-0000-0000000000000 |
status |
string |
Aktuální stav asynchronní operace provedla . Například Spuštěno, Úspěšné, Neúspěšné |
type |
string |
Typ prostředku. Například Microsoft.Management/managementGroups |
CreateManagementGroupChildInfo
Podřízené informace skupiny pro správu použité při vytváření.
Name | Typ | Description |
---|---|---|
children |
Seznam podřízených položek. |
|
displayName |
string |
Popisný název podřízeného prostředku. |
id |
string |
Plně kvalifikované ID podřízeného prostředku (skupiny pro správu nebo předplatné). Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název podřízené entity. |
type |
Typ podřízeného prostředku. |
CreateManagementGroupDetails
Podrobnosti o skupině pro správu použité při vytváření.
Name | Typ | Description |
---|---|---|
parent |
Parent |
|
updatedBy |
string |
Identita objektu zabezpečení nebo procesu, který objekt aktualizoval. |
updatedTime |
string |
Datum a čas poslední aktualizace tohoto objektu. |
version |
number |
Číslo verze objektu. |
CreateManagementGroupRequest
Parametry vytváření skupin pro správu
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID skupiny pro správu. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název skupiny pro správu. Například 000000000-0000-0000-0000-0000000000000 |
properties.children |
Seznam podřízených položek. |
|
properties.details |
Podrobnosti |
|
properties.displayName |
string |
Popisný název skupiny pro správu Pokud se nepředá žádná hodnota, bude toto pole nastaveno na groupId. |
properties.tenantId |
string |
ID tenanta AAD přidružené ke skupině pro správu. Například 000000000-0000-0000-0000-0000000000000 |
type |
string |
Typ prostředku. Například Microsoft.Management/managementGroups |
CreateParentGroupInfo
(Volitelné) ID nadřazené skupiny pro správu použité při vytváření.
Name | Typ | Description |
---|---|---|
displayName |
string |
Popisný název nadřazené skupiny pro správu. |
id |
string |
Plně kvalifikované ID nadřazené skupiny pro správu. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název nadřazené skupiny pro správu |
ErrorDetails
Podrobnosti o chybě.
Name | Typ | Description |
---|---|---|
code |
string |
Jeden ze serverem definovaných chybových kódů. |
details |
string |
Pro člověka čitelná reprezentace podrobností chyby. |
message |
string |
Lidsky čitelná reprezentace chyby. |
ErrorResponse
Objekt chyby.
Name | Typ | Description |
---|---|---|
error |
Chyba |
ManagementGroup
Podrobnosti o skupině pro správu
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID skupiny pro správu. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název skupiny pro správu. Například 000000000-0000-0000-0000-0000000000000 |
properties.children |
Seznam podřízených položek. |
|
properties.details |
Podrobnosti |
|
properties.displayName |
string |
Popisný název skupiny pro správu |
properties.tenantId |
string |
ID tenanta AAD přidružené ke skupině pro správu. Například 000000000-0000-0000-0000-0000000000000 |
type |
string |
Typ prostředku. Například Microsoft.Management/managementGroups |
ManagementGroupChildInfo
Podřízené informace skupiny pro správu.
Name | Typ | Description |
---|---|---|
children |
Seznam podřízených položek. |
|
displayName |
string |
Popisný název podřízeného prostředku. |
id |
string |
Plně kvalifikované ID podřízeného prostředku (skupiny pro správu nebo předplatné). Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název podřízené entity. |
type |
Typ podřízeného prostředku. |
ManagementGroupChildType
Typ podřízeného prostředku.
Name | Typ | Description |
---|---|---|
/subscriptions |
string |
|
Microsoft.Management/managementGroups |
string |
ManagementGroupDetails
Podrobnosti o skupině pro správu.
Name | Typ | Description |
---|---|---|
parent |
Parent |
|
path |
Cesta z kořenového adresáře do aktuální skupiny. |
|
updatedBy |
string |
Identita objektu zabezpečení nebo procesu, který objekt aktualizoval. |
updatedTime |
string |
Datum a čas poslední aktualizace tohoto objektu. |
version |
number |
Číslo verze objektu. |
ManagementGroupPathElement
Element cesty nadřazených skupin pro správu.
Name | Typ | Description |
---|---|---|
displayName |
string |
Popisný název skupiny |
name |
string |
Název skupiny. |
ParentGroupInfo
(Volitelné) ID nadřazené skupiny pro správu.
Name | Typ | Description |
---|---|---|
displayName |
string |
Popisný název nadřazené skupiny pro správu. |
id |
string |
Plně kvalifikované ID nadřazené skupiny pro správu. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000 |
name |
string |
Název nadřazené skupiny pro správu |