Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Recuperar las propiedades y relaciones de una colección de objetos riskyUser .
Nota: El uso de la API riskyUsers requiere una licencia de Microsoft Entra ID P2.
Esta API está disponible en las siguientes implementaciones en la nube nacional.
| Servicio global |
Administración pública de EE. UU. |
Gobierno de EE. UU. L5 (DOD) |
China operado por 21Vianet |
| ✅ |
✅ |
✅ |
❌ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use uno o varios permisos con privilegios más altos 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) |
IdentityRiskyUser.Read.All |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
IdentityRiskyUser.Read.All |
No disponible. |
Importante
Para el acceso delegado con cuentas profesionales o educativas, el usuario que ha iniciado sesión debe tener asignado un rol compatible de Microsoft Entra o un rol personalizado que conceda los permisos necesarios para esta operación. Esta operación admite los siguientes roles integrados, que proporcionan solo el privilegio mínimo necesario:
- Lector global
- Operador de seguridad
- Lector de seguridad
- Administrador de seguridad
Solicitud HTTP
GET /riskyUsers
GET /identityProtection/riskyUsers
Parámetros de consulta opcionales
Este método admite los $filter parámetros de consulta and $selectOData para personalizar la respuesta de la consulta. El tamaño máximo de página es $top de 500 objetos.
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Workbook-Session-Id |
Id. de sesión del libro que determina si los cambios se conservan. Opcional. |
Cuerpo de la solicitud
No proporcione un cuerpo de solicitud para este método.
Respuesta
Si tiene éxito, este método devuelve un 200 OK código de respuesta y una colección de objetos riskyUser en el cuerpo de la respuesta.
Ejemplos
Ejemplo 1: Enumerar usuarios de riesgo
Solicitud
En el ejemplo siguiente se muestra la solicitud.
GET https://graph.microsoft.com/beta/riskyUsers
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.RiskyUsers.GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
riskyUsers, err := graphClient.RiskyUsers().Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
RiskyUserCollectionResponse result = graphClient.riskyUsers().get();
const options = {
authProvider,
};
const client = Client.init(options);
let riskyUsers = await client.api('/riskyUsers')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->riskyUsers()->get()->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.risky_users.get()
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-type: application/json
{
"value":[
{
"id": "c2b6c2b9-dddc-acd0-2b39-d519d803dbc3",
"riskLastUpdatedDateTime": "2016-01-29T20:03:57.7872426Z",
"isProcessing": true,
"isDeleted": true,
"riskDetail": "adminConfirmedSigninCompromised",
"riskLevel": "high",
"riskState": "atRisk",
"userDisplayName": "Alex Wilbur",
"userPrincipalName": "alexw@contoso.com"
}
]
}
Ejemplo 2: Enumerar usuarios de riesgo y filtrar los resultados
Solicitud
En el ejemplo siguiente se muestra cómo usar $filter para obtener la colección de riskyUser cuyo nivel de riesgo agregado es Medio.
GET https://graph.microsoft.com/beta/identityProtection/riskyUsers?$filter=riskLevel eq microsoft.graph.riskLevel'medium'
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.IdentityProtection.RiskyUsers.GetAsync((requestConfiguration) =>
{
requestConfiguration.QueryParameters.Filter = "riskLevel eq microsoft.graph.riskLevel'medium'";
});
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphidentityprotection "github.com/microsoftgraph/msgraph-beta-sdk-go/identityprotection"
//other-imports
)
requestFilter := "riskLevel eq microsoft.graph.riskLevel'medium'"
requestParameters := &graphidentityprotection.IdentityProtectionRiskyUsersRequestBuilderGetQueryParameters{
Filter: &requestFilter,
}
configuration := &graphidentityprotection.IdentityProtectionRiskyUsersRequestBuilderGetRequestConfiguration{
QueryParameters: requestParameters,
}
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
riskyUsers, err := graphClient.IdentityProtection().RiskyUsers().Get(context.Background(), configuration)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
RiskyUserCollectionResponse result = graphClient.identityProtection().riskyUsers().get(requestConfiguration -> {
requestConfiguration.queryParameters.filter = "riskLevel eq microsoft.graph.riskLevel'medium'";
});
const options = {
authProvider,
};
const client = Client.init(options);
let riskyUsers = await client.api('/identityProtection/riskyUsers')
.version('beta')
.filter('riskLevel eq microsoft.graph.riskLevel\'medium\'')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\IdentityProtection\RiskyUsers\RiskyUsersRequestBuilderGetRequestConfiguration;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestConfiguration = new RiskyUsersRequestBuilderGetRequestConfiguration();
$queryParameters = RiskyUsersRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->filter = "riskLevel eq microsoft.graph.riskLevel'medium'";
$requestConfiguration->queryParameters = $queryParameters;
$result = $graphServiceClient->identityProtection()->riskyUsers()->get($requestConfiguration)->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaRiskyUser -Filter "riskLevel eq microsoft.graph.riskLevel'medium'"
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.identity_protection.risky_users.risky_users_request_builder import RiskyUsersRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = RiskyUsersRequestBuilder.RiskyUsersRequestBuilderGetQueryParameters(
filter = "riskLevel eq microsoft.graph.riskLevel'medium'",
)
request_configuration = RequestConfiguration(
query_parameters = query_params,
)
result = await graph_client.identity_protection.risky_users.get(request_configuration = request_configuration)
Respuesta
En el ejemplo siguiente se muestra la respuesta.
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id": "c2b6c2b9-dddc-acd0-2b39-d519d803dbc3",
"riskLastUpdatedDateTime": "2018-09-22T00:04:49.1195968Z",
"isProcessing": true,
"isDeleted": false,
"riskDetail": "none",
"riskLevel": "medium",
"riskState": "atRisk",
"userDisplayName": "Alex Wilbur",
"userPrincipalName": "alexw@contoso.com",
}
]
}