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.
Actualice un objeto resourcePolicyAssignment .
Recupere la asignación actual y proporcione su @odata.etag valor en el If-Match encabezado. Una ETag obsoleta provoca 412 Precondition Failed; recupere la asignación más reciente antes de volver a intentar la actualización.
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) | ResourcePolicyAssignment.ReadWrite.All | No disponible. |
| Delegado (cuenta personal de Microsoft) | No admitida. | No admitida. |
| Aplicación | ResourcePolicyAssignment.ReadWrite.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 administrador de directivas de recursos es el rol con menos privilegios admitido para esta operación.
Solicitud HTTP
PATCH /admin/resourcePolicy/assignments/{resourcePolicyAssignment-uniqueName}
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. |
| If-Match | Obligatorio. La ETag de la asignación actual, devuelta en @odata.etag. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione las siguientes propiedades.
| Propiedad | Tipo | Description |
|---|---|---|
| directiva asignada | assignedPolicyReference |
PolicyDefinitionReference con @odata.type, policyUniqueName y version. |
| modo de aplicación | modo de aplicación | Controla si se aplica el efecto. El valor predeterminado es doNotEnforce. Los valores posibles son: doNotEnforce, enforce, unknownFutureValue. |
| isEnabled | Boolean | Si se evalúa la tarea. El valor predeterminado es true. |
| parámetros | Json | Los valores del parámetro validados con el parámetro paramsSchema de la definición a la que se hace referencia. |
| ámbito | Cadena | El ámbito de la asignación. Actualmente solo / se admite (en todo el inquilino) y es el predeterminado. |
Respuesta
Si tiene éxito, este método se devuelve 204 No Content sin cuerpo de respuesta.
Ejemplos
Solicitud
PATCH https://graph.microsoft.com/beta/admin/resourcePolicy/assignments/tenant_application_baseline
Content-Type: application/json
If-Match: "c84ce7ba-aa4b-4f10-8f3a-7c65814597c1"
{
"isEnabled": true,
"enforcementMode": "enforce"
}
Respuesta
HTTP/1.1 204 No Content