Sdílet prostřednictvím


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

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

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

ManagementGroupChildInfo[]

Seznam podřízených položek.

properties.details

ManagementGroupDetails

Podrobnosti
Podrobnosti o skupině pro správu.

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

ManagementGroupChildInfo[]

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)

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

ParentGroupInfo

Parent
(Volitelné) ID nadřazené skupiny pro správu.

path

ManagementGroupPathElement[]

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