Management Groups - Get Descendants

Referens

Service:: Management Groups

API Version:: 2020-05-01

Visa en lista över alla entiteter som härstammar från en hanteringsgrupp.

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}

URI-parametrar

Name	I	Obligatorisk	Typ	Description
groupId	path	True	string	Hanteringsgrupps-ID.
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.
$top	query		integer	Antal element som ska returneras vid hämtning av resultat. Om du skickar in detta åsidosätts $skipToken.

Svar

Name	Typ	Description
200 OK	DescendantListResult	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

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
}

Definitioner

Name	Description
DescendantInfo	Den underordnade.
DescendantListResult	Beskriver resultatet av begäran om att visa underordnade.
DescendantParentGroupInfo	ID för den överordnade hanteringsgruppen.
ErrorDetails	Information om felet.
ErrorResponse	Felobjektet.

DescendantInfo

Den underordnade.

Name	Typ	Description
id	string	Det fullständigt kvalificerade ID:t för den underordnade. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000000 eller /subscriptions/0000000-0000-0000-0000-000000000
name	string	Namnet på den underordnade. Till exempel 000000000-0000-0000-0000-0000000000000000
properties.displayName	string	Hanteringsgruppens eget namn.
properties.parent	DescendantParentGroupInfo	Överordnad ID för den överordnade hanteringsgruppen.
type	string	Resurstypen. Till exempel Microsoft.Management/managementGroups eller /subscriptions

DescendantListResult

Beskriver resultatet av begäran om att visa underordnade.

Name	Typ	Description
nextLink	string	Url:en som ska användas för att hämta nästa uppsättning resultat.
value	DescendantInfo[]	Listan över underordnade.

DescendantParentGroupInfo

ID för den överordnade hanteringsgruppen.

Name	Typ	Description
id	string	Det fullständigt kvalificerade ID:t för den överordnade hanteringsgruppen. Till exempel /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000000

ErrorDetails

Information om felet.

Name	Typ	Description
code	string	En av en serverdefinierad uppsättning felkoder.
details	string	En läsbar återgivning av felinformationen.
message	string	En läsbar återgivning av felet.

ErrorResponse

Felobjektet.

Name	Typ	Description
error	ErrorDetails	Fel Information om felet.

Dela via