Sdílet prostřednictvím


Management Groups - Get Descendants

Zobrazí seznam všech entit, které pocházejí ze skupiny pro správu.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/descendants?api-version=2020-05-01
GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/descendants?api-version=2020-05-01&$skiptoken={$skiptoken}&$top={$top}

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.

$skiptoken
query

string

Token pokračování stránky se používá pouze v případě, že předchozí operace vrátila částečný výsledek. Pokud předchozí odpověď obsahuje prvek nextLink, hodnota elementu nextLink bude obsahovat parametr tokenu, který určuje počáteční bod, který se má použít pro následná volání.

$top
query

integer

Počet prvků, které se mají vrátit při načítání výsledků Předáním této funkce přepíšete $skipToken.

Odpovědi

Name Typ Description
200 OK

DescendantListResult

OK

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

GetDescendants

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000/descendants?api-version=2020-05-01

Sample Response

{
  "value": [
    {
      "id": "/providers/Microsoft.Management/managementGroups/20000000-0001-0000-0000-000000000000",
      "type": "Microsoft.Management/managementGroups",
      "name": "20000000-0001-0000-0000-000000000000",
      "properties": {
        "displayName": "Group 1",
        "parent": {
          "id": "/providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000"
        }
      }
    },
    {
      "id": "/subscriptions/20000000-0004-0000-0000-000000000000",
      "type": "Microsoft.Management/managementGroups/subscriptions",
      "name": "20000000-0004-0000-0000-000000000000",
      "properties": {
        "displayName": "Subscription 4",
        "parent": {
          "id": "/providers/Microsoft.Management/managementGroups/20000000-0000-0000-0000-000000000000"
        }
      }
    }
  ],
  "nextLink": null
}

Definice

Name Description
DescendantInfo

Potomek.

DescendantListResult

Popisuje výsledek požadavku na zobrazení potomků.

DescendantParentGroupInfo

ID nadřazené skupiny pro správu.

ErrorDetails

Podrobnosti o chybě.

ErrorResponse

Objekt chyby.

DescendantInfo

Potomek.

Name Typ Description
id

string

Plně kvalifikované ID potomka. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000 nebo /subscriptions/0000000-00000-0000-0000-0000000000000000000

name

string

Jméno potomka. Například 00000000-0000-0000-0000-000000000000000000

properties.displayName

string

Popisný název skupiny pro správu.

properties.parent

DescendantParentGroupInfo

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

type

string

Typ prostředku. Například Microsoft.Management/managementGroups nebo /subscriptions

DescendantListResult

Popisuje výsledek požadavku na zobrazení potomků.

Name Typ Description
nextLink

string

Adresa URL, která se má použít pro získání další sady výsledků.

value

DescendantInfo[]

Seznam potomků.

DescendantParentGroupInfo

ID nadřazené skupiny pro správu.

Name Typ Description
id

string

Plně kvalifikované ID nadřazené skupiny pro správu. Například /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000000

ErrorDetails

Podrobnosti o chybě.

Name Typ Description
code

string

Jeden ze serverem definované sady kódů chyb.

details

string

Lidsky čitelná reprezentace podrobností o chybě.

message

string

Lidsky čitelná reprezentace chyby.

ErrorResponse

Objekt chyby.

Name Typ Description
error

ErrorDetails

Chyba
Podrobnosti o chybě.