Enumerar connectedOrganizations
Espacio de nombres: microsoft.graph
Recupere una lista de objetos connectedOrganization .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso | Permisos con privilegios mínimos | Permisos con privilegios más altos |
|---|---|---|
| Delegado (cuenta profesional o educativa) | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | EntitlementManagement.Read.All | EntitlementManagement.ReadWrite.All |
Sugerencia
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión también se le debe asignar un rol de administrador con permisos de rol admitidos mediante una de las siguientes opciones:
- Un rol Microsoft Entra donde el rol con privilegios mínimos es Administrador de gobernanza de identidades. Esta es la opción con menos privilegios.
En escenarios de solo aplicación, se puede asignar a la aplicación que realiza la llamada uno de los roles admitidos anteriores en lugar del permiso de EntitlementManagement.Read.All aplicación. El rol Administrador de gobernanza de identidades tiene menos privilegios que el permiso de aplicación EntitlementManagement.Read.All .
Para obtener más información, vea Delegación y roles en la administración de derechos y cómo delegar la gobernanza del acceso a administradores de paquetes de acceso en la administración de derechos.
Solicitud HTTP
GET /identityGovernance/entitlementManagement/connectedOrganizations
Parámetros de consulta opcionales
Este método admite los $select parámetros de consulta y $filter OData para ayudar a personalizar la respuesta. Por ejemplo, para recuperar solo las organizaciones conectadas con un nombre para mostrar específico, agregue $filter=displayName eq 'Name'. Del mismo modo, para recuperar solo las organizaciones conectadas con un origen de identidad de un inquilino específico, agregue $filter=identitySources/any(is:is/microsoft.graph.azureActiveDirectoryTenant/tenantId eq '72f988bf-86f1-41af-91ab-2d7cd011db47'). Para obtener información general, vea Parámetros de consulta OData.
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos connectedOrganization en el cuerpo de la respuesta.
Ejemplos
Solicitud
GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/connectedOrganizations
Respuesta
Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.
HTTP/1.1 200 OK
Content-Type: application/json
{
"value": [
{
"id": "04e7fa5f-fa5f-04e7-5ffa-e7045ffae704",
"displayName": "Wingtip Toys",
"description": "Wingtip Toys",
"createdDateTime": "2020-05-13T15:18:04.81Z",
"modifiedDateTime": "2020-05-13T15:18:04.81Z",
"identitySources": [
{
"@odata.type": "microsoft.graph.azureActiveDirectoryTenant",
"displayName": "Wingtip Toys Co"
}
],
"state": "configured"
}
]
}