resourcePolicyAssignment tipo de recurso

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"
  }
}