Management Groups - Get Descendants

Referência

Service:: Management Groups

API Version:: 2020-05-01

Liste todas as entidades que são descendentes de um grupo de gerenciamento.

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}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
groupId	path	True	string	ID do Grupo de Gerenciamento.
api-version	query	True	string	Versão da API a ser usada com a solicitação do cliente. A versão atual é 2018-01-01-preview.
$skiptoken	query		string	O token de continuação de página só será usado se uma operação anterior retornar um resultado parcial. Se uma resposta anterior contiver um elemento nextLink, o valor do elemento nextLink incluirá um parâmetro de token que especifica um ponto de partida a ser usado para chamadas subsequentes.
$top	query		integer	Número de elementos a serem retornados ao recuperar resultados. Passar isso para dentro substituirá $skipToken.

Respostas

Nome	Tipo	Description
200 OK	DescendantListResult	OK
Other Status Codes	ErrorResponse	Erro

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Scopes

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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
}

Definições

Nome	Description
DescendantInfo	O descendente.
DescendantListResult	Descreve o resultado da solicitação para exibir descendentes.
DescendantParentGroupInfo	A ID do grupo de gerenciamento pai.
ErrorDetails	Os detalhes do erro.
ErrorResponse	O objeto de erro.

DescendantInfo

O descendente.

Nome	Tipo	Description
id	string	A ID totalmente qualificada para o descendente. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-0000000000000 ou /subscriptions/0000000-0000-0000-0000-0000-0000000
name	string	O nome do descendente. Por exemplo, 000000000-0000-0000-0000-0000000000000
properties.displayName	string	O nome amigável do grupo de gerenciamento.
properties.parent	DescendantParentGroupInfo	Parent A ID do grupo de gerenciamento pai.
type	string	Tipo do recurso. Por exemplo, Microsoft.Management/managementGroups ou /subscriptions

DescendantListResult

Descreve o resultado da solicitação para exibir descendentes.

Nome	Tipo	Description
nextLink	string	A URL a ser usada para obter o próximo conjunto de resultados.
value	DescendantInfo[]	A lista de descendentes.

DescendantParentGroupInfo

A ID do grupo de gerenciamento pai.

Nome	Tipo	Description
id	string	A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000

ErrorDetails

Os detalhes do erro.

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	string	Uma representação legível por humanos dos detalhes do erro.
message	string	Uma representação legível pelo homem do erro.

ErrorResponse

O objeto de erro.

Nome	Tipo	Description
error	ErrorDetails	Erro Os detalhes do erro.