Management Groups - List

Odwołanie

Service:: Management Groups

API Version:: 2020-05-01

Wyświetl listę grup zarządzania dla uwierzytelnioowanego użytkownika.

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

With optional parameters:

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
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ń.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Cache-Control		string	Wskazuje, że żądanie nie powinno korzystać z żadnych pamięci podręcznych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagementGroupListResult	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

ListManagementGroups

Sample Request

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups?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": {
        "tenantId": "20000000-0000-0000-0000-000000000000",
        "displayName": "Group 1 Tenant 2"
      }
    },
    {
      "id": "/providers/Microsoft.Management/managementGroups/20000000-0004-0000-0000-000000000000",
      "type": "Microsoft.Management/managementGroups",
      "name": "20000000-0004-0000-0000-000000000000",
      "properties": {
        "tenantId": "20000000-0000-0000-0000-000000000000",
        "displayName": "Group 4 Tenant 2"
      }
    }
  ],
  "@nextLink": null
}

Definicje

Nazwa	Opis
ErrorDetails	Szczegóły błędu.
ErrorResponse	Obiekt błędu.
ManagementGroupInfo	Zasób grupy zarządzania.
ManagementGroupListResult	Opisuje wynik żądania wyświetlania listy grup zarządzania.

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.

ManagementGroupInfo

Zasób grupy zarządzania.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator grupy zarządzania. Na przykład /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nazwa grupy zarządzania. Na przykład 000000000-0000-0000-0000-00000000000000000
properties.displayName	string	Przyjazna nazwa grupy zarządzania.
properties.tenantId	string	Identyfikator dzierżawy usługi AAD skojarzony z grupą zarządzania. Na przykład 000000000-0000-0000-0000-00000000000000000
type	string	Typ zasobu. Na przykład Microsoft.Management/managementGroups

ManagementGroupListResult

Opisuje wynik żądania wyświetlania listy grup zarządzania.

Nazwa	Typ	Opis
@nextLink	string	Adres URL używany do pobierania następnego zestawu wyników.
value	ManagementGroupInfo[]	Lista grup zarządzania.