Management Groups - List

Referenz

Service:: Management Groups

API Version:: 2020-05-01

Listet die Verwaltungsgruppen für den authentifizierten Benutzer auf.

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}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2018-01-01-preview.
$skiptoken	query		string	Das Seitenfortsetzungstoken wird nur verwendet, wenn ein vorheriger Vorgang ein Teilergebnis zurückgegeben hat. Wenn eine vorherige Antwort ein nextLink-Element enthält, enthält der Wert des nextLink-Elements einen Tokenparameter, der einen Startpunkt angibt, der für nachfolgende Aufrufe verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
Cache-Control		string	Gibt an, dass die Anforderung keine Caches verwenden soll.

Antworten

Name	Typ	Beschreibung
200 OK	ManagementGroupListResult	OK
Other Status Codes	ErrorResponse	Fehler

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

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

Scopes

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

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
}

Definitionen

Name	Beschreibung
ErrorDetails	Die Details des Fehlers.
ErrorResponse	Das Fehlerobjekt.
ManagementGroupInfo	Die Verwaltungsgruppenressource.
ManagementGroupListResult	Beschreibt das Ergebnis der Anforderung zum Auflisten von Verwaltungsgruppen.

ErrorDetails

Die Details des Fehlers.

Name	Typ	Beschreibung
code	string	Einer von einem serverdefiniertem Satz von Fehlercodes.
details	string	Eine lesbare Darstellung der Fehlerdetails.
message	string	Eine lesbare Darstellung des Fehlers.

ErrorResponse

Das Fehlerobjekt.

Name	Typ	Beschreibung
error	ErrorDetails	Fehler Die Details des Fehlers.

ManagementGroupInfo

Die Verwaltungsgruppenressource.

Name	Typ	Beschreibung
id	string	Die vollqualifizierte ID für die Verwaltungsgruppe. Beispiel: /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Der Name der Verwaltungsgruppe. Beispiel: 00000000-0000-0000-0000-0000000000000
properties.displayName	string	Der Anzeigename der Verwaltungsgruppe.
properties.tenantId	string	Die der Verwaltungsgruppe zugeordnete AAD-Mandanten-ID. Beispiel: 00000000-0000-0000-0000-0000000000000
type	string	Der Typ der Ressource. Beispiel: Microsoft.Management/managementGroups

ManagementGroupListResult

Beschreibt das Ergebnis der Anforderung zum Auflisten von Verwaltungsgruppen.

Name	Typ	Beschreibung
@nextLink	string	Die URL, die zum Abrufen des nächsten Resultsets verwendet werden soll.
value	ManagementGroupInfo[]	Die Liste der Verwaltungsgruppen.

Share via