Management Groups - Get Descendants

Odwołanie

Service:: Management Groups

API Version:: 2020-05-01

Wyświetl listę wszystkich jednostek, które pochodzą z grupy zarządzania.

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

With optional parameters:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
groupId	path	True	string	Identyfikator grupy zarządzania.
api-version	query	True	string	Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2018-01-01-preview.
$skiptoken	query		string	Token kontynuacji strony jest używany tylko wtedy, gdy poprzednia operacja zwróciła częściowy wynik. Jeśli poprzednia odpowiedź zawiera element nextLink, wartość elementu nextLink będzie zawierać parametr tokenu, który określa punkt wyjścia do użycia dla kolejnych wywołań.
$top	query		integer	Liczba elementów, które mają być zwracane podczas pobierania wyników. Przekazanie tego elementu spowoduje zastąpienie $skipToken.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DescendantListResult	OK
Other Status Codes	ErrorResponse	Błąd

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

GetDescendants

Sample Request

HTTP

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

Sample Response

Status code:: 200

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

Definicje

Nazwa	Opis
DescendantInfo	Element potomny.
DescendantListResult	Opisuje wynik żądania wyświetlania elementów potomnych.
DescendantParentGroupInfo	Identyfikator nadrzędnej grupy zarządzania.
ErrorDetails	Szczegóły błędu.
ErrorResponse	Obiekt błędu.

DescendantInfo

Element potomny.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator elementu podrzędnego. Na przykład /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000 lub /subscriptions/000000-0000-0000-0000-0000-0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000-00000-0000-0000-0000-0000-0000-00000-00000/000000/000000/00000/000
name	string	Nazwa elementu potomnego. Na przykład 000000000-0000-0000-0000-00000000000000000
properties.displayName	string	Przyjazna nazwa grupy zarządzania.
properties.parent	DescendantParentGroupInfo	Parent Identyfikator nadrzędnej grupy zarządzania.
type	string	Typ zasobu. Na przykład Microsoft.Management/managementGroups lub /subscriptions

DescendantListResult

Opisuje wynik żądania wyświetlania elementów potomnych.

Nazwa	Typ	Opis
nextLink	string	Adres URL używany do pobierania następnego zestawu wyników.
value	DescendantInfo[]	Lista elementów potomnych.

DescendantParentGroupInfo

Identyfikator nadrzędnej grupy zarządzania.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator nadrzędnej grupy zarządzania. Na przykład /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
details	string	Czytelna dla człowieka reprezentacja szczegółów błędu.
message	string	Czytelna dla człowieka reprezentacja błędu.

ErrorResponse

Obiekt błędu.

Nazwa	Typ	Opis
error	ErrorDetails	Błąd Szczegóły błędu.