Management Groups - Create Or Update

Reference

Service:: Management Groups

API Version:: 2020-05-01

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
groupId	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	CreateManagementGroupDetails	Podrobnosti Podrobnosti o skupině pro správu použité při vytváření.
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	ManagementGroup	OK
202 Accepted	AzureAsyncOperationResults	Přijato Headers Location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Chyba

Name

Typ

Description

200 OK

ManagementGroup

202 Accepted

AzureAsyncOperationResults

Přijato

Headers

Location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

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

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"
}

Definice

Name	Description
AzureAsyncOperationResults	Výsledky Azure-AsyncOperation.
CreateManagementGroupChildInfo	Podřízené informace skupiny pro správu použité při vytváření.
CreateManagementGroupDetails	Podrobnosti o skupině pro správu použité při vytváření.
CreateManagementGroupRequest	Parametry vytváření skupin pro správu
CreateParentGroupInfo	(Volitelné) ID nadřazené skupiny pro správu použité při vytváření.
ErrorDetails	Podrobnosti o chybě.
ErrorResponse	Objekt chyby.
ManagementGroup	Podrobnosti o skupině pro správu
ManagementGroupChildInfo	Podřízené informace skupiny pro správu.
ManagementGroupChildType	Typ podřízeného prostředku.
ManagementGroupDetails	Podrobnosti o skupině pro správu.
ManagementGroupPathElement	Element cesty nadřazených skupin pro správu.
ParentGroupInfo	(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	CreateManagementGroupChildInfo[]	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	ManagementGroupChildType	Typ podřízeného prostředku. Plně kvalifikovaný typ prostředku, který zahrnuje obor názvů poskytovatele (např. Microsoft.Management/managementGroups)

CreateManagementGroupDetails

Podrobnosti o skupině pro správu použité při vytváření.

Name	Typ	Description
parent	CreateParentGroupInfo	Parent (Volitelné) ID nadřazené skupiny pro správu použité při vytváření.
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	CreateManagementGroupChildInfo[]	Seznam podřízených položek.
properties.details	CreateManagementGroupDetails	Podrobnosti Podrobnosti o skupině pro správu použité při vytváření.
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	ErrorDetails	Chyba Podrobnosti o chybě.