Management Groups - Get Descendants

Referencia

Service:: Management Groups

API Version:: 2020-05-01

Enumere todas las entidades que descienden de un grupo de administración.

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 identificador URI

Nombre	En	Requerido	Tipo	Description
groupId	path	True	string	Id. de grupo de administración.
api-version	query	True	string	Versión de la API que se va a usar con la solicitud de cliente. La versión actual es 2018-01-01-preview.
$skiptoken	query		string	El token de continuación de página solo se usa si una operación anterior devolvió un resultado parcial. Si una respuesta anterior contiene un elemento nextLink, el valor del elemento nextLink incluirá un parámetro de token que especifica un punto de partida que se usará para las llamadas posteriores.
$top	query		integer	Número de elementos que se van a devolver al recuperar resultados. Pasar esto en invalidará $skipToken.

Respuestas

Nombre	Tipo	Description
200 OK	DescendantListResult	Aceptar
Other Status Codes	ErrorResponse	Error

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

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
}

Definiciones

Nombre	Description
DescendantInfo	Descendiente.
DescendantListResult	Describe el resultado de la solicitud para ver descendientes.
DescendantParentGroupInfo	Identificador del grupo de administración primario.
ErrorDetails	Detalles del error.
ErrorResponse	Objeto de error.

DescendantInfo

Descendiente.

Nombre	Tipo	Description
id	string	Identificador completo del descendiente. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-00000000000 o /subscriptions/0000000-00000-0000-00000-0000000000
name	string	Nombre del descendiente. Por ejemplo, 00000000-0000-0000-0000-0000000000000
properties.displayName	string	Nombre descriptivo del grupo de administración.
properties.parent	DescendantParentGroupInfo	Parent Identificador del grupo de administración primario.
type	string	Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups o /subscriptions

DescendantListResult

Describe el resultado de la solicitud para ver descendientes.

Nombre	Tipo	Description
nextLink	string	Dirección URL que se va a usar para obtener el siguiente conjunto de resultados.
value	DescendantInfo[]	Lista de descendientes.

DescendantParentGroupInfo

Identificador del grupo de administración primario.

Nombre	Tipo	Description
id	string	Identificador completo del grupo de administración primario. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000

ErrorDetails

Detalles del error.

Nombre	Tipo	Description
code	string	Uno de un conjunto definido por el servidor de códigos de error.
details	string	Representación legible de los detalles del error.
message	string	Representación legible del error.

ErrorResponse

Objeto de error.

Nombre	Tipo	Description
error	ErrorDetails	Error Detalles del error.

Share via