Sdílet prostřednictvím


Management Groups - List

Vypíše skupiny pro správu ověřeného uživatele.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
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

Pokračovací token stránky se používá jenom v případě, že předchozí operace vrátila částečný výsledek. Pokud předchozí odpověď obsahuje nextLink element, hodnota prvku nextLink bude obsahovat parametr tokenu, který určuje počáteční bod pro následné volání.

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.

Odpovědi

Name Typ Description
200 OK

ManagementGroupListResult

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

ListManagementGroups

Sample Request

GET https://management.azure.com/providers/Microsoft.Management/managementGroups?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": {
        "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
}

Definice

Name Description
ErrorDetails

Podrobnosti o chybě.

ErrorResponse

Objekt chyby.

ManagementGroupInfo

Prostředek skupiny pro správu.

ManagementGroupListResult

Popisuje výsledek požadavku na výpis skupin 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ě.

ManagementGroupInfo

Prostředek skupiny 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.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

ManagementGroupListResult

Popisuje výsledek požadavku na výpis skupin pro správu.

Name Typ Description
@nextLink

string

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

value

ManagementGroupInfo[]

Seznam skupin pro správu.