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.
Representa la asignación de una versión de definición de directiva de recursos a un ámbito, incluidos los valores de parámetro y la configuración de cumplimiento.
Una asignación tiene como destino una versión de definición específica a través de assignedPolicy. Para mover la asignación a otra versión, actualiza assignedPolicy.version en su valor policyDefinitionReference . El servicio valida los parámetros con los paramsSchema de la definición a la que se hace referencia.
De forma predeterminada, las asignaciones son doNotEnforce. Una directiva puede informar deny sin bloquear una solicitud cuando la aplicación está deshabilitada.
Las respuestas de la tarea incluyen una @odata.etag anotación. Para una actualización, recupere la asignación actual y proporcione ese valor en el encabezado de la If-Match solicitud. Una ETag obsoleta provoca 412 Precondition Failed; recupere la asignación más reciente antes de volver a intentarlo.
Upsert se usa Prefer: create-if-missing para crear o actualizar una tarea.
Métodos
| Método | Tipo devuelto | Descripción |
|---|---|---|
| List | Colección resourcePolicyAssignment | Enumerar las asignaciones de directiva. |
| Crear | resourcePolicyAssignment | Asigne una versión de definición de directiva. |
| Get | resourcePolicyAssignment | Leer una tarea activa o eliminada. |
| Actualizar | Ninguno | Actualizar una tarea. |
| Upsert | resourcePolicyAssignment | Cree una tarea o actualícela sin cuerpo de respuesta si existe. |
| Delete | Ninguno | Eliminar una asignación activa. |
| Eliminar permanentemente | Ninguno | Eliminar permanentemente una tarea. |
| Restaurar | resourcePolicyAssignment | Restaurar una tarea eliminada. |
Propiedades
| Propiedad | Tipo | Description |
|---|---|---|
| directiva asignada | assignedPolicyReference | Referencia a la definición y versión de la directiva que se va a asignar. Proporciona un policyDefinitionReference y su @odata.type discriminador. |
| createdDateTime | DateTimeOffset | La fecha y hora en que se creó el objeto, en formato ISO 8601 y UTC. Solo lectura. Admite $filter (le, gt). |
| deletedDateTime | DateTimeOffset | La fecha y hora en que se eliminó el objeto, en formato ISO 8601 y UTC. Nulo para un objeto activo. Solo lectura. |
| modo de aplicación | modo de aplicación | Controla si se aplica el efecto de la asignación.
doNotEnforce, el valor predeterminado, evalúa y registra el resultado sin aplicar el efecto.
enforce Aplica el efecto. Los valores posibles son: doNotEnforce, enforce, unknownFutureValue. |
| isEnabled | Boolean | Indica si se evalúa la tarea. El valor predeterminado es true. Admite $filter (eq). |
| lastModifiedDateTime | DateTimeOffset | La fecha y hora en que se modificó por última vez el objeto, en formato ISO 8601 y UTC. Solo lectura. Admite $filter (le, gt). |
| parámetros | Json | Los valores del parámetro JSON para la asignación. Los valores se validan con el esquema paramsSchema de la definición a la que se hace referencia; Se aplican los valores predeterminados declarados. |
| ámbito | Cadena | El ámbito de la asignación. Actualmente, solo se admite el ámbito de todo el inquilino (/). El valor predeterminado es /. |
| uniqueName | Cadena | El nombre único y la clave principal inmutables proporcionados por el usuario. Necesario en la creación. Debe comenzar con una letra ASCII, contener solo letras, dígitos o caracteres de subrayado ASCII y tener como máximo 128 caracteres. Los prefijos y ms (incluido msft) están reservados, independientemente de mayúsculas y minúsculasmicrosoft. Este es el nombre de la asignación, no el nombre de la definición a la que se hace referencia. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.resourcePolicyAssignment",
"uniqueName": "String (identifier)",
"isEnabled": "Boolean",
"scope": "String",
"enforcementMode": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedDateTime": "String (timestamp)",
"deletedDateTime": "String (timestamp)",
"assignedPolicy": {
"@odata.type": "microsoft.graph.assignedPolicyReference"
},
"params": {
"@odata.type": "microsoft.graph.Json"
}
}