Management Groups - List

Referencia

Service:: Management Groups

API Version:: 2020-05-01

Enumera los grupos de administración del usuario autenticado.

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}

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
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.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Cache-Control		string	Indica que la solicitud no debe usar ninguna memoria caché.

Respuestas

Nombre	Tipo	Description
200 OK	ManagementGroupListResult	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

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
}

Definiciones

Nombre	Description
ErrorDetails	Detalles del error.
ErrorResponse	Objeto de error.
ManagementGroupInfo	Recurso del grupo de administración.
ManagementGroupListResult	Describe el resultado de la solicitud para enumerar grupos de administración.

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.

ManagementGroupInfo

Recurso del grupo de administración.

Nombre	Tipo	Description
id	string	Identificador completo del grupo de administración. Por ejemplo, /providers/Microsoft.Management/managementGroups/0000000-0000-0000-0000-000000000000
name	string	Nombre del grupo de administración. Por ejemplo, 00000000-0000-0000-0000-0000000000000
properties.displayName	string	Nombre descriptivo del grupo de administración.
properties.tenantId	string	Identificador de inquilino de AAD asociado al grupo de administración. Por ejemplo, 00000000-0000-0000-0000-0000000000000
type	string	Tipo de recurso. Por ejemplo, Microsoft.Management/managementGroups

ManagementGroupListResult

Describe el resultado de la solicitud para enumerar grupos de administración.

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

Share via