servicePrincipal: getMemberObjectsservicePrincipal: getMemberObjects

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Obtener la lista de los grupos y roles de directorio a los que pertenece esta servicePrincipal.Get the list of groups and directory roles that this servicePrincipal is a member of. Esta comprobación es transitiva.This check is transitive.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllDirectory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) No admitida.Not supported.
AplicaciónApplication Directory.Read.All, Directory.ReadWrite.AllDirectory.Read.All, Directory.ReadWrite.All

Solicitud HTTPHTTP request

POST /servicePrincipals/{id}/getMemberObjects

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.
Tipo de contenidoContent-type application/json. Obligatorio.application/json. Required.

Cuerpo de la solicitudRequest body

En el cuerpo de la solicitud, proporcione un objeto JSON con los siguientes parámetros.In the request body, provide a JSON object with the following parameters.

ParámetroParameter TipoType DescripciónDescription
securityEnabledOnlysecurityEnabledOnly BooleanBoolean

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y un objeto de colección String en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and a String collection object in the response body.

EjemplosExamples

Aquí tiene un ejemplo de cómo llamar a esta API.Here is an example of how to call this API.

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.Here is an example of the request.

POST https://graph.microsoft.com/v1.0/servicePrincipals/{id}/getMemberObjects
Content-type: application/json
Content-length: 33

{
  "securityEnabledOnly": true
}

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.Here is an example of the response.

Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 39

{
  "value": [
    "string-value"
  ]
}