Management Groups - Get Descendants

Liste todas as entidades que descendem de um grupo de gerenciamento.

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

Parâmetros de URI

Name In Required Type 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 retornar ao recuperar resultados. Passar isso substituirá o $skipToken.

Respostas

Name Type Description
200 OK

OK

Other Status Codes

Erro

Segurança

azure_auth

Azure Active Directory fluxo OAuth2.

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

Exemplos

GetDescendants

Sample Request

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

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.

Name Type Description
id
  • string

A ID totalmente qualificada para o descendente. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000 ou /subscriptions/00000000-0000-0000-0000-0000-0000000000

name
  • string

O nome do descendente. Por exemplo, 00000000-0000-0000-0000-00000000000

properties.displayName
  • string

O nome amigável do grupo de gerenciamento.

properties.parent

Pai
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.

Name Type Description
nextLink
  • string

A URL a ser usada para obter o próximo conjunto de resultados.

value

A lista de descendentes.

DescendantParentGroupInfo

A ID do grupo de gerenciamento pai.

Name Type Description
id
  • string

A ID totalmente qualificada para o grupo de gerenciamento pai. Por exemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000

ErrorDetails

Os detalhes do erro.

Name Type Description
code
  • string

Um de um conjunto definido pelo servidor de códigos de erro.

details
  • string

Uma representação acessível por humanos dos detalhes do erro.

message
  • string

Uma representação acessível por humanos do erro.

ErrorResponse

O objeto de erro.

Name Type Description
error

Erro
Os detalhes do erro.