Management Groups - List

Referens

Service:: Management Groups

API Version:: 2020-05-01

Lista hanteringsgrupper för den autentiserade användaren.

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-parametrar

Name	I	Obligatorisk	Typ	Description
api-version	query	True	string	Version av API:et som ska användas med klientbegäran. Den aktuella versionen är 2018-01-01-preview.
$skiptoken	query		string	Sidfortsättningstoken används endast om en tidigare åtgärd returnerade ett partiellt resultat. Om ett tidigare svar innehåller ett nextLink-element innehåller värdet för nextLink-elementet en tokenparameter som anger en startpunkt som ska användas för efterföljande anrop.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Cache-Control		string	Anger att begäran inte ska använda några cacheminnen.

Svar

Name	Typ	Description
200 OK	ManagementGroupListResult	OK
Other Status Codes	ErrorResponse	Fel

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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
}

Definitioner

Name	Description
ErrorDetails	Information om felet.
ErrorResponse	Felobjektet.
ManagementGroupInfo	Resursen för hanteringsgruppen.
ManagementGroupListResult	Beskriver resultatet av begäran om att lista hanteringsgrupper.

ErrorDetails

Information om felet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	string	En läsbar representation av felets detaljer.
message	string	En mänsklig läsbar representation av felet.

ErrorResponse

Felobjektet.

Name	Typ	Description
error	ErrorDetails	Fel Information om felet.

ManagementGroupInfo

Resursen för hanteringsgruppen.

Name	Typ	Description
id	string	Det fullständigt kvalificerade ID:t för hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000-0000000000
name	string	Namnet på hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000
properties.displayName	string	Hanteringsgruppens eget namn.
properties.tenantId	string	Det AAD-klientorganisations-ID som är associerat med hanteringsgruppen. Till exempel 00000000-0000-0000-0000-0000000000000
type	string	Resurstypen. Till exempel Microsoft.Management/managementGroups

ManagementGroupListResult

Beskriver resultatet av begäran om att lista hanteringsgrupper.

Name	Typ	Description
@nextLink	string	Den URL som ska användas för att hämta nästa uppsättning resultat.
value	ManagementGroupInfo[]	Listan över hanteringsgrupper.

Dela via