Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Evalúe las directivas asignadas aplicables para una solicitud de API proporcionada mediante resourcePolicyRoot.
Esta acción no realiza la solicitud de API simulada. El efecto notificado y si la solicitud se bloquearía se devuelven por separado. Los errores de carga o evaluación de directivas pueden aparecer en la propiedad errorDetails de las entradas de la colección de detalles incluso cuando isResultDetailed es false.
Disponibilidad de API
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) | ResourcePolicyEvaluation.Read.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | ResourcePolicyEvaluation.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. El Evaluador de directivas de recursos es el rol con privilegios mínimos admitido para esta operación.
Solicitud HTTP
POST /admin/resourcePolicy/evaluateAssignedPolicies
Encabezados de solicitud
| Nombre | Descripción |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre autenticación y autorización. |
| Content-Type | application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione los parámetros siguientes.
| Parámetro | Tipo | Description |
|---|---|---|
| resourceUri | Cadena | Obligatorio. El URI de la solicitud o recurso a evaluar, como /beta/applications. |
| httpMethod | requestHttpMethod | Obligatorio. El método HTTP de la solicitud simulada. Los valores posibles son: post, patch, put, get, delete, unknownFutureValue. |
| resourceBody | Json | Obligatorio. El cuerpo JSON de la solicitud simulada. Este parámetro que acepta valores NULL se puede establecer en null. |
| ámbito | String | Opcional. El alcance de la evaluación. El valor predeterminado es / (el inquilino). |
| isResultDetailed | Booleano | Opcional. Si se deben solicitar resultados detallados de la directiva correctos. El valor predeterminado es false. Independientemente de este valor se pueden devolver detalles que contengan errores. |
| includeNormalizedRequestInput | Booleano | Opcional. Si se debe incluir el documento de entrada del motor de directivas en la respuesta. El valor predeterminado es false. |
Respuesta
Si se realiza correctamente, esta acción devuelve 200 OK un objeto policiesEvaluationResult en el cuerpo de la respuesta.
Ejemplos
En estos ejemplos se supone que el inquilino tiene habilitadas las siguientes asignaciones en el ámbito /. Ambas directivas se aplican a las operaciones de creación y actualización de aplicaciones.
| Nombre único de la asignación | Nombre único de definición | Requisito de directiva | Modo de cumplimiento |
|---|---|---|---|
tenant_application_baseline |
require_application_name |
La aplicación tiene un displayName no vacío. | doNotEnforce |
tenant_application_audience |
require_single_tenant_application |
El signInAudience de la aplicación es AzureADMyOrg. |
enforce |
Ejemplo 1: Evaluar varias directivas asignadas
La solicitud simulada proporciona un nombre para mostrar y un público con inicio de sesión multiinquilino. La política de nombres informa complianty los informes denyde política de audiencia. Dado que se aplica la directiva de audiencia, el resultado agregado tiene appliedPoliciesEffects establecido y denyisBlocked establecido en true.
Solicitud
POST https://graph.microsoft.com/beta/admin/resourcePolicy/evaluateAssignedPolicies
Content-Type: application/json
{
"resourceUri": "/beta/applications",
"httpMethod": "post",
"resourceBody": {
"displayName": "Contoso application",
"signInAudience": "AzureADMultipleOrgs"
},
"scope": "/",
"isResultDetailed": true
}
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.policiesEvaluationResult",
"resourceUri": "/beta/applications",
"httpMethod": "post",
"appliedPoliciesEffects": "deny",
"isBlocked": true,
"message": "Resource is non-compliant with policies: require_single_tenant_application.",
"normalizedRequestInput": null,
"details": [
{
"@odata.type": "#microsoft.graph.policiesEvaluationDetail",
"assignmentUniqueName": "tenant_application_baseline",
"assignedPolicyDisplayName": "Require an application name",
"appliedPolicyEffects": "compliant",
"enforcementMode": "doNotEnforce",
"reasons": null,
"errorDetails": null
},
{
"@odata.type": "#microsoft.graph.policiesEvaluationDetail",
"assignmentUniqueName": "tenant_application_audience",
"assignedPolicyDisplayName": "Require a single-tenant application",
"appliedPolicyEffects": "deny",
"enforcementMode": "enforce",
"reasons": [
"Applications must use the AzureADMyOrg sign-in audience."
],
"errorDetails": null
}
]
}
Ejemplo 2: Inspección de la entrada de solicitud normalizada
Establezca includeNormalizedRequestInput para true inspeccionar la entrada suministrada al motor de directivas. En este ejemplo se evalúa una actualización de la aplicación que cumple ambas directivas asignadas. La entrada normalizada contiene la versión de API, el contexto de autenticación del autor de la llamada, los segmentos de URI y las claves de recursos, y el cuerpo del recurso suministrado. Los valores del contexto de autenticación reflejan el autor de la llamada de la API de evaluación.
Solicitud
POST https://graph.microsoft.com/beta/admin/resourcePolicy/evaluateAssignedPolicies
Content-Type: application/json
{
"resourceUri": "/beta/applications/8b1c4b61-8369-42e5-8f6c-624d27dfba20",
"httpMethod": "patch",
"resourceBody": {
"displayName": "Contoso application",
"signInAudience": "AzureADMyOrg"
},
"scope": "/",
"isResultDetailed": true,
"includeNormalizedRequestInput": true
}
Respuesta
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.policiesEvaluationResult",
"resourceUri": "/beta/applications/8b1c4b61-8369-42e5-8f6c-624d27dfba20",
"httpMethod": "patch",
"appliedPoliciesEffects": "compliant",
"isBlocked": false,
"message": "Resource is compliant with assigned policies.",
"normalizedRequestInput": {
"request": {
"apiVersion": "beta",
"authContext": {
"isAppOnly": true,
"appid": "bdf7919e-a1bd-46d6-b99d-446cc0116353",
"tid": "f41b6369-cba8-48c9-bf58-1e066b0a46f0",
"oid": "0d52b272-6161-49d5-a0e8-31082a0e7d19"
},
"uriSegments": [
{
"name": "applications",
"type": "microsoft.graph.application",
"keys": {
"id": "8b1c4b61-8369-42e5-8f6c-624d27dfba20"
}
}
],
"resourceKeys": {
"id": "8b1c4b61-8369-42e5-8f6c-624d27dfba20"
}
},
"resource": {
"displayName": "Contoso application",
"signInAudience": "AzureADMyOrg"
}
},
"details": [
{
"@odata.type": "#microsoft.graph.policiesEvaluationDetail",
"assignmentUniqueName": "tenant_application_baseline",
"assignedPolicyDisplayName": "Require an application name",
"appliedPolicyEffects": "compliant",
"enforcementMode": "doNotEnforce",
"reasons": null,
"errorDetails": null
},
{
"@odata.type": "#microsoft.graph.policiesEvaluationDetail",
"assignmentUniqueName": "tenant_application_audience",
"assignedPolicyDisplayName": "Require a single-tenant application",
"appliedPolicyEffects": "compliant",
"enforcementMode": "enforce",
"reasons": null,
"errorDetails": null
}
]
}